-
Notifications
You must be signed in to change notification settings - Fork 2
Closed
Labels
component:skillSkills layerSkills layereffort:small< 1 hour< 1 hourgood first issueGood for newcomersGood for newcomerspriority:mediumShould be addressedShould be addressedrefactorCode restructuring without behavior changeCode restructuring without behavior change
Description
Problem
The agent-development skill description is at 99% of the maximum allowed length:
- Current: 1,015 characters
- Maximum: 1,024 characters (per official Claude Code docs)
- Headroom: Only 9 characters remaining
This leaves no room for adding future trigger phrases or improvements.
Measurements
Description field: 1,015 / 1,024 characters
Recommended Fix
1. Condense redundant trigger phrases
Current (uses 3 similar phrases):
"create an agent", "add an agent", "write a subagent"
Suggested (condensed):
"create/add an agent", "write a subagent"
2. Improve description balance
Per official docs: "description should include both what the Skill does AND when to use it"
Current description is ~90% "when to use" triggers. Add brief "what it provides" clause:
Current start:
description: This skill should be used when the user asks to "create an agent"...Improved start:
description: This skill provides comprehensive agent development guidance for Claude Code plugins. Use when the user asks to "create an agent"...Acceptance Criteria
- Description reduced to ≤900 characters (leaving ~100 char headroom)
- Redundant trigger phrases condensed
- Brief "what it provides" clause added
- All important triggers retained
- Skill still triggers correctly on test phrases
Files to Modify
plugins/plugin-dev/skills/agent-development/SKILL.md(frontmatter only)
Testing
# Verify character count after changes
sed -n '/^---$/,/^---$/p' plugins/plugin-dev/skills/agent-development/SKILL.md | \
sed -n '/^description:/,/^model:/p' | head -1 | sed 's/^description: //' | wc -cReactions are currently unavailable
Metadata
Metadata
Assignees
Labels
component:skillSkills layerSkills layereffort:small< 1 hour< 1 hourgood first issueGood for newcomersGood for newcomerspriority:mediumShould be addressedShould be addressedrefactorCode restructuring without behavior changeCode restructuring without behavior change