Claude Md Generator

Description

Reads your codebase and writes a CLAUDE.md file that gives Claude Code the context it needs: build commands, test patterns, code style, architecture notes, and gotchas. Supports three modes: create (new file), update (improve existing), audit (score all CLAUDE.md files A-F and report quality). Keeps output under 100 lines. Use when asked to create or improve CLAUDE.md, audit Claude configuratio...

What this skill does

1. 1Scans a codebase to extract build commands, test commands, import aliases, environment variables, and auto-generated files that Claude cannot infer from code alone.
2. 2Runs in three modes: create (new CLAUDE.md from scratch), update (improve without discarding existing content), and audit (score all CLAUDE.md files A-F across six criteria).
3. 3Generates a draft under 100 lines using Gemini, then presents it for approval before writing to disk.
4. 4Produces extended reference files in docs/ai-context/ for large projects where the 100-line limit would cut off important architecture notes.

When to use

• You are setting up a new repo for Claude Code and want a CLAUDE.md that gives it the right context without bloat.
• Your existing CLAUDE.md has stale commands or is over 100 lines and you want it cleaned up.
• You want to audit all CLAUDE.md files across a monorepo and get a graded quality report.
• A new contributor is asking Claude questions that a good CLAUDE.md would answer and the file does not exist yet.

Tools used

Frequently asked questions