Our review
Methodology for authoring and maintaining a concise and structured CLAUDE.md file for AI agents.
Strengths
- Keeps file under 120 lines
- Ensures 80% relevance per line
- Clear structure with titles and sections
- Automation via a linter
Limitations
- Requires regular editing discipline
- Can become outdated if not updated
- Does not cover all edge cases
When setting up a project with an AI agent to establish clear and concise guidelines.
For very simple projects where a short unstructured file suffices.
Security analysis
SafeThe skill only invokes a linting/validation command via a task runner after stopping; no destructive or exfiltrating actions are performed, and it only uses standard, non-obfuscated tools.
No concerns found
Examples
Run the linter to check if my CLAUDE.md follows the recommended structure and length.My CLAUDE.md is too long. Please restructure it to be under 120 lines and move reference material to docs/ folder.Explain the key principles for writing a good CLAUDE.md, including the target length, structure, and what to include/exclude.name: claude-md description: "Methodology for authoring and maintaining CLAUDE.md. Enforces brevity, relevance, and structure." user-invocable: false allowed-tools:
- Read
- Edit
- Bash
- Grep
- Glob
hooks:
Stop:
- type: command command: "task claude:validate-skill -- --skill claude-md"
CLAUDE.md Authoring
Purpose
Methodology for editing CLAUDE.md that keeps it concise, high-signal, and structurally sound. The guide (patterns/anti-patterns in skill.yaml) is the primary value; the linter (lint-claude-md.sh) is a safety net for quantifiable rules.
Quick Reference
- Target: <120 lines, 80% relevance per line
- Structure: Title, behavioral, "Built with:", dirs-only structure, auto-gen table, commands, conventions
- Rule: Reference material lives in
docs/— CLAUDE.md links to it
task docs:lint-claude-md # Validate CLAUDE.md structure
Key Principle
Every line in CLAUDE.md must be useful in 80%+ of sessions. If it's reference material, move it to docs/ and link. If Claude can discover it with tools, omit it.
Automation
See skill.yaml for patterns, anti-patterns, and editing procedure.
See collaboration.yaml for boundaries with docs-refresh.
See sharp-edges.yaml for common pitfalls.
Next.js App Router Expert
Development
A skill that turns Claude into a Next.js App Router expert.
README Generator
Development
Creates professional and comprehensive README.md files for your projects.
API Documentation Writer
Development
Generates comprehensive API documentation in OpenAPI/Swagger format.