Claude MD Generator

Skanuje bazę kodu i szkicuje zwięzły CLAUDE.md zawierający tylko nieoczywiste komendy i pułapki

Autor: Varnan-Tech · Varnan-Tech/opendirectory

Działa po konfiguracji ★ 8.4/10

Claude MD Generator — Skanuje bazę kodu i szkicuje zwięzły CLAUDE.md zawierający tylko nieoczywiste komendy i pułapki

Co robi ten skill

Skanuje projekt (package.json, tsconfig, Makefile, .env.example, generated files) i szkicuje skoncentrowany plik kontekstowy CLAUDE.md lub AGENTS zawierający tylko nieoczywiste komendy budowania, aliasy ścieżek i pułapki, których Claude nie może wywnioskować z kodu. Uruchamia się, gdy użytkownik prosi o wygenerowanie, aktualizację lub audyt pliku CLAUDE.md/AGENTS projektu. Jego krok 6 generowania szkicu wywołuje Google Gemini API i wymaga GEMINI_API_KEY.

Raport z testu

Pobrano SKILL.md + wszystkie referencyjne pliki (section-guide.md, .env.example, evals.json wszystkie HTTP 200); frontmatter parsował z name+description. Krok 6 bezpośrednio wywołuje Gemini API z $GEMINI_API_KEY (POST do generativelanguage.googleapis.com), którego nie miałem, więc wykonałem jego zasady szkicowania bezpośrednio zamiast API. Zbudowano syntetyczny projekt billing-svc (vitest, drizzle, path aliases, a @generated file, env-ordering dependency) i wyprodukowano dwa CLAUDE.md files: bazowy (49 linii, zbędny Tech Stack + npm install + wbudowany fragment + niejasny Code Style, brak Gotchas, pominięto wygenerowany plik, wartości aliasów i kolejność DATABASE_URL-before-tests) vs zgodny z zasadami umiejętności (26 linii, konkretne aliasy @billing/@shared, oznaczono src/schema.gen.ts:1 jako wygenerowany do-not-edit, przechwycono kolejność env testu, bez wypełniaczy). Werdykt konfiguracji, ponieważ zwykła instalacja naprawdę potrzebuje klucza API Gemini do uruchomienia Kroku 6 zgodnie z opisem. Uwaga w dokumentacji: SKILL.md mówi poniżej 100 linii, README mówi poniżej 200.

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

Instalacja

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

Komendy i przykładowe prompty

/claude-md-generatorSkanuje bazę kodu i szkicuje zwięzły CLAUDE.md zawierający tylko nieoczywiste komendy i pułapki

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

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

Pełny raport →