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.

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

01Preservation of all documentation while improving organization and scannability

02Intelligent extraction of sections from monolithic CLAUDE.md files

03Modular directory structure creation for frontend, backend, and core rules

041 GitHub stars

05Automatic generation of YAML frontmatter with path-specific glob patterns

06Built-in safety with original file archiving and validation checklists

Use Cases

01Migrating a growing project from a single CLAUDE.md to the modular .claude/rules/ system

02Organizing project-wide coding standards into domain-specific rule files like React or API guidelines

03Optimizing Claude's performance by scoping instructions to specific file paths using glob patterns

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lisaross/claude-code-plugins rules-migration

For use in Claude.ai and ChatGPT

Download Skill