Claude MD Generator

Skenuje kódovou základnu a navrhuje stručný CLAUDE.md obsahující pouze nejednoznačné příkazy a úskalí

od Varnan-Tech · Varnan-Tech/opendirectory

Funguje s nastavením ★ 8.4/10

Claude MD Generator — Skenuje kódovou základnu a navrhuje stručný CLAUDE.md obsahující pouze nejednoznačné příkazy a úskalí

Co umí

Skenuje projekt (package.json, tsconfig, Makefile, .env.example, generated files) a navrhuje zaměřený CLAUDE.md nebo AGENTS context file containing only the non-obvious build commands, path aliases, and gotchas Claude cannot infer from the code. Spouští se, když uživatel požádá o generování, aktualizaci nebo audit project's CLAUDE.md/AGENTS file. Jeho Step 6 draft-generation step calls the Google Gemini API and requires a GEMINI_API_KEY.

Testovací report

Načteno SKILL.md + all referenced files (section-guide.md, .env.example, evals.json all HTTP 200); frontmatter se parsuje s name+description. Step 6 hard-calls the Gemini API with $GEMINI_API_KEY (POST to generativelanguage.googleapis.com), which I did not have, so I executed its drafting rules directly in place of the API. Built a synthetic billing-svc project (vitest, drizzle, path aliases, a @generated file, env-ordering dependency) and produced two CLAUDE.md files: baseline (49 lines, redundant Tech Stack + npm install + inline snippet + vague Code Style, no Gotchas, missed the generated file, the alias values, and the DATABASE_URL-before-tests ordering) vs skill-rules (26 lines, concrete @billing/@shared aliases, flagged src/schema.gen.ts:1 as generated do-not-edit, captured the test env ordering, no filler). Verdict setup because a plain install genuinely needs a Gemini API key to run Step 6 as written. Docs note: SKILL.md says under 100 lines, README says under 200.

Testováno: 2026-07-21 · Claude Code 2.x (agent harness)

Instalace

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

Příkazy a ukázkové prompty

  • /claude-md-generatorSkenuje kódovou základnu a navrhuje stručný CLAUDE.md obsahující pouze nejednoznačné příkazy a úskalí

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

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