Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add Yrzhe/claude-skills --skill adaptive-compactiongit clone --depth 1 https://github.com/Yrzhe/claude-skillsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/yrzhe/claude-skills/adaptive-compaction)<a href="https://agentmods.dev/skills/yrzhe/claude-skills/adaptive-compaction"><img src="https://agentmods.dev/badge/skills/yrzhe/claude-skills/adaptive-compaction/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/yrzhe/claude-skills/adaptive-compaction"><img src="https://agentmods.dev/badge/skills/yrzhe/claude-skills/adaptive-compaction.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00217 | $0.03024 |
| Opus 5 | $0.00109 | $0.01512 |
| Sonnet 5 | $0.00043 | $0.00605 |
| Haiku 4.5 | $0.00022 | $0.00302 |
Grade A, and why
adaptive-compaction scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 263 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Adaptive Compaction
Use this skill to install, inspect, or operate the adaptive compaction policy and recovery layer for coding agents. Keep the layer add-on only: decide when to preserve, prune, compact, fork, or ask; never rewrite the host agent core.
Operating Rules
Follow these rules before taking action:
- Preserve state before any risky compaction path.
- Run zero-LLM pruning before any LLM summary recommendation.
- Treat relevance as advisory. Never use low relevance alone for destructive action.
- Prefer fork/reset on topic shift when headroom is healthy.
- Enforce
FORCED_COMPACTonly on hook-rich hosts. Degrade Codex and MCP-only hosts to advise/persist. - Keep stable instructions before volatile state to avoid prompt-cache churn.
- Log every decision with thresholds and host capability tier.
- Use portable paths such as
<skill-dir>/scripts/decide.py; do not hardcode install paths. - When the per-turn
additionalContextreports a non-NOOP action, lead your next reply by surfacing it to the user in their language (forced compaction needed, fork recommended, decision needs confirmation). Then continue with the user's actual request. Do not silently swallow these signals — that is the only channel by which the skill can ask the user to act.
Load References Conditionally
Do not read every reference by default. Load only the rows needed for the current request.
| Task | Read |
|---|---|
| Check JSON contracts or script I/O | <skill-dir>/references/contract.md |
| Explain or tune the four-signal decision table | <skill-dir>/references/decision-policy.md |
| Make or review host portability claims | <skill-dir>/references/capability-matrix.md |
| Validate release safety or risk coverage | <skill-dir>/references/risk-acceptance-tests.md |
| Plan trace evaluation or v1 to v2 gates | <skill-dir>/references/eval-protocol.md |
| Install Claude Code hooks | <skill-dir>/assets/hooks/claude-code/settings.json and the three shell scripts in that folder |
| Install Codex hooks/config | <skill-dir>/assets/hooks/codex/hooks.json and <skill-dir>/assets/hooks/codex/config.toml |
| Run deterministic fixture checks | <skill-dir>/scripts/fixtures/*.json |
What ships with it
30 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- .claude-plugin/plugin.json 700 B
- assets/hooks/claude-code/pre-compact.sh 208 B runs code
- assets/hooks/claude-code/session-start.sh 210 B runs code
- assets/hooks/claude-code/settings.json 928 B
- assets/hooks/claude-code/user-prompt-submit.sh 215 B runs code
- assets/hooks/codex/config.toml 724 B
- assets/hooks/codex/hooks.json 722 B
- CHANGELOG.md 6.6 KB
- LICENSE 1.0 KB
- README.md 3.6 KB
- references/capability-matrix.md 2.8 KB
- references/contract.md 5.5 KB
- references/decision-policy.md 3.4 KB
- references/eval-protocol.md 5.9 KB
- references/risk-acceptance-tests.md 3.2 KB
- scripts/analyze_decision_log.py 5.1 KB runs code
- scripts/decide.py 9.6 KB runs code
- scripts/decision_log.py 4.1 KB runs code
- scripts/fixtures/case_a_no_space_codex.json 895 B
- scripts/fixtures/case_b_burdened_space_ok.json 1.2 KB
- scripts/fixtures/case_c_relevant_space_ok.json 874 B
- scripts/fixtures/case_d_relevant_low_space_hook_rich.json 918 B
- scripts/fixtures/case_review_explicit_marker.json 790 B
- scripts/fixtures/case_review_forced_low_relevance_signals.json 252 B
- scripts/fixtures/case_review_low_confidence_signals.json 252 B
- scripts/hook_bridge.py 16 KB runs code
- scripts/prune_zero_llm.py 6.6 KB runs code
- scripts/score_signals.py 10 KB runs code
- scripts/state_packet.py 6.9 KB runs code
- scripts/thresholds.json 332 B
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 12d ago First seen · 263 lines · 217 tokens per session scan A 5bf20ef886a5
adaptive-compaction is a skill published in the GitHub repository Yrzhe/claude-skills (33 stars, last pushed 3mo ago), licensed MIT. It adds 217 tokens to every session and 3,024 once invoked, about $0.0011 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
media-ingest
Ingest video, audio, PDF, book, screenshot, and GitHub repo content into the brain. Multi-format handling with entity extraction and backlink propagation. Covers video-ingest, youtube-ingest, and book-ingest subtypes.
mem0-oss-to-platform
Plan and then execute a migration of a project from the mem0 open-source / self-hosted SDK (the local Memory class) to the mem0 Platform / hosted / managed SDK (the MemoryClient class). Use this whenever a developer wants to move, switch, or migrate their mem0 usage off OSS/self-hosted to the hosted API — e.g.…
Cortex
Operate Cortex, the LifeOS memory system — the typed Knowledge Archive (People, Companies, Ideas, Research with typed related: links) plus recall of prior work sessions, ISAs, and conversations. Search, add, harvest, develop, ingest, distill, graph-navigate, recall. USE WHEN cortex, knowledge, knowledge base, search…
memory
Use when the user asks to remember, recall, forget, update, search, or inspect durable OpenSquilla memory, including profile facts in USER.md and long-term notes in MEMORY.md or memory//.md.
ha-data-stores
Map of Hope Agent's local data stores and safe read-only query workflow. Use when the user asks where Hope Agent stores data, wants to inspect sessions/messages/memory/logs/background jobs/knowledge indexes/settings, asks the model to query local app data, or debugging requires checking persisted state. Trigger…
establishing-project-context
Use when the user asks to establish shared project language, or project work exposes a conflicting, renamed, or deprecated domain term that needs active semantic modeling. Routine small tasks stay on the fast path.