reclaude

Refactor CLAUDE.md files into categorized .claude/rules/ files with verification sections.

357|29|Updated Jan 19, 2026

Search Tags:#documentation #refactor #code organization #ai assistant #progressive disclosure #claudemd

Ready to run

npx skills add https://github.com/brianlovin/agent-config --skill reclaude-brianlovin

💬 Prompt for ChatGPT / Claude Chat▼

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill tackles overly long or disorganized CLAUDE.md files by refactoring them to follow progressive disclosure principles, making them more manageable and actionable.

Core Features & Use Cases

Length Analysis: Assesses CLAUDE.md length and suggests refactoring for files over 100 lines.
Workflow Integration: Incorporates principles from workflow/SKILL.md for better task management.
Verification Section: Ensures a ## Verification section exists with runnable commands.
Content Organization: Moves detailed instructions to .claude/rules/ files and identifies content for deletion.
Use Case: You have a CLAUDE.md file that has grown to several hundred lines. Use this Skill to condense it, organize related instructions into separate rule files, and ensure it includes clear verification steps.

Quick Start

Refactor the current CLAUDE.md file to follow progressive disclosure principles.

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 that is too long?▼

Refactoring a lengthy CLAUDE.md file involves applying progressive disclosure principles to condense content, extracting reusable global skills, and moving detailed instructions into categorized `.claude/rules/` files.

What is progressive disclosure for AI assistant configuration files?▼

Progressive disclosure organizes AI assistant configuration files by keeping core instructions brief, integrating workflow orchestration, ensuring a verification section, and relocating detailed rules to separate `.claude/rules/` files.

When should I reorganize my CLAUDE.md file?▼

You should reorganize your CLAUDE.md file when it exceeds 100 lines, contains contradictions, or lacks clear verification steps, making it difficult for the AI assistant to parse instructions accurately.

How do I extract reusable global skills from CLAUDE.md?▼

Extracting reusable global skills involves analyzing your CLAUDE.md content to identify shared workflows, separating them from project-specific instructions, and flagging redundant information for deletion.

Does this refactoring approach support workflow orchestration integration?▼

Yes, the refactoring process incorporates workflow orchestration principles directly into the CLAUDE.md file structure to ensure better task management and execution verification for the AI assistant.

What are the limitations of organizing code organization rules into separate files?▼

A limitation is that splitting instructions into `.claude/rules/` files requires maintaining multiple files instead of one, which may complicate tracking if the project structure changes frequently.