compact-guard — Claude Code skill: what it does and how to install
compact-guard is a Claude Code skill that records task state before context compaction and helps restore it afterward. Run it before /compact or when an auto-compaction warning appears.
MIT ★ 2,966 updated 2026-09-29
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflowWhat compact-guard does
compact-guard captures the current task, edited files, decisions, blockers, and the next action before context is compacted. It prepares a short handoff with up to five priority files and notes, so the active file and task progress can be checked after compaction.
Before a full compaction, the skill suggests trimming large tool results and dropping file reads that no longer matter. Afterward, it revisits the task list and saved notes. Restoration is limited to five files, with 5K tokens per file and a 50K-token total budget.
What it helps with
- preserve task state before context compaction
- keep track of files to reopen after compaction
- resume from the next task step after
/compact - trim old search results and file reads from context
Example prompts for the agent
- Save the task state and prepare the context before
/compact. - An auto-compaction warning appeared; record the active files and next action.
- Restore the task context after compaction and continue from the next step.
How to install compact-guard
1Plugin marketplace
/plugin marketplace add rohitg00/pro-workflow/plugin install pro-workflow@pro-workflowThis installs the whole pro-workflow plugin with all its skills
2Skills CLI (Vercel)
npx skills add rohitg00/pro-workflow --skill compact-guard -a claude-code3Manually: put the files in place
~/.claude/skills/compact-guard/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/compact-guard/
1Skills CLI (Vercel)
npx skills add rohitg00/pro-workflow --skill compact-guard -a codex2Manually: put the files in place
.agents/skills/compact-guard/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add rohitg00/pro-workflow --skill compact-guard -a cursor2Manually: put the files in place
.cursor/skills/compact-guard/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install rohitg00/pro-workflow skills/compact-guard2Manually: put the files in place
.github/skills/compact-guard/SKILL.md1Skills CLI (Vercel)
npx skills add rohitg00/pro-workflow --skill compact-guard -a gemini-cli2Platform CLI
gemini skills install https://github.com/rohitg00/pro-workflow --path skills/compact-guardManually: put the files in place
.devin/skills/compact-guard/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about compact-guard
How do I install compact-guard in Claude Code?
Add the marketplace with /plugin marketplace add rohitg00/pro-workflow, then install the skill with /plugin install pro-workflow@pro-workflow.
What does compact-guard do?
It records key task details before context compaction and helps recover them afterward.
How many files can compact-guard restore after compaction?
It can restore up to five files, with a 5K-token limit per file and a 50K-token total budget.
Source text
SKILL.md · MIT
--- name: compact-guard description: Smart context compaction with state preservation. Saves critical files, task progress, and working state before compaction, restores after. Use before manual compact or when auto-compact triggers. user-invocable: true --- # Compact Guard Protect important context through compaction cycles. Based on Claude Code internals: compaction restores max 5 files with 5K tokens each, within a 50K total budget. ## Trigger Use before `/compact` or when auto-compact warning appears. ## Key Constants (from Claude Code source) - `POST_COMPACT_MAX_FILES_TO_RESTORE = 5` — only 5 files survive - `POST_COMPACT_TOKEN_BUDGET = 50K` — total restore budget - `POST_COMPACT_MAX_TOKENS_PER_FILE = 5K` — per-file limit - Auto-compact fires at `context_window - 13K` buffer ## Pre-Compact Checklist Before compacting, save these to memory or a scratch file: 1. **Current task** — What are you working on? One sentence. 2. **Files in progress** — Which files are being edited? (max 5 — compaction only restores 5) 3. **Decisions made** — Any architectural choices made this session 4. **Blockers** — What's preventing progress? 5. **Next steps** — What to do immediately after compact ## Strategy: Microcompact First Before full compaction, try microcompact: - Large tool results (test output, grep results) can be trimmed - File reads that are no longer relevant can be dropped - Use subagents for heavy exploration to keep main context clean ## Post-Compact Recovery After compaction, immediately: 1. Re-read the top-priority file (the one you're actively editing) 2. Check task list for current progress 3. Review any scratch notes saved pre-compact 4. Resume from next steps ## Prevention Strategies | Strategy | Token Savings | When | |----------|--------------|------| | Delegate grep/search to subagent | 30-60% per search | Always for broad searches | | Read only needed lines (`offset`/`limit`) | 50-90% per read | Large files | | Compact at task boundaries | Preserves coherence | Between logical steps | | Use `/resume` for fresh start | 100% | Unrelated new task | ## Output After running compact-guard: ```text COMPACT GUARD Files to preserve: [list top 5] Task state: [one sentence] Decisions: [key choices] Next step: [immediate action after compact] Ready to compact. Run /compact now. ``` ## Rules - Always save state before compacting — never compact blind - Prioritize the file you're actively editing as #1 to restore - If auto-compact fires unexpectedly, immediately re-read your working file - Keep CLAUDE.md under 60 lines to leave room for actual context
© Rohit Ghumare · MIT · rohitg00/pro-workflow