Will Docs Cleaner delete my important project notes?

No. The skill uses a 'Value Analysis' phase that categorizes every section before any changes are made. It is designed to preserve 100% of valuable technical content while only removing redundancy.

What kind of files can it clean up?

It is optimized for Markdown documentation, setup guides, API references, troubleshooting logs, and technical debt lists commonly found in software repositories.

Does it fix broken links after merging files?

Yes, part of the execution phase involves updating references in CLAUDE.md and other root files to point to the new consolidated locations, ensuring no broken links remain.

When is the best time to use this skill?

Use it whenever documentation exceeds 500 lines across multiple files or when you notice the same instructions being repeated in different places like the README and CLAUDE.md.

Docs Cleaner

Name: Docs Cleaner
Author: daymade

bydaymade

•

147

•

Content Management

Consolidates redundant documentation and eliminates sprawl while preserving all essential technical information and value.

The Docs Cleaner skill optimizes your project's documentation landscape by identifying redundant files, performing rigorous value analysis, and merging scattered information into a single, authoritative source of truth. It follows a structured four-phase workflow—Discovery, Value Analysis, Consolidation, and Execution—to significantly reduce documentation line counts without losing critical setup procedures, troubleshooting guides, or technical constraints. This skill is essential for maintaining a clean, navigable codebase where information is easy to find and impossible to mistake for outdated duplicates.

Key Features

01Value preservation checklist to ensure no critical procedures are lost

02Automated redundancy mapping across multiple documentation files

03147 GitHub stars

04Automatic reference updating for CLAUDE.md, README, and project links

05Metric-driven consolidation plans showing reduction percentages

06Section-by-section value analysis categorization (Keep, Condense, Delete)

Use Cases

01Cleaning up verbose, outdated, or one-time reference files to improve project clarity

02Merging multiple overlapping setup guides into a single source of truth

03Reducing documentation sprawl in large legacy repositories with high redundancy

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add daymade/claude-code-skills docs-cleaner

For use in Claude.ai and ChatGPT

Download Skill