Compact Adviser — Development skill for Claude Code
"Work appears completed or recorded.
How to install Compact Adviser
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open kunchenguid/compact-adviser and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Compact Adviser does
"Work appears completed or recorded. Run /compact to save tokens."
Alternatives in Development
- Om Tidy — Self-maintenance pass — acts on every hygiene flag: archives completed work, groups loose clusters, splits ove 4.6k ★
- Swarm Collect — Collect and synthesize results from a completed swarm 508 ★
- Engage.Pickup — Resume an engagement from the engine trace — skip completed steps, continue where you left off 348 ★
README
compact-adviser
**compact-adviser** is an agent plugin that answers a single question: should I /compact now?
It uses [Jev](https://typesafe.ai) to instantly judge whether the current session is likely at a boundary that's safe to compact.
It can give you a hint to run `/compact` - or, if you opt in, it can run it for you at the right time automatically.
Judgment is two one-sentence Jev questions in one request (is the unit finished; is this hands-on work or coordination), composed in code into one score. The hint floor is 0.90 while the context window is mostly empty (through about 10%) and relaxes toward 0.50 by about 90% full - a wrong hint costs most when there is still room. Automatic mode is the same gate, plus a first-use confirmation.
Quick Start
Prerequisites: Node 22+, [Pi](https://pi.dev) 0.82.0 or newer (verified on **0.85.1**) or Claude Code 2.1.274 or newer (verified on **2.1.275**), and a [TypeSafe API key](https://console.typesafe.ai/settings/keys). Supply it as `TYPESAFE_API_KEY` in the launch environment, enter it in `/compact-adviser`, or p
Related Skills
Work Prune
Prune completed requests and work items whose history is already durably recorded, keeping the work files focu
Wave Checkpoint
Save wave state to disk so an auto-compact, session crash, or laptop battery death doesn't kill the run. Run t
Compact
Prepare session state for context compaction — capture learnings, save state, then compact
Forgeflow Capture Output
Compact provided command output safely and optionally save a failure digest
Propagate Backlog
See what open work is recorded across every STATE.md, TODOS.md and handover in the tree
Docket Skill
An offline, in-repo journal and work index for Claude Code sessions and subagents. Every plan, decision and ou
Related Agents
Bartz
Use BEFORE any UI work. Reads the design system (tokens, theme, components) and the Figma frames if a Figma MC
Fec Design Token Mapper
Use this subagent to map styles and variables in Figma, Sketch, MasterGo, Pixso, Mokou, or Mockup to existing
Doc Cleanup
Use this agent when SPIDER protocol project documentation needs archiving or cleanup. This includes removing e
