skills.rest
EllevatedAI
EllevatedAIOFFICIAL
Explore all skills by this author →
GitHub

claude-md-writer

Enforce a 3-tier modular structure for CLAUDE.md documentation.

Updated Aug 23, 2026
Search Tags:#documentation#optimization#claude-code#frontmatter#rules#md-writer
One-click install
npx skills add https://github.com/EllevatedAI/MeMyselfAndI --skill claude-md-writer-ellevatedai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-md-writer
Source: https://github.com/EllevatedAI/MeMyselfAndI/tree/main/.claude/skills/claude-md-writer
Command: npx skills add https://github.com/EllevatedAI/MeMyselfAndI --skill claude-md-writer-ellevatedai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CLAUDE.md often becomes messy and hard to maintain; this skill enforces a compact, modular structure that keeps universal rules, domain-specific guidelines, and feature docs in a consistent format.

Core Features & Use Cases

  • Enforces a three-tier structure: Tier 1 universal CLAUDE.md, Tier 2 domain rules under .claude/rules, and Tier 3 feature docs near code.
  • Encourages concise main files (< 200 lines) and scalable rules files (< 500 lines) for maintainability.
  • Helps teams rapidly adopt Claude Code guidelines, ensuring consistent prompts, references, and examples across projects.

Quick Start

Run claude-md-writer to optimize CLAUDE.md using a 3-tier modular structure

Frequently Asked Questions about claude-md-writer

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

FAQPage Schema
How do I structure CLAUDE.md files for Claude Code projects?▼

Structure CLAUDE.md using a 3-tier modular system: a universal Tier 1 main file, Tier 2 domain rules under .claude/rules, and Tier 3 feature documentation adjacent to code. This keeps documentation compact, organized, and easy to maintain.

What is the maximum line count for a main CLAUDE.md file?▼

The main CLAUDE.md file should be kept under 200 lines to ensure maintainability. Domain rules files under .claude/rules should stay under 500 lines and include paths frontmatter for conditional loading.

How does conditional loading work for Claude Code rules files?▼

Conditional loading for rules files is enabled through paths frontmatter in the Tier 2 .claude/rules directory. The main CLAUDE.md must explicitly reference .claude/rules to trigger loading of these domain-specific guidelines.

How do I organize domain-specific guidelines separately from universal rules?▼

Place domain-specific guidelines in Tier 2 rules files within the .claude/rules directory, keeping universal rules in the Tier 1 main CLAUDE.md file. This separation ensures concise main files and scalable, context-specific rule loading.

Where should feature documentation be placed in a Claude Code repository?▼

Feature documentation should be placed in Tier 3, located adjacent to the corresponding code. This modular structure prevents the main CLAUDE.md from becoming messy and ensures docs stay near relevant features.

Can I use a modular CLAUDE.md structure for large team projects?▼

Yes, the 3-tier modular structure supports large team projects by separating universal rules, domain guidelines, and feature docs. It enforces consistent prompts and references across projects while keeping files concise and maintainable.

Related Skills

Explore More Software Engineering Skills→
DevQwietDevQwiet

claude-memory

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

Community
Advanced
changoo89changoo89
19

docs-verify

Validate 3-Tier documentation compliance for line limits, cross-references, and file counts.

Community
Advanced
t-stringst-strings

Global Validation

Enforce centralized validation standards across repository code and CI pipelines.

Official
Basic
mmogibmmogib

init-project

Generate a complete research project skeleton with CLAUDE.md and LaTeX templates.

Community
Advanced