skills/prompting-token-count/SKILL.md
Estimate token counts for prompt files. Wraps the token-count script for measuring agents, skills, commands, references, or any text file. Use when the user wants to check prompt size, compare token budgets, or measure files before/after optimization.
npx skillsauth add mjmorales/claude-prove prompting-token-countInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Estimate token counts for files using a regex-based heuristic tokenizer. Works on any text file — not limited to prove prompts.
$PLUGIN_DIR/scripts/token-count.py
Where $PLUGIN_DIR is this plugin's root directory.
Run the script from the user's project root. Pass glob patterns or file paths as positional arguments.
python3 "$PLUGIN_DIR/scripts/token-count.py" <patterns...> [flags]
Positional arguments are glob patterns or literal file paths. Multiple patterns can be combined.
| Flag | Effect |
|------|--------|
| --sort tokens | Sort by token count descending (default) |
| --sort name | Sort alphabetically by path |
| --sort lines | Sort by line count descending |
| --json | Machine-readable JSON output |
| --no-strip | Include YAML frontmatter in count (stripped by default) |
# All markdown files
python3 "$PLUGIN_DIR/scripts/token-count.py" "**/*.md"
# Single file
python3 "$PLUGIN_DIR/scripts/token-count.py" agents/llm-prompt-engineer.md
# Multiple patterns
python3 "$PLUGIN_DIR/scripts/token-count.py" "agents/**/*.md" "skills/**/SKILL.md"
# JSON output for scripting
python3 "$PLUGIN_DIR/scripts/token-count.py" "**/*.md" --json
--no-strip).--- markers is excluded by default since Claude Code doesn't send it as prompt content.testing
Anchor session context into prove primitives before compaction and rehydrate from them after. Built-in compaction summarizes by recency and drops the claude-prove state an agent needs to reorient; this skill externalizes volatile context into durable anchors (scrum tasks, decisions, run-state, a compact-anchors pointer file) pre-compact, then runs a deterministic reorientation sequence post-compact. Use before a manual /compact, when context is about to auto-compact, or immediately after a compaction. Triggers on "smart compact", "prepare for compaction", "anchor before compact", "context is getting long", "rehydrate", "reorient after compact".
tools
Apply model-driven CONTENT reshaping to stored run artifacts that sit behind the current schema, on explicit operator invocation only. Triggers on "migrate runs", "migrate run artifacts", "run content migration", "reshape run artifacts", "bring runs to current schema". You are the driver: the `run-state migrate-runs` CLI mechanically detects which artifacts are behind and emits a plan naming each one plus its migration-instruction file; you read the instructions and reshape the prose/findings, gated by the operator. The deterministic `schema migrate` handles structural column moves; this skill covers only the content reshaping beyond them. Never run as a background or resident loop — only when the operator asks.
tools
Synthesize the 7-section risk-forward Review Brief from a run's reasoning log. Triggers on "reasoning brief", "review brief", "synthesize the brief", "generate the brief", "brief the run", "brief for review", "story brief". You are the driver: the `acb brief` CLI renders a mechanical preservation-safe backbone and proves preservation; you synthesize the narrative prose (summary + changes), single-pass or multipass over episode chunks, then gate it through Stage-1 (mechanical, blocking) and Stage-2 (prose judge, advisory).
tools
Prune stale cached versions of the prove plugin from Claude Code's plugin cache. Use when superseded versions pile up under plugins/cache and agents read stale skills/references from them, or when reclaiming plugin-cache disk space. Triggers on "clean up cached plugin versions", "prune the plugin cache", "remove old prove versions", "stale plugin cache".