SkillProof tested Claude skills

API Documentation Generator

Documenta le rotte API esistenti in markdown/OpenAPI; non crea scheletri di codice per nuovi endpoint.

di huangjia2019 · huangjia2019/claude-code-engineering

Richiede configurazione ★ 8.0/10

API Documentation Generator — Documenta le rotte API esistenti in markdown/OpenAPI; non crea scheletri di codice per nuovi endpoint.

Cosa fa

Scansiona i gestori di rotta esistenti (Express, FastAPI, Spring Boot, Go) per metodo, percorso, parametri e autenticazione, quindi compila un template endpoint.md incluso in documentazione markdown o specifica OpenAPI 3.0; distribuisce uno scanner reale detect_routes.py e un verificatore validate_openapi.sh che entrambi vengono eseguiti autonomamente. Il suo frontmatter si auto-promuove troppo: dice 'usare quando l'utente vuole creare nuovi endpoint API, generare gestori di rotta, creare scheletri di API REST', ma il corpo documenta solo endpoint che esistono già — non c'è alcun passaggio di generazione di codice. I template inclusi/openapi.yaml non sono nemmeno YAML valido così come distribuiti; i suoi token {PLACEHOLDER} sono letterali, quindi il suo stesso validatore li rifiuta finché non li compili.

Rapporto di test

Eseguiti gli script inclusi per davvero: detect_routes.py ha trovato correttamente tutte e 4 le rotte in due file di test, ma validate_openapi.sh si è bloccato sul template/openapi.yaml dell'abilità stessa — i suoi token {PLACEHOLDER} sono chiavi di mapping di flusso YAML non valide, quindi il template incluso fallisce il validatore incluso finché non lo compili manualmente prima. (Elencato qui con il nostro vecchio nome; il nome dell'abilità stessa è "API Documentation Generator".)

Testato il: 2026-07-14 · Claude Code 2.x (agent harness)

Installazione

git clone https://github.com/huangjia2019/claude-code-engineering
cd claude-code-engineering
mkdir -p ~/.claude/skills
cp -r 04-Skills/projects/05-api-generator ~/.claude/skills/api-docs-generator

Comandi e prompt di esempio

  • /api-docs-generatorDocumenta le rotte API esistenti in markdown/OpenAPI; non crea scheletri di codice per nuovi endpoint.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • Generate reference docs from these route handlers
  • Document this API's endpoints from the schema files
  • Produce endpoint documentation for my REST API code

Rapporto completo →