Audit your Claude Code skills: token overhead, usage frequency, and prune candidates.
npx cc-skill-audit
cc-skill-audit Skill token overhead analyzer
────────────────────────────────────────────────────────────
Summary
Skills installed 109
Index overhead 2.3K tokens (loaded every session)
Total content 348.6K tokens (loaded on invocation)
Usage lookback 30 days
Top 20 skills by size (30d usage)
Skill Tokens Use Bar
────────────────────────────────────────────────────────────
writing-skills 21.7K 0 ██████████████
pptx 14.3K 0 █████████░░░░░
docx 12.9K 0 ████████░░░░░░
...
Prune candidates (>5K tokens, 0 uses in 30d)
Removing these would save ~82.2K tokens when invoked
✗ writing-skills 21.7K tokens
✗ pptx 14.3K tokens
...
Active (used in 30d): 45 / 109
Never used in 30d: 64 skills
npx cc-skill-audit # full report (top 20 skills)
npx cc-skill-audit --top 30 # show top 30 skills by size
npx cc-skill-audit --days 14 # look back 14 days for usage
npx cc-skill-audit --json # machine-readable JSON outputEach skill in ~/.claude/skills/ contributes to:
- Index overhead — The skill list (name + description) loads into every session. More skills = more tokens per session.
- Invocation overhead — When you call
/skill-name, its full content loads into the context window.
This tool helps you identify skills that are large but rarely used, so you can archive or remove them to keep your context window clean.
- Reads skill files from
~/.claude/skills/ - Scans session transcripts in
~/.claude/projects/for skill invocations over the lookback period - Ranks skills by size and usage frequency
- Highlights prune candidates (>5K tokens, 0 uses)
Zero dependencies. Works entirely offline.
- Node.js 18+
- Claude Code installed with skills in
~/.claude/skills/
cc-skill-audit is part of cc-toolkit — a collection of CLI tools for Claude Code power users.
MIT