Should I put linting and formatting rules in CLAUDE.md?

No. Best practices suggest using dedicated tools like ESLint, Prettier, or Biome. CLAUDE.md should focus on architecture, commands, and logic patterns that tools can't catch.

How do path-specific rules work?

By adding YAML frontmatter with 'paths:' to a rule file, you can instruct Claude to only load those specific instructions when you are working on files that match the defined glob patterns.

What is the 3-Tier Documentation System?

It is a strategy that splits documentation into Foundation (always loaded), Component (loaded via .claude/rules/ when relevant), and Feature (co-located with code) to maximize relevance and minimize noise.

Why does this skill enforce a 200-line limit for CLAUDE.md?

CLAUDE.md is loaded on every single request. Keeping it under 200 lines ensures critical context is prioritized and significantly reduces token costs over long development sessions.

Claude MD Writer

Name: Claude MD Writer
Author: atsyplenkov

byatsyplenkov

0•

Learning & Documentation

Optimizes and refactors CLAUDE.md files and project rules to enhance AI performance and reduce token consumption.

Claude MD Writer is a specialized skill designed to manage project memory and context for Claude Code following 2026 official best practices. It helps developers maintain efficient, high-performance project documentation by enforcing strict size limits and implementing a modular 3-tier hierarchy. By transitioning large, monolithic CLAUDE.md files into organized, path-specific rules within the .claude/rules/ directory, this skill ensures that Claude only loads relevant information for the task at hand, preventing context bloat and improving the accuracy of AI-generated code and architectural decisions.

Key Features

01Implements a modular 3-tier documentation system separating foundation, component, and feature rules.

02Configures conditional rule loading using YAML frontmatter and glob patterns for specific file paths.

03Enforces a <200 line limit for main CLAUDE.md files to minimize per-request token costs.

040 GitHub stars

05Utilizes file referencing with @ syntax to maintain a single source of truth without duplication.

06Automates the refactoring of bloated documentation into structured subdirectories.

Use Cases

01Setting up path-specific coding standards that only load when working on specific directories like /api or /frontend.

02Optimizing project memory for large-scale codebases where CLAUDE.md has become too large to be efficient.

03Implementing personal developer preferences via CLAUDE.local.md without affecting team-wide repository settings.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add atsyplenkov/.dotfiles claude-md-writer

For use in Claude.ai and ChatGPT

Download Skill