Docs Cleaner
Consolidates redundant documentation into a single source of truth without losing valuable content.
Docs & OfficeBeginner★ 1,323⑂ 212AI score 7/10Last updated: Aug 8, 2026
What it does
Analyzes overlapping documentation files and merges them without losing information.
- Discovery: finds every file covering the topic, counts total lines, maps overlap
- Value analysis: classifies each section as
Keep / Condense / Deletein a justification table - Consolidation plan: reports before/after metrics like "726 lines → ~100 lines (86% reduction), 100% value preserved"
- Execution: writes the consolidated doc → deletes redundant files → updates references in CLAUDE.md/README → checks for broken links
- Includes a preservation checklist for procedures, constraints, troubleshooting, and external links
It also warns against anti-patterns: blind deletion, keeping everything, multiple sources of truth, orphaned references.
Who it's for
- Developers with a bloated
docs/folder and no idea which file is current - Project owners drowning in AI-generated summary and report markdown files
- Team leads consolidating onboarding docs into one authoritative page
- Anyone trying to keep CLAUDE.md or README lean
Examples
- Cleaning AI output: with
SETUP.md,SETUP_V2.md, andINSTALL_NOTES.md, ask "consolidate these docs" — it builds a value table, produces oneSETUP.md, deletes the rest, and fixes README links. - Dropping one-time records: test-run results and migration logs get marked
Delete, while reusable troubleshooting tips are carried into the new document. - Slimming CLAUDE.md: a 1,000-line rules file is trimmed to core constraints, with details moved to
docs/and only a pointer left behind.
· · · Install guide · · ·
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 (Terminal on macOS/Linux, Git Bash on Windows).
- Clone the repo:
git clone https://github.com/daymade/claude-code-skills.git - Create the skills folder if needed:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r claude-code-skills/daymade-docs/docs-cleaner ~/.claude/skills/ - Verify with
ls ~/.claude/skills/docs-cleaner— you should seeSKILL.md. - Restart Claude Code.
- Important: the skill deletes real files, so
git commityour current state first. - Inside your project, say "clean up the redundant docs in docs/" and the skill triggers automatically.
View source on GitHub ↗License: MIT