What is a CLAUDE.md file?

A CLAUDE.md file acts as the 'constitution' for Claude Code, providing persistent context about your codebase, build commands, and coding standards that are automatically loaded at the start of every session.

Why should I use claude-md instead of writing documentation manually?

This skill uses specialized analysis tools to find exact build scripts and applies token-saving 'conciseness patterns' that ensure your project rules don't push important code out of the AI's context window.

Can I use this to audit my existing project documentation?

Yes, the skill includes a quality audit checklist that identifies anti-patterns like stale commands, redundant information, and verbose explanations that waste tokens.

How does this skill help with monorepos?

It implements a hierarchical strategy where a root CLAUDE.md handles shared tooling while subdirectory-specific files manage local commands, keeping the total loaded context window small and relevant.

Claude-md Context Optimizer

Name: Claude-md Context Optimizer
Author: bandofai

bybandofai

•

Learning & Documentation

Creates and maintains optimized CLAUDE.md files to provide persistent project-specific context and specialized instructions for Claude Code.

About

The claude-md skill transforms Claude Code from a general-purpose assistant into a domain-specific expert by managing your project's 'constitution'. It automates the generation, auditing, and refinement of CLAUDE.md files, ensuring Claude has immediate access to your build commands, architecture patterns, and coding standards. By following a 'document what Claude gets wrong' philosophy, it optimizes context window usage, reduces token waste, and provides a hierarchical structure ideal for managing complex monorepos.

Key Features

Hierarchical monorepo support for subdirectory-specific context
Quality audit checklist to identify and fix documentation anti-patterns
Automated CLAUDE.md creation with proven structural templates
3 GitHub stars
Codebase analysis to extract build, test, and lint commands
Token-efficient writing guidelines for maximum context density

Use Cases

Bootstrapping a new repository with project-specific guardrails for Claude Code
Optimizing agent performance in large monorepos using hierarchical context files
Auditing existing documentation to remove token bloat and stale commands

About

Key Features

Hierarchical monorepo support for subdirectory-specific context
Quality audit checklist to identify and fix documentation anti-patterns
Automated CLAUDE.md creation with proven structural templates
3 GitHub stars
Codebase analysis to extract build, test, and lint commands
Token-efficient writing guidelines for maximum context density

Use Cases

Bootstrapping a new repository with project-specific guardrails for Claude Code
Optimizing agent performance in large monorepos using hierarchical context files
Auditing existing documentation to remove token bloat and stale commands