skills.rest
dohernandez
dohernandezCOMMUNITY
Explore all skills by this author →
GitHub

claude-md

Enforce CLAUDE.md brevity, relevance, and structural standards.

Updated Feb 22, 2026
Search Tags:#documentation#markdown#authoring#content quality#claude-md#repo-hygiene
One-click install
npx skills add https://github.com/dohernandez/claude-project-skills-template --skill claude-md-dohernandez
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-md
Source: https://github.com/dohernandez/claude-project-skills-template/tree/main/.claude/skills/claude-md
Command: npx skills add https://github.com/dohernandez/claude-project-skills-template --skill claude-md-dohernandez

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures that your project's main CLAUDE.md file remains concise, relevant, and well-structured, preventing it from becoming bloated with unnecessary information and making it more effective for AI interaction.

Core Features & Use Cases

  • Content Relevance Enforcement: Guarantees that every line in CLAUDE.md serves a purpose in most sessions.
  • Structure Standardization: Enforces a consistent and easily navigable structure, including clear sections and a tech stack declaration.
  • Automation Integration: Works with linters and other skills to maintain document quality automatically.
  • Use Case: When updating CLAUDE.md, this skill helps you decide whether new information should be added, moved to documentation, or omitted entirely, keeping the file focused.

Quick Start

Run the CLAUDE.md linting task to validate its structure and content rules.

Frequently Asked Questions about claude-md

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

FAQPage Schema
How do I maintain CLAUDE.md for clarity and signal without bloating it with unnecessary information?▼

Maintain CLAUDE.md for clarity by enforcing an 80% relevance test for every line, keeping the file under 120 lines, and applying specific structural patterns to ensure brevity and optimal AI context.

What is the best way to structure a CLAUDE.md file for optimal AI interaction?▼

Structure a CLAUDE.md file for AI interaction by enforcing standardization with clear sections and a tech stack declaration, ensuring the document remains concise and easily navigable for optimal context.

How do I decide whether new information should be added to CLAUDE.md or moved to documentation?▼

Decide whether to add new information to CLAUDE.md by applying an 80% relevance test; if the content does not serve a purpose in most sessions, move it to separate documentation to keep the file focused.

Can I use linters to automate documentation hygiene for CLAUDE.md?▼

You can use linters to automate documentation hygiene for CLAUDE.md by running a linting task that validates structure and content rules, integrating with other skills to maintain document quality automatically.

What are the limitations of enforcing a strict line count under 120 for repo hygiene?▼

Enforcing a strict line count under 120 for repo hygiene limits the CLAUDE.md file's capacity, requiring you to omit low-relevance information or move it to external documentation to maintain brevity and signal.

Related Skills

Explore More Content & Communication Skills→
raybargasraybargas

Global Tech Stack

Enforces global tech stack standards across code, configurations, and CI/CD workflows.

Community
Basic
anthony-chaudharyanthony-chaudhary
30

steerability-score

Quantify repository steerability with growth-invariant KPIs and guide refactoring.

Community
Advanced
sambersamber
2.9k

golang-lint

Configure and run golangci-lint to analyze Go projects and interpret results.

Community
Advanced
Mahaboob26Mahaboob26

markdown-documentation

Create structured Markdown documentation with GitHub Flavored Markdown formatting.

Community
Basic