Claude MD Generator

Escanea una base de código y redacta un CLAUDE.md conciso de solo comandos no obvios y gotchas.

Por Varnan-Tech · Varnan-Tech/opendirectory

Funciona con configuración ★ 8.4/10

Claude MD Generator — Escanea una base de código y redacta un CLAUDE.md conciso de solo comandos no obvios y gotchas.

Qué hace

Escanea un proyecto (package.json, tsconfig, Makefile, .env.example, generated files) y redacta un archivo de contexto CLAUDE.md o AGENTS enfocado que contiene solo los build commands no obvios, path aliases y gotchas que Claude no puede inferir del código. Se activa cuando el usuario pide generar, actualizar o auditar el archivo CLAUDE.md/AGENTS de un proyecto. Su Step 6 de draft-generation llama a la Google Gemini API y requiere una GEMINI_API_KEY.

Informe de la prueba

Se obtuvo SKILL.md + todos los archivos referenciados (section-guide.md, .env.example, evals.json todos HTTP 200); el frontmatter se analiza con name+description. El Step 6 llama directamente a la Gemini API con $GEMINI_API_KEY (POST a generativelanguage.googleapis.com), que no tenía, así que ejecuté sus reglas de redacción directamente en lugar de la API. Construí un proyecto sintético billing-svc (vitest, drizzle, path aliases, un archivo @generated, env-ordering dependency) y produje dos archivos CLAUDE.md: línea base (49 líneas, Tech Stack redundante + npm install + inline snippet + Code Style vago, sin Gotchas, omitió el archivo generado, los alias values y el orden DATABASE_URL-before-tests) vs skill-rules (26 líneas, alias @billing/@shared concretos, marcó src/schema.gen.ts:1 como generated do-not-edit, capturó el orden del test env, sin relleno). Veredicto setup porque una instalación simple realmente necesita una Gemini API key para ejecutar el Step 6 tal como está escrito. Nota de la documentación: SKILL.md dice menos de 100 líneas, README dice menos de 200.

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

Instalación

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

Comandos y prompts de ejemplo

  • /claude-md-generatorEscanea una base de código y redacta un CLAUDE.md conciso de solo comandos no obvios y gotchas.

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

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