skills.rest
lovincyrus
lovincyrusCOMMUNITY
Explore all skills by this author →
Website𝕏@_cyrusgohGitHub

reclaude

Refactors long CLAUDE.md files into a minimal root and topic-based documents.

Updated Aug 23, 2026
Search Tags:#documentation#markdown#progressive disclosure#CLAUDE.md#file-structure#reclaude
One-click install
npx skills add https://github.com/lovincyrus/claude-config --skill reclaude
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reclaude
Source: https://github.com/lovincyrus/claude-config/tree/main/skills/reclaude
Command: npx skills add https://github.com/lovincyrus/claude-config --skill reclaude

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams maintain concise, well-structured CLAUDE.md files by applying progressive disclosure, reducing clutter and improving readability for end users.

Core Features & Use Cases

  • Identify contradictions and surface conflicting instructions, prompting for user resolution.
  • Extract essentials for the root CLAUDE.md (one-sentence project description, package manager if not npm, non-standard build/typecheck commands, and anything truly essential).
  • Group the rest into logical categories and generate separate markdown files, plus a suggested docs/ folder structure.

Quick Start

Provide your CLAUDE.md content or a path to it, and the skill will produce:

  • a minimal root CLAUDE.md with links to the separate files
  • per-topic files for the remaining instructions
  • a recommended docs/ folder structure ready for review

Frequently Asked Questions about reclaude

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I refactor a long CLAUDE.md file to improve readability?▼

To refactor CLAUDE.md files, apply progressive disclosure by extracting essentials for the root file, grouping the rest into topic-based files, and proposing an organized docs/ folder structure for review.

What is progressive disclosure for markdown documentation?▼

Progressive disclosure structures markdown documentation by surfacing minimal essential information in a root file, then linking to separate topic-based files for detailed instructions to reduce clutter.

How do I resolve contradictions in multi-section CLAUDE.md documents?▼

Refactoring CLAUDE.md documents identifies contradictions and surfaces conflicting instructions, prompting for user resolution before extracting essentials and generating separate topic-based files.

What should be included in the root CLAUDE.md file?▼

The root CLAUDE.md file should include a one-sentence project description, package manager if not npm, non-standard build or typecheck commands, and anything truly essential, with links to generated topic files.

Can I generate a docs folder structure from existing CLAUDE.md content?▼

Yes, processing existing CLAUDE.md content extracts essentials for the root file and groups the remainder into logical categories, generating separate markdown files plus a suggested docs/ folder structure.

Does refactoring CLAUDE.md files work without external dependencies?▼

Refactoring CLAUDE.md files works without external dependencies, processing provided content or file paths directly to output a minimal root file and linked topic-based markdown files.

Related Skills

Explore More Content & Communication Skills→
NimbalystNimbalyst
25

claude-md-refactorer

Extract context-specific sections from CLAUDE.md files into path-scoped documentation.

Official
Intermediate
erichugyerichugy

reclaude

Refactor CLAUDE.md files into a minimal root document and topic markdown files.

Community
Intermediate
anukkrit149anukkrit149

agent-md-refactor

Refactor bloated agent instruction markdown into a minimal progressive-disclosure structure.

Community
Intermediate
zzafergokzzafergok
1

markdown-to-html-skill

Convert Markdown documents to HTML using marked.js, pandoc, gomarkdown, or static site generators.

Community
Intermediate