skills.rest
erclx
erclxCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

migration-claude-md

Analyze and refactor bloated CLAUDE.md files into modular context structures.

2|Updated Jan 13, 2026
Search Tags:#automation#documentation#context#refactoring#claude#rules
One-click install
npx skills add https://github.com/erclx/aitk --skill migration-claude-md
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: migration-claude-md
Source: https://github.com/erclx/aitk/tree/main/claude/skills/migration-claude-md
Command: npx skills add https://github.com/erclx/aitk --skill migration-claude-md

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the issue of bloated CLAUDE.md files that become difficult for AI agents to parse effectively, helping you maintain a clean, modular, and performant project context.

Core Features & Use Cases

  • Context Classification: Automatically categorizes sections of your CLAUDE.md into always-load behavior, path-scoped rules, or domain-specific context entries.
  • Proposal Generation: Provides a structured plan for refactoring your documentation without making destructive changes to your files.
  • Use Case: When your project's CLAUDE.md has grown too large and agents are struggling to follow instructions, use this skill to identify which parts should be moved to specific rules or context files.

Quick Start

Ask the migration-claude-md skill to analyze the current CLAUDE.md and propose a rebalancing plan for the project.

Frequently Asked Questions about migration-claude-md

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

FAQPage Schema
How do I refactor a bloated CLAUDE.md file to improve AI agent context?▼

To refactor a bloated CLAUDE.md, you can analyze and migrate its sections into a modular three-tier context model of always-load behavior, path-scoped rules, and domain narrative for better agent parsing.

When should I migrate project context to .claude/rules/ or .claude/context/ structures?▼

You should migrate to .claude/rules/ or .claude/context/ structures when your CLAUDE.md grows too large and AI agents struggle to follow instructions effectively within the project directory.

Does refactoring CLAUDE.md into a modular context model make destructive changes to my files?▼

No, refactoring CLAUDE.md into a modular context model does not make destructive changes; it generates a structured rebalancing proposal to categorize sections without destroying original files.

How are CLAUDE.md sections classified during context rebalancing?▼

During context rebalancing, CLAUDE.md sections are classified into always-load behavior, path-scoped rules, or domain-specific context entries using a seed baseline comparison for accurate categorization.

Do I need the aitk CLI to analyze and optimize my CLAUDE.md?▼

Yes, you need the aitk CLI installed and access to the project root directory to perform seed baseline comparison and ensure accurate classification of your CLAUDE.md context.

What is the best way to split a large CLAUDE.md into modular path-scoped rules?▼

The best way to split a large CLAUDE.md is to analyze the document and propose a rebalancing plan, identifying specific sections suitable for migration to modular path-scoped rules or domain context files.

Related Skills

Explore More Software Engineering Skills→
MakisuoMakisuo
1.6k

clickhousectl-local-dev

Install and configure a local ClickHouse environment with clickhousectl.

Community
Intermediate
hidemaro-nsketchhidemaro-nsketch

context-loader

Load project context from the .claude directory for OpenCLI.

Community
Intermediate
DevQwietDevQwiet

claude-memory

Optimize Claude.md memory files and modular rules for Claude Code projects.

Community
Advanced
deangilmoreremixdeangilmoreremix

agent-md-refactor

Refactor bloated agent instruction files into concise root documents with linked sub-files.

Community
Intermediate