Skip to content

fix: shorten SKILL.md description to stay under 1024-char limit#166

Merged
Panniantong merged 1 commit intoPanniantong:mainfrom
voidborne-d:fix/skill-description-length
Mar 13, 2026
Merged

fix: shorten SKILL.md description to stay under 1024-char limit#166
Panniantong merged 1 commit intoPanniantong:mainfrom
voidborne-d:fix/skill-description-length

Conversation

@voidborne-d
Copy link
Contributor

Fixes #163

Problem

The description field in agent_reach/skill/SKILL.md was 1204 characters, exceeding the 1024-character maximum enforced by Codex and other MCP clients. This caused:

invalid description: exceeds maximum length of 1024 characters

…preventing the skill from loading entirely.

Fix

Shortened the description from 1204 → 661 characters (well within the 1024 limit) while preserving all essential information:

What Before After
Platform list With Chinese aliases in parens Names only (aliases in triggers)
Star count "7500+ GitHub stars" Removed (changes frequently)
Use-when rules 5 numbered items 1 concise sentence
Trigger keywords 34 triggers 23 most distinctive triggers

All key trigger keywords for platform matching are preserved. The removed duplicates (e.g. both 搜推特 and search twitter) were redundant — agents match on any trigger, so keeping one form is sufficient.

Testing

Verified the YAML frontmatter parses correctly and the new description is 661 chars.

…Panniantong#163)

The description field was 1204 characters, exceeding the 1024-character
maximum enforced by Codex and other MCP clients. This caused
'invalid description: exceeds maximum length of 1024 characters'
errors that prevented the skill from loading.

Changes:
- Removed star count (changes frequently, not essential for matching)
- Removed Chinese aliases in parentheses (redundant with trigger list)
- Consolidated 'Use when' into a single concise sentence
- Deduplicated trigger keywords (kept most distinctive ones)

New length: 661 chars (well within 1024 limit).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

最新版的 agent-reach 在 codex 中会触发 invalid description: exceeds maximum length of 1024 characters 导致无法加载

2 participants