skills.rest
erichugy
erichugyCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

reclaude

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

Updated Apr 10, 2026
Search Tags:#workflow#documentation#markdown#claude#refactor#docs#progressive-disclosure
One-click install
npx skills add https://github.com/erichugy/agentic.skills --skill reclaude-erichugy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reclaude
Source: https://github.com/erichugy/agentic.skills/tree/main/reclaude
Command: npx skills add https://github.com/erichugy/agentic.skills --skill reclaude-erichugy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill reduces cognitive overload from long or disorganized CLAUDE.md files by extracting only the globally relevant information, resolving conflicting guidance, and reorganizing remaining content into focused, discoverable topic files using progressive disclosure.

Core Features & Use Cases

  • Contradiction Detection: Identify contradictory or conflicting instructions and prompt for resolution choices.
  • Essentials Extraction: Produce a minimal root CLAUDE.md containing a one-sentence project description, package manager notes, and any non-standard build or typecheck commands.
  • Topical Grouping: Organize remaining guidance into separate markdown files by logical categories and suggest a docs/ folder structure.
  • Prune Recommendations: Flag redundant, vague, or overly obvious items for deletion or relocation to reduce noise.
  • Use Case: Ideal for developer repositories with sprawling CLAUDE.md files that mix onboarding, coding conventions, build instructions, and workflow policies.

Quick Start

Refactor my CLAUDE.md into a minimal root file and a set of topic-specific markdown files following progressive disclosure, flagging contradictions and vague or redundant instructions.

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 organized markdown documentation?▼

A CLAUDE.md file needs refactoring when it mixes essential project settings, build commands, coding conventions, and workflow policies, causing cognitive overload and making it difficult for developers to find specific guidance quickly.

How do I split mixed developer documentation into a docs folder structure?▼

Yes, contradiction detection identifies conflicting instructions within CLAUDE.md and prompts for resolution choices, ensuring the refactored documentation provides consistent, clear guidance for developers.

Can I detect contradictory coding conventions when reorganizing repository documentation?▼

Contradiction detection identifies conflicting instructions within a disorganized CLAUDE.md and prompts for resolution choices, ensuring the refactored documentation provides consistent guidance for developers.

What should a minimal root CLAUDE.md contain after refactoring?▼

Prune recommendations flag redundant, vague, or overly obvious items for deletion or relocation, reducing noise and keeping the root CLAUDE.md focused on globally relevant information only.

Does CLAUDE.md refactoring work for repositories with mixed onboarding and workflow policies?▼

Yes, CLAUDE.md refactoring is ideal for developer repositories with sprawling files that mix onboarding, coding conventions, build instructions, and workflow policies, reorganizing them into focused, discoverable topic files.

Related Skills

Explore More Software Engineering Skills→
fyrsmithlabsfyrsmithlabs

setup

Analyze a repository and generate CLAUDE.md with governance and onboarding guidance.

Official
Advanced
TrevorEdrisTrevorEdris
2

agent-md-refactor

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

Community
Intermediate
willyu1007willyu1007

docs

Route documentation tasks including authoring, planning, and release updates.

Community
Basic
tiankong0101-bytetiankong0101-byte

deepinit

Generate hierarchical AGENTS.md documentation with parent references for codebase directories.

Community
Advanced