compaction-advisor
About
This Claude Code skill monitors available context tokens and proactively warns developers before they run out. It provides checkpoint suggestions during long tasks to prevent work interruption from context compaction. Use it to maintain optimal context usage and avoid losing important conversation history.
Quick Install
Claude Code
Recommended/plugin add https://github.com/majiayu000/claude-skill-registrygit clone https://github.com/majiayu000/claude-skill-registry.git ~/.claude/skills/compaction-advisorCopy and paste this command in Claude Code to install this skill
Documentation
Compaction Advisor
You receive automatic context status via XML tags when context is concerning.
Message Types
1. Context Status (on user prompts)
When you see these tags at the start of a conversation turn:
<context-status>CRITICAL: Only 12k tokens free. Run /compact before any task.</context-status>
<context-status>WARNING: 25k tokens free. Only small tasks safe.</context-status>
<context-status>CAUTION: 40k tokens free. Medium tasks OK, compact before large.</context-status>
When context is healthy (50k+ free), you won't see any tag.
2. Checkpoint Suggestions (during long tasks)
During multi-step work, you may see:
<context-checkpoint>
CHECKPOINT RECOMMENDED: Context critically low (18k free) after 12 operations.
Good time to pause and /compact. Summarize progress so far and key context to preserve.
</context-checkpoint>
This means you've been working for a while and context is running low.
3. PreCompact Warning (emergency)
Just before auto-compaction triggers:
<precompact-warning>
AUTO-COMPACTION IMMINENT
Context window is full. Compaction will happen after this message.
</precompact-warning>
How to Respond
When you see <context-status> CRITICAL
Immediately advise:
Context is critically low (12k free). Before we proceed, run:
/compact Focus on [relevant context to preserve]
When you see <context-status> WARNING
For small tasks: proceed with caution For medium+ tasks: recommend compaction first
Context is at 25k free. For a refactor like this (~50k needed),
run /compact first to avoid mid-task interruption.
When you see <context-checkpoint>
This is mid-task. Pause and offer a checkpoint:
Good checkpoint - I've completed:
• [List what you've done so far]
• [Key decisions made]
• [Files modified]
Context is at 18k. To continue safely, run:
/compact Focus on [key context for remaining work]
After compacting, I'll continue with [next steps].
When you see <precompact-warning>
This is urgent. Quickly summarize:
Compaction is about to happen. Quick summary of our progress:
• [What we were working on]
• [What's been completed]
• [What remains to do]
After compaction, remind me to [specific next step].
When you see nothing
Context is healthy. Proceed normally without mentioning it.
Task Size Reference
| Task | ~Tokens Needed |
|---|---|
| Typo fix | 5k |
| Bug fix | 15k |
| New feature | 30k |
| Refactor | 50k |
| Architecture | 80k+ |
Compact Commands
/compact # General
/compact Focus on [specific context] # Preserve specific context
Examples:
/compact Focus on the auth changes and test failures/compact Keep the refactoring progress and file structure decisions
Key Points
- You automatically receive context state - no need to ask user
- During long tasks, checkpoint suggestions appear after 8+ operations
- Match urgency to the tag level (CRITICAL > WARNING > CAUTION)
- For checkpoints, summarize progress and suggest what to preserve
- For precompact, quickly capture essential context
- For healthy context, work normally without mentioning it
GitHub Repository
Related Skills
content-collections
MetaThis skill provides a production-tested setup for Content Collections, a TypeScript-first tool that transforms Markdown/MDX files into type-safe data collections with Zod validation. Use it when building blogs, documentation sites, or content-heavy Vite + React applications to ensure type safety and automatic content validation. It covers everything from Vite plugin configuration and MDX compilation to deployment optimization and schema validation.
creating-opencode-plugins
MetaThis skill provides the structure and API specifications for creating OpenCode plugins that hook into 25+ event types like commands, files, and LSP operations. It offers implementation patterns for JavaScript/TypeScript modules that intercept and extend the AI assistant's lifecycle. Use it when you need to build event-driven plugins for monitoring, custom handling, or extending OpenCode's capabilities.
langchain
MetaLangChain is a framework for building LLM applications using agents, chains, and RAG pipelines. It supports multiple LLM providers, offers 500+ integrations, and includes features like tool calling and memory management. Use it for rapid prototyping and deploying production systems like chatbots, autonomous agents, and question-answering services.
Algorithmic Art Generation
MetaThis skill helps developers create algorithmic art using p5.js, focusing on generative art, computational aesthetics, and interactive visualizations. It automatically activates for topics like "generative art" or "p5.js visualization" and guides you through creating unique algorithms with features like seeded randomness, flow fields, and particle systems. Use it when you need to build reproducible, code-driven artistic patterns.