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
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 -c
Problem
The
agent-developmentskill description is at 99% of the maximum allowed length:This leaves no room for adding future trigger phrases or improvements.
Measurements
Recommended Fix
1. Condense redundant trigger phrases
Current (uses 3 similar phrases):
Suggested (condensed):
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:
Improved start:
Acceptance Criteria
Files to Modify
plugins/plugin-dev/skills/agent-development/SKILL.md(frontmatter only)Testing