Claude Md
- 3 repo stars
- Updated November 29, 2025
- bandofai/puerto
Write effective CLAUDE.md project instruction files that give agents the right context to work in a repo.
About
claude-md is a skill for writing effective CLAUDE.md project instruction files. It helps developers craft the project context and guidance that agents read first, so Claude Code works with the right conventions and constraints.
- Writes CLAUDE.md files
- Effective project instructions
- Agent context
Claude Md by the numbers
- Data as of Jul 7, 2026 (Skillselion catalog sync)
/plugin marketplace add bandofai/puerto/plugin install claude-md@puertoAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| repo stars | ★ 3 |
|---|---|
| Last updated | November 29, 2025 |
| Repository | bandofai/puerto ↗ |
What it does
Write effective CLAUDE.md project instruction files that give agents the right context to work in a repo.
README.md
Claude.md
Create effective CLAUDE.md files that transform Claude Code from a general-purpose assistant into a project-specialized tool.
Installation
/plugin install claude-md@puerto
Features
- CLAUDE.md creation - Analyze codebases and generate optimized project instructions
- Quality auditing - Identify anti-patterns and fix token-wasting content
- Monorepo strategy - Hierarchical CLAUDE.md structure for large codebases
- Writing patterns - Concise, actionable documentation techniques
Usage
Create CLAUDE.md
"Create a CLAUDE.md for this project"
"Set up Claude Code configuration"
Audit Existing
"Audit my CLAUDE.md for quality"
"Optimize my project documentation for Claude"
Monorepo Setup
"Set up CLAUDE.md hierarchy for this monorepo"
"Optimize agent context for workspace packages"
Key Concepts
| Concept | Description |
|---|---|
| Golden Rule | Document what Claude gets wrong, not everything |
| Token Budget | Keep <500 lines, <15k tokens total |
| Hierarchy | Root + subdirectory files for monorepos |
| Iteration | Start minimal, expand based on friction |
License
MIT
Related skills
Lark MarkdownInstantly turn any markdown file into clean, formatted Lark/Figma-compatible documents without manual reformatting.488k
Lark DocCreate, read, update, summarize, rewrite and manage Feishu/Lark cloud documents directly from agent workflows.401k16.1kLark WikiCreate, organize, query, and manage documents, spaces, and members inside Lark (Feishu) knowledge bases directly from AI agent workflows.397k16.1k
Domain ModelingBuild and sharpen a project's domain model: pin down domain terminology in a glossary and record architectural decisions as ADRs.318k202k
Opensource Guide CoachGet expert, attribution-safe guidance on launching and sustaining an open-source project.270k71Readme I18nMaintain consistent, updatable language selector blocks across every README variant in a multilingual repository.270k71Documentationdocs