Preflight Checklist
Bug Description
Skills beyond the 30-skill display limit are completely undiscoverable by Claude. The <available_skills> section shows "Showing 30 of 39 skills due to token limits" - but those 9 truncated skills might as well not exist.
This is different from issue #11045 (which proposes router/hidden skills for 100+ skill libraries). This bug affects users with a modest number of skills (~37) who expect all their skills to be discoverable.
Steps to Reproduce
- Install multiple skill-providing plugins (e.g., anthropic-agent-skills, plugin-dev, xdg context-efficient-tools)
- End up with >30 total skills
- Ask Claude to do something that matches a truncated skill (e.g., "parse the YAML frontmatter" when yq skill exists)
- Claude doesn't know about the skill because it's not in
<available_skills>
Expected Behavior
All installed skills should be discoverable. Either:
- Raise the limit (37 skills is ~4-5k tokens - not unreasonable)
- Use smarter truncation (prioritize by relevance to current prompt)
- At minimum, show skill names without descriptions for truncated skills so Claude knows they exist
Actual Behavior
Skills are silently truncated. Claude has no way to know truncated skills exist. Users who write hooks to remind Claude to "check <available_skills>" find their hooks are useless for truncated skills.
Analysis
I analyzed my 37 skills by description length:
526 chars - Hook Development (plugin-dev)
489 chars - Command Development (plugin-dev)
448 chars - xlsx (anthropic-agent-skills)
...
150 chars - ripgrep (xdg context-efficient-tools)
117 chars - yq (xdg context-efficient-tools)
117 chars - jq (xdg context-efficient-tools)
The xdg skills (yq, jq, ripgrep) have concise, well-written descriptions but are truncated in favor of skills with verbose descriptions. The truncation algorithm punishes good documentation practices.
Environment
- Claude Code version: 2.0.60 (Homebrew)
- OS: macOS
- Total skills installed: 37
- Skills shown: 30
- Skills truncated: 7-9
Related Issues
This issue is narrower: the current 30-skill limit is too aggressive for typical users with a handful of plugins installed.
Preflight Checklist
Bug Description
Skills beyond the 30-skill display limit are completely undiscoverable by Claude. The
<available_skills>section shows "Showing 30 of 39 skills due to token limits" - but those 9 truncated skills might as well not exist.This is different from issue #11045 (which proposes router/hidden skills for 100+ skill libraries). This bug affects users with a modest number of skills (~37) who expect all their skills to be discoverable.
Steps to Reproduce
<available_skills>Expected Behavior
All installed skills should be discoverable. Either:
Actual Behavior
Skills are silently truncated. Claude has no way to know truncated skills exist. Users who write hooks to remind Claude to "check
<available_skills>" find their hooks are useless for truncated skills.Analysis
I analyzed my 37 skills by description length:
The xdg skills (yq, jq, ripgrep) have concise, well-written descriptions but are truncated in favor of skills with verbose descriptions. The truncation algorithm punishes good documentation practices.
Environment
Related Issues
/skillscommand to list all skillsThis issue is narrower: the current 30-skill limit is too aggressive for typical users with a handful of plugins installed.