reclaude

Refactor CLAUDE.md files into categorized markdown files with progressive disclosure.

1|Updated Dec 20, 2018

Search Tags:#documentation #markdown #refactoring #clarity #organization #clau de

Ready to run

npx skills add https://github.com/parkerhendo/home-config --skill reclaude-parkerhendo

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: reclaude
Source: https://github.com/parkerhendo/home-config/tree/main/dotfiles/claude/skills/reclaude
Command: npx skills add https://github.com/parkerhendo/home-config --skill reclaude-parkerhendo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill tackles disorganized and overly long CLAUDE.md files by restructuring them according to progressive disclosure principles, making them easier to understand and maintain.

Core Features & Use Cases

Contradiction Resolution: Identifies and helps resolve conflicting instructions within the documentation.
Content Distillation: Separates essential information for the root file from detailed instructions that belong in separate, linked files.
Organization: Groups related instructions into logical categories and suggests a clear file structure.
Use Case: You have a complex CLAUDE.md file with hundreds of lines of instructions. This Skill will break it down into a concise main file with links to specialized markdown files for testing, API design, and Git workflows, improving readability and navigability.

Quick Start

Use the reclaude skill to refactor the current CLAUDE.md file.

Frequently Asked Questions about reclaude

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

FAQPage Schema

How do I refactor a CLAUDE.md file to improve readability and organization?▼

To refactor a CLAUDE.md file, this Skill applies progressive disclosure principles to distill essential information for the root file and categorize remaining content into separate linked markdown files with a suggested directory structure.

What is progressive disclosure for markdown documentation?▼

Progressive disclosure for markdown documentation separates essential instructions into a concise root file while moving detailed, specialized content into separate linked files, improving navigability and maintainability.

How do I resolve conflicting instructions in a CLAUDE.md file?▼

This Skill identifies and helps resolve instruction conflicts within your CLAUDE.md file by flagging contradictory statements during the refactoring process so you can review and correct them.

Can I split a large CLAUDE.md file into multiple markdown files?▼

Yes, this Skill splits large CLAUDE.md files by grouping related instructions into logical categories and suggesting a clear directory structure with specialized markdown files for topics like testing, API design, and Git workflows.

What's the best way to clean up vague or redundant instructions in markdown files?▼

The best way to clean up redundant or vague instructions is using this Skill, which flags unnecessary or conflicting directives during the refactoring process for deletion to ensure documentation clarity.