Docs Cleaner
Consolidates redundant documentation through section-by-section value analysis, cutting length without losing information.
What it does
Finds overlapping docs, classifies every section as Keep / Condense / Delete, then merges them into a single source of truth.
- Phase 1 – Discovery: list files on the same topic, count total lines, map overlap
- Phase 2 – Value analysis: a table of Section / Lines / Verdict / Reason
- Phase 3 – Consolidation plan: before-and-after line counts, reduction %, value-preserved %
- Phase 4 – Execution: write the merged doc → delete sources → update CLAUDE.md/README references → verify no broken links
A preservation checklist forces retention of essential procedures, gotchas, troubleshooting, tech debt, external links and debug snippets, while an anti-pattern table warns against blind deletion, keeping everything, multiple sources of truth, and orphaned references.
Who it's for
- Developers whose README, design notes and meeting logs have drifted apart
- Teams whose CLAUDE.md and docs/ folder keep growing and eating context
- Technical writers and PMs who want a doc refactor without information loss
Examples
- "Clean up the docs folder" → 3 files / 726 lines collapsed into one ~100-line doc with an 86% reduction report
- "Merge these install guides" → duplicated steps condensed, one-off test logs deleted with stated justification
- "CLAUDE.md is too long" → keep core rules inline, move details to a referenced doc and fix all links
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/daymade/claude-code-skills/HEAD/daymade-docs/docs-cleaner/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the 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-docs/docs-cleaner folder from the GitHub repo daymade/claude-code-skills into my ~/.claude/skills/docs-cleaner/. 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-docs/docs-cleaner ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the repo:
git clone https://github.com/daymade/claude-code-skills.git - Create the skills folder:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r claude-code-skills/daymade-docs/docs-cleaner ~/.claude/skills/ - Confirm
~/.claude/skills/docs-cleaner/SKILL.mdexists, and check whether thereferences/folder came along. - Restart Claude Code and ask it to "clean up docs" or "consolidate documentation".
- Important: this skill deletes files, so commit your current state with
git commitbefore running it.