Claude MD Generator

Scansiona una codebase e redige un CLAUDE.md conciso con solo comandi non ovvi e insidie.

di Varnan-Tech · Varnan-Tech/opendirectory

Richiede configurazione ★ 8.4/10

Claude MD Generator — Scansiona una codebase e redige un CLAUDE.md conciso con solo comandi non ovvi e insidie.

Cosa fa

Scansiona un progetto (package.json, tsconfig, Makefile, .env.example, file generati) e redige un file di contesto CLAUDE.md o AGENTS focalizzato contenente solo i comandi di build non ovvi, gli alias di percorso e le insidie che Claude non può inferire dal codice. Si attiva quando l'utente chiede di generare, aggiornare o controllare il file CLAUDE.md/AGENTS di un progetto. Il suo Step 6 di generazione bozza chiama la Google Gemini API e richiede una GEMINI_API_KEY.

Rapporto di test

Recuperato SKILL.md + tutti i file di riferimento (section-guide.md, .env.example, evals.json tutti HTTP 200); il frontmatter si analizza con name+description. Lo Step 6 chiama direttamente la Gemini API con $GEMINI_API_KEY (POST a generativelanguage.googleapis.com), che non avevo, quindi ho eseguito le sue regole di redazione direttamente al posto dell'API. Ho costruito un progetto sintetico billing-svc (vitest, drizzle, path aliases, un file @generated, dipendenza di ordinamento env) e ho prodotto due CLAUDE.md files: baseline (49 righe, Tech Stack ridondante + npm install + snippet inline + Code Style vago, nessun Gotchas, ha mancato il file generato, i valori degli alias e l'ordinamento DATABASE_URL-before-tests) vs skill-rules (26 righe, alias concreti @billing/@shared, ha contrassegnato src/schema.gen.ts:1 come generato do-not-edit, ha catturato l'ordinamento dell'ambiente di test, nessun riempitivo). Verdetto setup perché un'installazione semplice richiede realmente una Gemini API key per eseguire lo Step 6 come scritto. Nota della documentazione: SKILL.md dice meno di 100 righe, README dice meno di 200.

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

Installazione

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

Comandi e prompt di esempio

/claude-md-generatorScansiona una codebase e redige un CLAUDE.md conciso con solo comandi non ovvi e insidie.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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

Rapporto completo →