skillreaper - context utilization report

SkillAI & models

Report how much of the context this agent loads is never used - unused skills, MCP servers, subagents, hooks and always-loaded prose - measured from real session transcripts. Use when asked why the context window is full, what is wasting tokens, or what is safe to remove.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the skillreaper - context utilization report skill

What this skill tells your AI

The instructions your AI receives, as published by thousandflowers/skillreaper in plugins/skillreaper/skills/reap/SKILL.md and read by ahel’s review.

Run reap --agent, then paste its output verbatim.

Do not reformat, re-order, summarise, truncate or re-align anything, and do not add a heading or a table of your own: the binary already renders the report, including its closing attribution line.

Arguments

Append any $ARGUMENTS tokens that begin with -; ignore anything else and say so. --days N sets the evidence window (default 30), --model <id> prices it. For the full inventory rather than the top rows, use reap --json.

If reap is not installed

Decide with command -v reap and nothing else - never an absolute path, never a filesystem search: a copy found off PATH may be an older build, and silently using it hides a broken install.

If that fails, print exactly this and nothing else:

reap is not installed. Run it once without installing anything:

npx skillreaper

Or install it permanently:

brew install thousandflowers/tap/skillreaper
go install github.com/thousandflowers/skillreaper/cmd/reap@latest

If reap is too old

--agent needs reap ≥ 0.5.0. If it exits with flag provided but not defined: -agent, say the installed build is too old and give brew upgrade skillreaper (npm: npm install -g skillreaper@latest) - an upgrade, never the install block above, which they have already done.

Pruning

Never prune on your own initiative. reap prune is interactive and aborts when it has no terminal, so calling it from here does nothing anyway.

If the user explicitly asks in this turn: get an unambiguous yes, run reap prune --yes, and remind them of reap restore --all. If the request is at all ambiguous, hand them the plain reap prune command instead.

For the per-category breakdown, point them at /skillreaper:gap.

Signals

GitHub stars
56
Forks
6
Last commit
Aug 2026

ahel review

  • K1binfo
    installs-packages

Automated review, not a security audit. Ruleset v1+k2.

Advanced
Catalog kind
skill
Gateway key
reap
Source
github.com/thousandflowers/skillreaper