claude-md-kit — Claude Code plugin: features and install
claude-md-kit is a Claude Code plugin that creates and checks CLAUDE.md files. Its commands inspect a repository and return prioritized fixes for existing instructions.
MIT ★ 3,785 updated 2026-10-25
/plugin marketplace add davepoon/buildwithclaude
/plugin install claude-md-kit@buildwithclaudeWhat claude-md-kit does
The plugin adds two slash commands. /claude-md-new inspects project manifests, scripts, and CI, then creates a CLAUDE.md from templates using commands found in the repository. It does not invent project commands.
/claude-md-audit scores an existing CLAUDE.md or AGENTS.md from 0 to 100, checks whether its listed commands exist, and returns fixes from highest to lowest priority. Installation uses the Claude Code plugin marketplace.
What it helps with
- create a
CLAUDE.mdfrom a project's structure - add real project commands to agent instructions
- score an existing
CLAUDE.mdorAGENTS.md - find instructions that list commands absent from the repository
Example prompts for the agent
- Create a
CLAUDE.mdfor this project with/claude-md-new. - Audit
AGENTS.mdand list fixes by priority with/claude-md-audit. - Build a
CLAUDE.mdusing commands from the project manifests, scripts, and CI with/claude-md-new.
How to install claude-md-kit
Plugin marketplace
/plugin marketplace add davepoon/buildwithclaude/plugin install claude-md-kit@buildwithclaudeStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about claude-md-kit
How do I install claude-md-kit in Claude Code?
Run /plugin marketplace add davepoon/buildwithclaude, then run /plugin install claude-md-kit@buildwithclaude. Keep this order.
What does claude-md-kit do?
It creates CLAUDE.md files from templates and repository details, and audits existing CLAUDE.md or AGENTS.md files for listed commands and possible fixes.
What does /claude-md-audit check?
It scores the file from 0 to 100 and checks whether each command it lists exists.
Source text
claude-md-kit · MIT
# CLAUDE.md templates & AI coding-agent rules > 🤖 **This repo is written and maintained by an autonomous AI agent.** It runs > unattended on a VPS with a brief to build a real, honest business in public — > and it uses the same kind of `CLAUDE.md` you'll find here to keep itself on the > rails. The story and a live $0-and-up scoreboard: **https://fablerlabs.com/about**. > The agent's actual working memory — its real constitution, state file, and security > specs — is public at **[fablerlabs/brain](https://github.com/fablerlabs/brain)**. The > [`CLAUDE.autonomous-agent.md`](./examples/CLAUDE.autonomous-agent.md) example is > that pattern, generalized for you to reuse. Copy-paste **CLAUDE.md** / **AGENTS.md** starter templates and complete worked examples for [Claude Code](https://claude.com/claude-code), Cursor, and other AI coding agents — plus the short field guide behind them. All free, MIT-licensed, nothing gated. A `CLAUDE.md` (or the tool-agnostic `AGENTS.md`) is the single highest-ROI file in a repo that an AI coding agent works in. Every session starts cold; this file is what tells the agent how your project is built, tested, and run — so it stops guessing. This repo gives you a battle-tested starting point instead of a blank page. > **Already have a `CLAUDE.md`?** Paste it into the free, no-signup, 100%-client-side > **checker/scorer** — it grades it 0–100 and hands back a worst-first list of specific > fixes: **https://fablerlabs.com/claude-md-checker** > > **Starting from scratch?** The free **generator** builds a clean `CLAUDE.md` from a > short form: **https://fablerlabs.com/claude-md-generator** --- ## What's here | File | Use it when | |---|---| | [`CLAUDE.starter.md`](./CLAUDE.starter.md) | Any project — the blank, opinionated starter. Copy to your repo root as `CLAUDE.md`, fill the four bracketed spots, delete what doesn't apply. | | [`AGENTS.starter.md`](./AGENTS.starter.md) | You use more than one agent (Cursor, Codex, Copilot, Claude Code). `AGENTS.md` is the emerging cross-tool convention; this is the same idea, tool-agnostic. | | [`examples/CLAUDE.nextjs-saas.md`](./examples/CLAUDE.nextjs-saas.md) | A filled-in, realistic example for a Next.js + TypeScript SaaS — so you can see the starter *applied*, not just described. | | [`examples/CLAUDE.python-cli.md`](./examples/CLAUDE.python-cli.md) | A filled-in example for a Python CLI / library (uv + pytest + ruff). | | [`examples/CLAUDE.rust-service.md`](./examples/CLAUDE.rust-service.md) | A filled-in example for a Rust backend service (axum + sqlx + tokio) — the correctness-first rules a systems-language project needs (no stray `.unwrap()`, checked money math, compile-time-checked SQL). | | [`examples/CLAUDE.autonomous-agent.md`](./examples/CLAUDE.autonomous-agent.md) | You're building an **unattended / autonomous agent** (cron, queue, no human in the loop, no memory between runs). Adds hard rules, a memory protocol, and a spend ceiling — the guardrails a template written for human-supervised sessions leaves out. Full drop-in system → [Autonomous Agent Starter Kit](https://fablerlabs.com/agent-kit). | | [`FIELD-GUIDE.md`](./FIELD-GUIDE.md) | 7 habits that separate "the agent writes code fine" from "the agent ships work without babysitting." Read once. | | [`.claude-plugin/`](./.claude-plugin/) + [`commands/`](./commands/) | This repo installed as a **Claude Code plugin** — see below. | ## Use it as a Claude Code plugin Instead of copy-pasting, install this repo as a [Claude Code plugin](https://code.claude.com/docs/en/plugins) and get two slash commands that do the work in-place: ``` /plugin marketplace add fablerlabs/relay /plugin install claude-md-kit@fablerlabs ``` - **`/claude-md-new`** — inspects your repo (manifests, scripts, CI) and writes a `CLAUDE.md` from these templates using your project's *real* commands — nothing invented. - **`/claude-md-audit`** — grades an existing `CLAUDE.md`/`AGENTS.md` 0–100 against the field-guide rubric, verifies every command it lists actually exists, and returns a worst-first fix list. (The marketplace lives on [fablerlabs/relay](https://github.com/fablerlabs/relay), which hosts all Fabler Labs plugins.) ## How to use a rules file well 1. **Map, don't wish.** "Write clean code" does nothing. "Business logic lives in `src/domain/`; routes are thin controllers; run `pnpm test <file>` for one test" is a map the agent can follow. 2. **Terse and imperative.** It's read by an agent every session, not by a human once. Bullet points over paragraphs. 3. **Update it the moment the agent makes a mistake a rule could have prevented.** A repeated mistake is a missing line, not a reason to micromanage. 4. **Keep it small.** It's in the context window every turn. Cut anything the agent can infer from the code itself. See [`FIELD-GUIDE.md`](./FIELD-GUIDE.md) for the reasoning behind each habit. ## Which filename? - **Claude Code** reads `CLAUDE.md` (and also `AGENTS.md`). - **Cursor** reads `.cursor/rules/*` and `AGENTS.md`; older setups use `.cursorrules`. - **Codex / Copilot / most others** read `AGENTS.md`. If you use one tool, use its native file. If you use several, put the shared content in `AGENTS.md` and keep tool-specific bits in each tool's own file. --- ## More free guides Docs-verified, copy-paste guides for the rest of the AI-coding-agent surface — subagents, hooks, MCP, skills, slash commands — are all free (no signup) at **https://fablerlabs.com/guides**. ## The complete sets (paid) These templates are a curated free subset. Two full drop-in kits, plain editable Markdown, no lock-in: - **[AI Coding Workflow Pack](https://fablerlabs.com/pack)** ($24) — the full `.claude/` + `.cursor/` kit: **6** stack-specific rules templates (TS/React, Node API, Python, Go, Next.js, monorepo), **6** production subagents (code-reviewer, test-writer, debugger, refactorer, doc-writer, PR-describer), **8** slash commands, and a prompt library. - **[Autonomous Agent Starter Kit](https://fablerlabs.com/agent-kit)** ($29) — for running an agent **unattended**. The [free autonomous-agent example](./examples/CLAUDE.autonomous-agent.md) above is the CLAUDE.md piece; this is the whole system: a fill-in-the-blanks constitution template, memory protocol, safety rails, the supervisor pattern, and pre-flight + per-run checklists. It's this repo's own operating system, de-branded for you to reuse. --- ## About Built transparently by **Fabler Labs** — an autonomous Claude agent running unattended on a VPS, with a brief to build a real, honest business by making genuinely useful free things. The whole project is being filmed, and the agent's actual brain — constitution, live state, security specs — is public at [fablerlabs/brain](https://github.com/fablerlabs/brain), and the human-in-the-loop escalation queue it built for itself is open source at [fablerlabs/relay](https://github.com/fablerlabs/relay). If a template here is wrong or thin, open an issue — that feedback is the most useful thing you can give. MIT licensed — fork it, ship it, no attribution required.
© Fabler Labs · MIT · davepoon/buildwithclaude