Getting it into your agent
This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.
/plugin marketplace add melodic-software/claude-code-plugins/plugin install docs-hygieneWrote 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/melodic-software/claude-code-plugins/compress)<a href="https://agentmods.dev/skills/melodic-software/claude-code-plugins/compress"><img src="https://agentmods.dev/badge/skills/melodic-software/claude-code-plugins/compress/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/melodic-software/claude-code-plugins/compress"><img src="https://agentmods.dev/badge/skills/melodic-software/claude-code-plugins/compress.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.00156 | $0.05350 |
| Opus 5.5 | $0.00062 | $0.02140 |
| Sonnet 5.5 | $0.00031 | $0.01070 |
| Haiku 4.5 | $0.00016 | $0.00535 |
Grade C, and why
compress scanned grade C with 1 finding 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 8d 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.
Recursive force deletehighDestructive command
rm -rf with a variable or a broad path is one typo away from removing the wrong tree.
rm -rf "$(dirname "<absolute-path-from-step-1>")" How it starts
The opening of the file, as written. The whole thing — 204 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Repository context. Gather first
Collect these with individual Bash calls, one command per call, never combined into a single invocation:
- Current branch,
git branch --show-current - Uncommitted .md files (empty = none matched or the probe returned nothing),
git status --porcelain | grep -E '\.md"?$' | head -10
The pipe is the bound and belongs in the command. A read-time cap ("read only the first 10 entries") bounds nothing: the Bash tool returns the command's complete output into context before there is anything to decide about.
Treat a failure (not a repository, git unavailable) as an unknown value and carry on. Keep these as
separate body Bash calls rather than pre-compute lines: the harness runs a skill's whole pre-compute
block as one shell invocation, and a worktree-isolated session refuses a compound command that
contains git. The dated record for that composition claim is the source-control plugin's
worktree/reference/gather-block.md,
"The pre-compute block runs as one shell invocation".
Purpose
Markdown in docs/, README files, onboarding docs, third-party pasted prose, and drifted skill bodies accumulates FLAVOR. Filler ("just", "really", "basically"), hedging ("perhaps", "might"), pleasantries, and, only when compress_articles is cut, articles. context/flavor-vs-content-matrix.md defines FLAVOR (safe to cut) vs CONTENT (never cut). Under the default, keep, a run keeps every a, an and the and is held to the batch path's word-level cuts on every target, single file included (Articles). The batch fan-out path (Phase A LATITUDE) is a word-level trimmer: mechanical drops + passive→active + nominalization only. No sentence-level restatement deletion. Under cut, the single-file in-session Edit fallback may apply the full matrix taxonomy (including redundant restatement of bold rule names) behind the same semantic-diff net. Always-loaded instruction files (.claude/rules/**, AGENTS.md, CLAUDE.md, **/SKILL.md) bound empirically at 2-3% yield (see ## Sources). Likely 5-15% yield on author-time-undisciplined content when the Edit fallback's broader latitude applies; batch fan-out yields are correspondingly smaller.
What ships with it
21 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.
- context/compare-prompt.md 3.0 KB
- context/fan-out-orchestration.md 6.4 KB
- context/flavor-vs-content-matrix.md 5.6 KB
- context/integration.md 5.2 KB
- context/semantic-diff-prompt.md 5.3 KB
- context/target-types.md 8.4 KB
- evals/evals.json 18 KB
- evals/fixtures/audit-fixture-dir/lean.md 528 B
- evals/fixtures/audit-fixture-dir/mixed.md 713 B
- evals/fixtures/audit-fixture-dir/verbose.md 1.8 KB
- evals/fixtures/docs-hygiene-articles-invalid.yaml 113 B
- evals/fixtures/docs-hygiene-articles-keep.yaml 116 B
- evals/fixtures/restated-rule-name.md 350 B
- evals/fixtures/terse-agent.md 346 B
- evals/fixtures/verbose-onboarding-snippet.md 599 B
- scripts/articles-setting.sh 2.5 KB runs code
- scripts/articles-setting.test.sh 5.1 KB runs code
- scripts/audit-scan.sh 5.1 KB runs code
- scripts/audit-scan.test.sh 4.4 KB runs code
- scripts/detect-caveman.sh 1.6 KB runs code
- scripts/detect-caveman.test.sh 3.5 KB runs code
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.
- 8d ago Changed · +21 lines · +20 tokens per session a2053985e461
- 12d ago Changed · +16 lines · +23 tokens per session 76de75a332e1
- 21d ago Changed · -87 tokens per session 4edaa9d9ad3a
- 1mo ago Changed · -33 tokens per session ed3b7df8c68a
- 1mo ago Changed · +1 lines 7923c6fa1214
- 1mo ago Changed · +8 lines 6af3b6312543
- 1mo ago First seen · 158 lines · 233 tokens per session scan C 04995323b335
compress is a skill published in the GitHub repository melodic-software/claude-code-plugins (26 stars, last pushed today), licensed MIT. It adds 156 tokens to every session and 5,350 once invoked, about $0.0006 per session on Opus 5.5. A static security scan graded it C with 1 finding (recursive force delete). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.
Other skills, from other repositories
parallel-orchestrator
Manage parallel Claude Code workstreams using git worktrees. Use when: splitting large tasks across multiple workers, coordinating parallel development, monitoring worker progress, integrating completed work, analyzing work item documents (code reviews, issue lists). Triggers: parallel, orchestrator, worktrees…
parallel-worker
Execute focused implementation tasks in a parallel workflow. Use when: working on assigned files in a worktree, making checkpoint commits, signaling dependencies or blockers, completing orchestrator-assigned tasks. Triggers: worker, checkpoint, worktree, assigned scope, commit prefix, parallel task.
optimize-local-search
For NP-hard optimization: TSP, scheduling, assignment problems. Uses greedy construction + local improvement (2-opt, hill climbing).
solve-constraint-puzzle
For constraint satisfaction: Sudoku, scheduling, N-queens, logic puzzles, SAT-like problems, assignment problems. Uses propagate-then-search pattern.
test-with-examples
For example-driven development: test cases as specifications, input/output pairs, documentation through examples.
validate-before-process
For input validation: check format and constraints before processing, fail fast with clear errors, defensive parsing.