Token Waste Audit

Document location

Source of truth: ~/stuff/gitrepos/gh/vtmocanu/skills/skills/token-audit/SKILL.md (public repo: github.com/vtmocanu/skills). The installed copy at ~/.claude/skills/token-audit/ is derived by npx skills; edit the source, then npx skills update. Never edit the installed copy.

This skill has bundled scripts. Invoke them from the skill's own base directory (the Base directory for this skill: line printed when the skill loads), e.g. <skill dir>/scripts/cache-report.sh. On a normal global install that path is ~/.claude/skills/token-audit/scripts/.

Purpose and hard rules

Diagnose what is spending tokens in this setup. Report only. Change no file and no setting — no edits, no config writes, no fixes, even if one is obvious.

Non-negotiable rules, from the audit contract:

• Measure, do not estimate. Run a command or read a file for every number. Exact token counts from the session log and from /context are authoritative — the API logged them. Byte counts are exact; when converting bytes to tokens, label it approximate and prefer /context.
• Write UNKNOWN, never a guess. If a value cannot be measured (no permission, tool unavailable, data absent), the cell is UNKNOWN with the reason — not an adjective, not a plausible number.
• Evidence is a number or a file path, never an adjective. "17253 bytes" or ~/.claude/settings.json, not "large" or "several".

Slash commands you cannot run yourself