forge-compactlisted
Install: claude install-skill yerros/context-forge
# forge-compact
Bring the project's recurring context cost back under budget. The six files plus the
entry point and digest are what every session pays to load; this skill is the guided
maintenance pass that keeps that price low. Budgets, tiers, and the digest contract
are defined canonically in
`${CLAUDE_PLUGIN_ROOT}/skills/forge-resume/references/token-economy.md` — read it
first.
## Argument
Text after the command targets specific files (e.g. `/forge-compact the tracker` or
`/forge-compact generate the digest`) — measure everything (step 1) but treat only
the target in steps 2–3. No argument → full pass.
## 1. Measure
Run the measurement (read-only) and compare against the canonical budgets:
```bash
for f in CLAUDE.md AGENTS.md context/*.md; do
[ -f "$f" ] && printf '%-34s %6s bytes ~%5s tok\n' "$f" "$(wc -c <"$f")" "$(( $(wc -c <"$f") / 4 ))"
done
```
Report a table to the user: file, size, budget, verdict (OK / over). Include the
estimated **per-session saving** the compact pass would deliver (sum of the overages,
plus the digest saving below if the project has no digest yet). The measurement can
be delegated to the `forge-archivist` agent; the compression judgment in step 2
cannot.
## 2. Propose, then compress (approval required per file)
Never trim meaning: compression rewrites for density — it does not drop facts,
invariants, decisions, or scope statements without explicit user approval. For each
over-budget file, propose the appropriate treatment and appl