| name | skill-usage |
| description | Show skill usage statistics, charts, and suggestions for pruning unused skills. Use when the user asks "skill usage", "which skills do I use", "unused skills", "skill stats", or "skill suggestions".
|
Skill Usage
Show usage analytics for Claude Code skills.
Arguments
$ARGUMENTS — Optional: period (day, week, month, all) or suggest
Instructions
Default: Usage Chart
Run the skill-usage CLI to show a bar chart of skill usage:
skill-usage --period week
- Default period is
week unless the user specifies otherwise
- Use
--period day, --period month, or --period all as requested
- Use
--limit N to restrict the chart to the top N skills
Suggest Mode
When the user asks about unused skills, which skills to remove, or skill suggestions:
skill-usage suggest --period month
This shows the highest-leverage skills, never-used skills, and rarely-used skills.
JSON Output
For programmatic analysis, add --json:
skill-usage --json --period all
skill-usage suggest --json --period month
Presentation
- Present the CLI output directly — it already has colored formatting
- If the user asks follow-up questions about specific skills, explain what each skill does based on your knowledge
- When suggesting removals, note that removing a skill means deleting its directory from
agents/skills/
