Claude Skill MartBrowse skillsWhat is a Skill?
Back to list

CLAUDE.md Progressive Disclosurer

Restructures a bloated CLAUDE.md / AGENTS.md into a lean Level 1 plus on-demand Level 2 references, with verified zero information loss.

Dev & CodingAdvanced1,323212AI score 9/10Last updated: Aug 8, 2026

What it does

Turns "slim down my CLAUDE.md" into a measured, verifiable refactor:

  • Profile first: /context share of the startup context, per-heading byte table (work in descending order), giant-line distribution, and downstream truncation limits (e.g. Codex project_doc_max_bytes, 32KiB default — anything beyond is silently invisible).
  • Signal triage: the litmus is "if I delete this, will Claude get it wrong?" Anything inferable from the code, standard language conventions, or self-evident advice is an anti-signal — listed as a deletion candidate and removed only with user confirmation.
  • Verbatim moves, compression forbidden: moving to Level 2 must copy text unchanged; 3+ sections use scripts/sink_sections.py with full-string verification and automatic rollback.
  • Carrier selection matrix: decides whether a rule belongs in resident Level 1, a reference, a Skill, a Hook (blocking vs injecting), or ~/.claude/rules/ with paths: frontmatter.
  • Three-part verification: reference existence (5a), content integrity (5b — an independent sub-agent audit is the default, forking banned), and line count explicitly excluded as a criterion (5c).
  • Documents how the verifiers themselves lie: grep -F degrades to per-line OR on multi-line originals (false pass for lossy moves), symlinks silently skipped, regex metacharacters, bash vs zsh word splitting — all field-tested.

Who it's for

  • Teams whose CLAUDE.md has grown so large that Claude keeps ignoring rules
  • Anyone who wants to reorganize guidance without losing a single useful detail
  • Users whose global ~/.claude/CLAUDE.md is polluted with project-specific paths
  • People sharing the same doc with Codex or other tools that may truncate it silently

Examples

  1. "Is my CLAUDE.md too long?" → the skill reframes (line count is a symptom, not a goal), then produces a per-section byte table and attacks the biggest contributor first.
  2. Cleaning a 168KB global file → identifies it as 69% of session startup context, sinks 10 low-frequency SOP sections verbatim into ~/.claude/references/, and adds trigger-keyed index tables at the top and bottom.
  3. Hunting fake pointers → a line says "see anti-patterns.md" but the content was never moved there; caught via distinctive-string grep -F plus a python3 whole-string containment check.

· · · Install guide · · ·

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the daymade-claude-code/claude-md-progressive-disclosurer folder from the GitHub repo daymade/claude-code-skills into my ~/.claude/skills/claude-md-progressive-disclosurer/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/daymade-claude-code/claude-md-progressive-disclosurer ~/.claude/skills/

This is a third-party skill. Check the source repository before installing.

  1. Open a terminal and cd into any working directory.
  2. Clone the repo: git clone https://github.com/daymade/claude-code-skills.git
  3. Create the skills directory: mkdir -p ~/.claude/skills
  4. Copy just this skill: cp -r claude-code-skills/daymade-claude-code/claude-md-progressive-disclosurer ~/.claude/skills/
  5. Confirm the bundled references/ and scripts/ folders came along: ls ~/.claude/skills/claude-md-progressive-disclosurer
  6. Restart Claude Code, then ask: "Optimize my CLAUDE.md using progressive disclosure."
  7. Let it run Step 1 backup first (cp CLAUDE.md CLAUDE.md.bak.$(date +%Y%m%d_%H%M%S)) before any edits.
  8. Verification steps require python3 — check with python3 --version beforehand, since bare python is gone on modern macOS.