cc-skill-audit

Audit your Claude Code skills: token overhead, usage frequency, and prune candidates.

npx cc-skill-audit

What it shows

  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

Usage

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 output

Why it matters

Each skill in ~/.claude/skills/ contributes to:

1. Index overhead — The skill list (name + description) loads into every session. More skills = more tokens per session.
2. 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.

How it works

• 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.

Requirements

• Node.js 18+
• Claude Code installed with skills in ~/.claude/skills/

Part of cc-toolkit

cc-skill-audit is part of cc-toolkit — a collection of CLI tools for Claude Code power users.

License

MIT