doc-generator
luongnv89/claude-howto / 03-skills/doc-generator
génère la doc d'API et OpenAPI depuis le code , ce qui améliore : docs à jour sans rédaction manuelle
note 4/10risque info42 k étoiles du dépôt
Fiche
- note du juge
- 4/10
- place
- hors pack
- éditeur
- luongnv89
- statut
- nouveau
- commit épinglé
- 188f468 sur GitHub (nouvel onglet)
- dernier commit du skill
- 4 août 2026
- étoiles du dépôt
- 42 021
- type principal
- Autre
Jugement
Déclenchement large (toute mention de « documentation »). Contenu surtout un gabarit de documentation générique, sans procédure vérifiable ni savoir-faire spécifique. Script annexe non relu.
réserves
- Le script annexe generate-docs.py n'est pas fourni : impossible de vérifier ce qu'il fait, alors que le scan signale des scripts embarqués.
- Le contenu est un gabarit générique (structure markdown, exemples) : peu de règles propres à Claude Code ou à un mainteneur.
- Aucune instruction de procédure concrète (quels fichiers lire, quels frameworks détecter, comment valider l'OpenAPI produit).
- Le déclenchement « when users mention documentation » est trop large et peut se chevaucher avec d'autres skills de documentation.
sous-notes
- Déclenchement
- 1/2
- Valeur ajoutée
- 0/2
- Précision
- 1/2
- Périmètre
- 1/2
- Qualité
- 1/2
Alertes
1 alerte, par catégorie
Scan statique
- risque info
scripts embarqués, que le SKILL.md ne lance pas
generate-docs.py
Description d’origine
Generate comprehensive, accurate API documentation from source code. Use when creating or updating API documentation, generating OpenAPI specs, or when users mention API docs, endpoints, or documentation.
ajouté le 19 oct. 2026 · licence MIT