Claude MD Generator

Scant een codebase en stelt een beknopte CLAUDE.md op met alleen niet-voor de hand liggende commando's en valkuilen

Door Varnan-Tech · Varnan-Tech/opendirectory

Werkt met setup ★ 8.4/10

Claude MD Generator — Scant een codebase en stelt een beknopte CLAUDE.md op met alleen niet-voor de hand liggende commando's en valkuilen

Wat het doet

Scant een project (package.json, tsconfig, Makefile, .env.example, gegenereerde bestanden) en stelt een gerichte CLAUDE.md of AGENTS contextbestand op dat alleen de niet-voor de hand liggende build-commando's, padaliassen en valkuilen bevat die Claude niet uit de code kan afleiden. Activeert wanneer de gebruiker vraagt om een CLAUDE.md/AGENTS-bestand van een project te genereren, bij te werken of te controleren. De Step 6 draft-generation stap roept de Google Gemini API aan en vereist een GEMINI_API_KEY.

Testrapport

SKILL.md + alle genoemde bestanden (section-guide.md, .env.example, evals.json allemaal HTTP 200) opgehaald; frontmatter parseert met naam+beschrijving. Stap 6 roept hard de Gemini API aan met $GEMINI_API_KEY (POST naar generativelanguage.googleapis.com), die ik niet had, dus ik heb de opstelregels direct uitgevoerd in plaats van de API. Een synthetisch billing-svc project gebouwd (vitest, drizzle, padaliassen, een @generated bestand, env-ordering afhankelijkheid) en twee CLAUDE.md bestanden geproduceerd: basislijn (49 regels, redundante Tech Stack + npm install + inline snippet + vage Code Style, geen Gotchas, miste het gegenereerde bestand, de aliaswaarden en de DATABASE_URL-voor-tests volgorde) versus skill-rules (26 regels, concrete @billing/@shared aliassen, markeerde src/schema.gen.ts:1 als gegenereerd do-not-edit, legde de test env volgorde vast, geen opvulling). Verdict setup omdat een gewone installatie echt een Gemini API key nodig heeft om Stap 6 uit te voeren zoals geschreven. Docs opmerking: SKILL.md zegt minder dan 100 regels, README zegt minder dan 200.

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

Installatie

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

Commando's en voorbeeldprompts

/claude-md-generatorScant een codebase en stelt een beknopte CLAUDE.md op met alleen niet-voor de hand liggende commando's en valkuilen

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

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

Volledig rapport (Engels) →