Claude MD Generator

Skannar en kodbas och utarbetar en koncis CLAUDE.md med endast icke-uppenbara kommandon och fallgropar

av Varnan-Tech · Varnan-Tech/opendirectory

Fungerar med konfiguration ★ 8.4/10

Claude MD Generator — Skannar en kodbas och utarbetar en koncis CLAUDE.md med endast icke-uppenbara kommandon och fallgropar

Vad den gör

Skannar ett projekt (package.json, tsconfig, Makefile, .env.example, genererade filer) och utarbetar en fokuserad CLAUDE.md eller AGENTS-kontextfil som endast innehåller de icke-uppenbara byggkommandona, sökvägsalias och fallgropar som Claude inte kan härleda från koden. Utlöses när användaren ber att generera, uppdatera eller granska ett projekts CLAUDE.md/AGENTS-fil. Dess steg 6 för utkastgenerering anropar Google Gemini API och kräver en GEMINI_API_KEY.

Testrapport

Hämtade SKILL.md + alla refererade filer (section-guide.md, .env.example, evals.json alla HTTP 200); frontmatter parsas med name+description. Steg 6 anropar Gemini API direkt med $GEMINI_API_KEY (POST till generativelanguage.googleapis.com), som jag inte hade, så jag exekverade dess utkastregler direkt istället för API:et. Byggde ett syntetiskt billing-svc-projekt (vitest, drizzle, path aliases, en @generated fil, env-ordering-beroende) och producerade två CLAUDE.md-filer: baslinje (49 rader, redundant Tech Stack + npm install + inline snippet + vag Code Style, inga Gotchas, missade den genererade filen, aliasvärdena och DATABASE_URL-before-tests-ordningen) vs färdighetsregler (26 rader, konkreta @billing/@shared alias, flaggade src/schema.gen.ts:1 som genererad do-not-edit, fångade test-env-ordningen, inget utfyllnad). Domslut setup eftersom en vanlig installation verkligen behöver en Gemini API key för att köra Steg 6 som skrivet. Dokumentationsanmärkning: SKILL.md säger under 100 rader, README säger under 200.

Testad: 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

Kommandon och exempelprompter

/claude-md-generatorSkannar en kodbas och utarbetar en koncis CLAUDE.md med endast icke-uppenbara kommandon och fallgropar

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

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

Läs hela rapporten →