Claude MD Generator

Scanne une base de code et rédige un CLAUDE.md concis ne contenant que les commandes non évidentes et les pièges

par Varnan-Tech · Varnan-Tech/opendirectory

Fonctionne avec configuration ★ 8.4/10

Claude MD Generator — Scanne une base de code et rédige un CLAUDE.md concis ne contenant que les commandes non évidentes et les pièges

Ce que fait

Scanne un projet (package.json, tsconfig, Makefile, .env.example, fichiers générés) et rédige un fichier de contexte CLAUDE.md ou AGENTS ciblé ne contenant que les commandes de build non évidentes, les alias de chemin et les pièges que Claude ne peut pas déduire du code. Se déclenche lorsque l'utilisateur demande de générer, mettre à jour ou auditer le fichier CLAUDE.md/AGENTS d'un projet. Son étape 6 de génération de brouillon appelle l'API Google Gemini et nécessite une GEMINI_API_KEY.

Rapport de test

SKILL.md + tous les fichiers référencés (section-guide.md, .env.example, evals.json tous HTTP 200) récupérés ; le frontmatter est analysé avec name+description. L'étape 6 appelle directement l'API Gemini avec $GEMINI_API_KEY (POST vers generativelanguage.googleapis.com), que je n'avais pas, j'ai donc exécuté ses règles de rédaction directement à la place de l'API. Construit un projet billing-svc synthétique (vitest, drizzle, alias de chemin, un fichier @generated, dépendance d'ordre d'environnement) et produit deux fichiers CLAUDE.md : base de référence (49 lignes, Tech Stack redondant + npm install + extrait en ligne + Code Style vague, pas de pièges, a manqué le fichier généré, les valeurs d'alias et l'ordre DATABASE_URL-avant-tests) vs règles de compétence (26 lignes, alias concrets @billing/@shared, a signalé src/schema.gen.ts:1 comme généré à ne pas modifier, a capturé l'ordre de l'environnement de test, pas de remplissage). Verdict configuré car une installation simple nécessite réellement une clé API Gemini pour exécuter l'étape 6 telle qu'écrite. Note de la documentation : SKILL.md indique moins de 100 lignes, README indique moins de 200.

Testé le: 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

Commandes et exemples de prompts

/claude-md-generatorScanne une base de code et rédige un CLAUDE.md concis ne contenant que les commandes non évidentes et les pièges

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

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

Rapport complet →