skills.rest
mattdowney
mattdowneyCOMMUNITY
Explore all skills by this author →
Website𝕏@mattdowneyGitHub

reclaude

Refactor CLAUDE.md files into a minimal root document with categorized detail files.

Updated Aug 27, 2026
Search Tags:#documentation#refactor#progressive-disclosure#content-organization#claude-md#tech-writer#modular-docs
One-click install
npx skills add https://github.com/mattdowney/ai-skills --skill reclaude-mattdowney
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reclaude
Source: https://github.com/mattdowney/ai-skills/tree/main/reclaude
Command: npx skills add https://github.com/mattdowney/ai-skills --skill reclaude-mattdowney

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Refactor CLAUDE.md files to follow progressive disclosure principles to improve readability, navigation, and task-focused execution.

Core Features & Use Cases

  • Identify contradictions and conflicting instructions, and suggest versions to retain.
  • Extract the essentials for the root CLAUDE.md (one-sentence description, non-standard build commands, and anything universally relevant).
  • Group remaining instructions into logical categories and produce separate files for each category; propose a docs/ folder structure.
  • Output a minimal root CLAUDE.md with links to the generated files and maintainable guidance for future updates.
  • Flag redundant, vague, or overly obvious instructions to aid maintainability and clarity.

Quick Start

Provide your CLAUDE.md content and let this skill restructure it into a progressive-disclosure layout.

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 into modular documentation?▼

Refactor a long CLAUDE.md file by extracting essential items into a minimal root file, grouping remaining instructions into categorized topic files, and linking them for modular, progressive-disclosure navigation.

What is progressive disclosure for Claude project documentation?▼

Progressive disclosure organizes project instructions by surfacing only universally relevant essentials in a root CLAUDE.md, moving detailed or topic-specific guidance into separate linked files to improve readability.

How do I identify redundant or conflicting instructions in my CLAUDE.md?▼

Identify redundant or conflicting instructions by analyzing your CLAUDE.md content to flag vague items, detect overlapping directives, and suggest specific versions to retain for maintainability.

When should I restructure my CLAUDE.md into a docs folder structure?▼

Restructure your CLAUDE.md into a docs folder structure when the file becomes long or disorganized, grouping instructions into logical categories with separate files to enable task-focused execution.

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

A minimal root CLAUDE.md should include a one-sentence project description, non-standard build commands, and universally relevant instructions, with links pointing to categorized detail files.

Can I get maintainable guidance for future CLAUDE.md updates after refactoring?▼

Refactoring outputs maintainable guidance for future CLAUDE.md updates by proposing a clear docs folder structure, flagging overly obvious instructions, and providing a modular layout for easy additions.

Related Skills

Explore More Content & Communication Skills→
billlzzz26billlzzz26
2

agent-md-refactor

Refactor bloated agent instruction files into a minimal root with linked documentation.

Community
Advanced
erichugyerichugy

reclaude

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

Community
Intermediate
xiaoyuge886xiaoyuge886
196

skill-development

Generate modular skill structures for Claude Code plugins with progressive disclosure.

Community
Advanced
TrevorEdrisTrevorEdris
2

agent-md-refactor

Refactor bloated AGENTS.md files into minimal root and linked topic files.

Community
Intermediate