Skip to content

fix(agent-development): description at 99% capacity limit (1,015/1,024 chars) #23

@sjnims

Description

@sjnims

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 -c

Metadata

Metadata

Assignees

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions