Claude MD Generator

Scanner en kodebase og udarbejder en stram CLAUDE.md med kun ikke-indlysende kommandoer og faldgruber

Af Varnan-Tech · Varnan-Tech/opendirectory

Virker med opsætning ★ 8.4/10

Claude MD Generator — Scanner en kodebase og udarbejder en stram CLAUDE.md med kun ikke-indlysende kommandoer og faldgruber

Hvad det gør

Scanner et projekt (package.json, tsconfig, Makefile, .env.example, generated files) og udarbejder en fokuseret CLAUDE.md eller AGENTS kontekstfil, der kun indeholder de ikke-indlysende build-kommandoer, path aliases og faldgruber, Claude ikke kan udlede fra koden. Udløses når brugeren beder om at generere, opdatere eller auditere et projekts CLAUDE.md/AGENTS fil. Dets Step 6 udkast-genereringstrin kalder Google Gemini API og kræver en GEMINI_API_KEY.

Testrapport

Hentede SKILL.md + alle refererede filer (section-guide.md, .env.example, evals.json alle HTTP 200); frontmatter parses med name+description. Step 6 hard-calls Gemini API med $GEMINI_API_KEY (POST til generativelanguage.googleapis.com), som jeg ikke havde, så jeg udførte dens udkastregler direkte i stedet for API'en. Byggede et syntetisk billing-svc projekt (vitest, drizzle, path aliases, en @generated fil, env-ordering dependency) og producerede to CLAUDE.md filer: baseline (49 linjer, redundant Tech Stack + npm install + inline snippet + vag Code Style, ingen Gotchas, missede den genererede fil, alias-værdierne og DATABASE_URL-before-tests rækkefølgen) vs skill-rules (26 linjer, konkrete @billing/@shared aliases, markerede src/schema.gen.ts:1 som generated do-not-edit, fangede test env rækkefølgen, ingen fyld). Dom opsætning, fordi en almindelig installation virkelig kræver en Gemini API key for at køre Step 6 som skrevet. Docs note: SKILL.md siger under 100 linjer, README siger under 200.

Testet: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

git clone --depth 1 https://github.com/Varnan-Tech/opendirectory.git /tmp/claude-md-generator-src
mkdir -p ~/.claude/skills
cp -R /tmp/claude-md-generator-src/skills/claude-md-generator ~/.claude/skills/claude-md-generator
# Requires a Gemini API key for Step 6 (draft generation):
#   export GEMINI_API_KEY=...   (get one at aistudio.google.com)
# The skill POSTs the compiled project analysis to generativelanguage.googleapis.com.
# Alt install (npx CLI): npx "@opendirectory.dev/skills" install claude-md-generator --target claude
# Alt install (marketplace): /plugin marketplace add Varnan-Tech/opendirectory ; /plugin install opendirectory-gtm-skills@opendirectory-marketplace

Kommandoer og eksempelprompter

  • /claude-md-generatorScanner en kodebase og udarbejder en stram CLAUDE.md med kun ikke-indlysende kommandoer og faldgruber

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

  • Generate a CLAUDE.md for this repository
  • Update AGENTS.md from a fresh codebase scan
  • Write a concise context file with our build commands