Does this skill delete my original CLAUDE.md?

No, the skill safely archives your original CLAUDE.md as a backup before creating the new modular directory structure.

How does the skill determine which rules apply to which files?

It analyzes your directory structure and content to generate YAML frontmatter with glob patterns (e.g., src/**/*.tsx) for path-specific rules.

Can I customize the resulting folder structure?

Yes, while the skill follows best practices for organization, you can easily rename, move, or combine the generated Markdown files in the .claude/rules/ directory.

Why should I migrate from CLAUDE.md to the rules system?

Modular rules allow Claude to load only the instructions relevant to the specific files you are working on, reducing noise and improving the accuracy of AI suggestions.

Claude Rules Migration

Name: Claude Rules Migration
Author: lisaross

bylisaross

•

Developer Tools

Automates the conversion of monolithic CLAUDE.md files into the modular .claude/rules/ directory structure for better instruction management.

About

The Rules Migration skill streamlines the transition from a single, large project instruction file to Claude Code's advanced modular rules system. By analyzing your existing CLAUDE.md, it intelligently categorizes instructions into path-specific rule files with appropriate YAML frontmatter and glob patterns. This enables progressive disclosure of information, ensuring Claude only loads relevant context for the files currently being edited, which improves performance and accuracy while reducing context window clutter.

Key Features

Preservation of all documentation while improving organization and scannability
Intelligent extraction of sections from monolithic CLAUDE.md files
Modular directory structure creation for frontend, backend, and core rules
1 GitHub stars
Automatic generation of YAML frontmatter with path-specific glob patterns
Built-in safety with original file archiving and validation checklists

Use Cases

Migrating a growing project from a single CLAUDE.md to the modular .claude/rules/ system
Organizing project-wide coding standards into domain-specific rule files like React or API guidelines
Optimizing Claude's performance by scoping instructions to specific file paths using glob patterns

About

Key Features

Preservation of all documentation while improving organization and scannability
Intelligent extraction of sections from monolithic CLAUDE.md files
Modular directory structure creation for frontend, backend, and core rules
1 GitHub stars
Automatic generation of YAML frontmatter with path-specific glob patterns
Built-in safety with original file archiving and validation checklists

Use Cases

Migrating a growing project from a single CLAUDE.md to the modular .claude/rules/ system
Organizing project-wide coding standards into domain-specific rule files like React or API guidelines
Optimizing Claude's performance by scoping instructions to specific file paths using glob patterns