Can I use this to automate documentation updates?

While it focuses on CLAUDE.md, it includes hooks and coordination patterns for managing the boundary between the root context and the wider project documentation.

How does the validation work?

The skill uses a linter (lint-claude-md.sh) and predefined patterns to ensure the file follows a specific structure, including behavioral rules and command references.

Why should I keep CLAUDE.md under 120 lines?

Keeping the file concise ensures that the most critical project context remains high-signal, preventing AI hallucinations and ensuring Claude focuses on your specific project rules.

Where should I put my long-form documentation?

According to the claude-md methodology, detailed reference material should live in a dedicated /docs directory, while CLAUDE.md only contains links to that material.

Claude.md Project Optimizer

Name: Claude.md Project Optimizer
Author: dohernandez

bydohernandez

0•

Learning & Documentation

Standardizes and optimizes the CLAUDE.md file to ensure concise, high-signal project instructions for AI agents.

The claude-md skill provides a disciplined methodology for authoring and maintaining the CLAUDE.md file, ensuring it remains a high-density reference for Claude. By enforcing a strict length limit of under 120 lines and a specific structure, it prevents context bloat and ensures the AI always has the most pertinent project information. This skill helps developers distinguish between essential behavioral instructions and secondary reference material, which is offloaded to a dedicated documentation directory to keep the primary context window clear and effective.

Key Features

01Separates core project conventions from secondary reference docs

02Enforces a strict 120-line limit for high-signal project context

03Automates linting to catch quantifiable rule violations

04Provides structural validation for the CLAUDE.md file format

05Defines clear patterns and anti-patterns for project instructions

060 GitHub stars

Use Cases

01Refactoring bloated project documentation into a high-signal summary

02Validating project guidelines through automated linting scripts

03Maintaining a clean and efficient instruction set for Claude in complex repositories

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dohernandez/claude-project-skills-template claude-md

For use in Claude.ai and ChatGPT

Key Features

01Separates core project conventions from secondary reference docs

02Enforces a strict 120-line limit for high-signal project context

03Automates linting to catch quantifiable rule violations

04Provides structural validation for the CLAUDE.md file format

05Defines clear patterns and anti-patterns for project instructions

060 GitHub stars

Use Cases

01Refactoring bloated project documentation into a high-signal summary

02Validating project guidelines through automated linting scripts

03Maintaining a clean and efficient instruction set for Claude in complex repositories

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dohernandez/claude-project-skills-template claude-md

For use in Claude.ai and ChatGPT