Claude MD Generator

Scannt eine Codebasis und entwirft eine prägnante CLAUDE.md nur mit nicht-offensichtlichen Befehlen und Fallstricken

von Varnan-Tech · Varnan-Tech/opendirectory

Funktioniert mit Setup ★ 8.4/10

Claude MD Generator — Scannt eine Codebasis und entwirft eine prägnante CLAUDE.md nur mit nicht-offensichtlichen Befehlen und Fallstricken

Was es kann

Scannt ein Projekt (package.json, tsconfig, Makefile, .env.example, generierte Dateien) und entwirft eine fokussierte CLAUDE.md- oder AGENTS-Kontextdatei, die nur die nicht-offensichtlichen Build-Befehle, Pfad-Aliase und Fallstricke enthält, die Claude nicht aus dem Code ableiten kann. Wird ausgelöst, wenn der Benutzer darum bittet, die CLAUDE.md-/AGENTS-Datei eines Projekts zu generieren, zu aktualisieren oder zu prüfen. Sein Schritt 6 zur Entwurfserstellung ruft die Google Gemini API auf und erfordert einen GEMINI_API_KEY.

Testbericht

SKILL.md + alle referenzierten Dateien (section-guide.md, .env.example, evals.json alle HTTP 200) abgerufen; Frontmatter wird mit name+description geparst. Schritt 6 ruft die Gemini API mit $GEMINI_API_KEY hart auf (POST an generativelanguage.googleapis.com), den ich nicht hatte, daher habe ich die Entwurfsregeln direkt anstelle der API ausgeführt. Ein synthetisches billing-svc-Projekt (vitest, drizzle, Pfad-Aliase, eine @generated-Datei, env-ordering-Abhängigkeit) erstellt und zwei CLAUDE.md-Dateien produziert: Baseline (49 Zeilen, redundanter Tech Stack + npm install + Inline-Snippet + vager Code Style, keine Gotchas, verpasste die generierte Datei, die Alias-Werte und die DATABASE_URL-vor-Tests-Reihenfolge) vs. Skill-Regeln (26 Zeilen, konkrete @billing/@shared-Aliase, markierte src/schema.gen.ts:1 als generiert do-not-edit, erfasste die Test-Env-Reihenfolge, kein Füllmaterial). Urteil Setup, da eine einfache Installation tatsächlich einen Gemini API-Schlüssel benötigt, um Schritt 6 wie geschrieben auszuführen. Docs-Hinweis: SKILL.md sagt unter 100 Zeilen, README sagt unter 200.

Getestet am: 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

Befehle & Beispiel-Prompts

/claude-md-generatorScannt eine Codebasis und entwirft eine prägnante CLAUDE.md nur mit nicht-offensichtlichen Befehlen und Fallstricken

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

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

Vollständiger Testbericht (Englisch) →