Claude MD Generator

Skanner en kodebase og utarbeider en konsis CLAUDE.md med kun ikke-åpenbare kommandoer og fallgruver

av Varnan-Tech · Varnan-Tech/opendirectory

Krever oppsett ★ 8.4/10

Claude MD Generator — Skanner en kodebase og utarbeider en konsis CLAUDE.md med kun ikke-åpenbare kommandoer og fallgruver

Hva den gjør

Skanner et prosjekt (package.json, tsconfig, Makefile, .env.example, genererte filer) og utarbeider en fokusert CLAUDE.md eller AGENTS kontekstfil som kun inneholder de ikke-åpenbare byggekommandoene, stialiasene og fallgruvene Claude ikke kan utlede fra koden. Utløses når brukeren ber om å generere, oppdatere eller revidere et prosjekts CLAUDE.md/AGENTS-fil. Dets trinn 6 utkastgenereringstrinn kaller Google Gemini API og krever en GEMINI_API_KEY.

Testrapport

Hentet SKILL.md + alle refererte filer (section-guide.md, .env.example, evals.json alle HTTP 200); frontmatter parses med name+description. Trinn 6 kaller hardt Gemini API med $GEMINI_API_KEY (POST til generativelanguage.googleapis.com), som jeg ikke hadde, så jeg utførte utkastreglene direkte i stedet for API-en. Bygde et syntetisk billing-svc-prosjekt (vitest, drizzle, path aliases, en @generated fil, env-ordering avhengighet) og produserte to CLAUDE.md-filer: baseline (49 linjer, redundant Tech Stack + npm install + inline snippet + vag Code Style, ingen Gotchas, savnet den genererte filen, aliasverdiene og DATABASE_URL-før-tester-rekkefølgen) vs skill-rules (26 linjer, konkrete @billing/@shared aliasser, flagget src/schema.gen.ts:1 som generert do-not-edit, fanget test-env-rekkefølgen, ingen fyllstoff). Dommen ble satt opp fordi en vanlig installasjon genuint trenger en Gemini API key for å kjøre Trinn 6 som skrevet. Dokumentasjonsmerknad: SKILL.md sier under 100 linjer, README sier under 200.

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

Installer

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-generatorSkanner en kodebase og utarbeider en konsis CLAUDE.md med kun ikke-åpenbare kommandoer og fallgruver

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen 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