Our review
Generates or updates documentation for a feature being developed, ensuring cross-linking and updating the main README.
Strengths
- Automates creation of consistent, structured Markdown documentation.
- Identifies and updates related documents, avoiding orphaned docs.
- Integrates with Git to extract feature context and changes.
- Generates a clear report of modifications made.
Limitations
- Depends on a predefined documentation directory structure (e.g., docs/).
- May not handle very large or unconventional project layouts without customization.
- Generated examples may require manual verification for correctness.
When adding a new feature or making significant changes that require documentation to keep the project up to date.
When only minor changes are made that do not warrant full documentation updates, or when the project explicitly discourages automated documentation.
Security analysis
SafeThe skill performs only documentation generation and updating tasks using standard tools (git, file read/write) with no destructive commands, exfiltration, or obfuscation.
No concerns found
Examples
Generate documentation for the user authentication feature I just implemented. Use the standard docs directory and update the README if needed.I've refactored the payment processing module. Please update its documentation and check if any related documents need to be linked.Document the new /api/v2/orders endpoint. Ensure the README and related docs are updated and linked.name: doc:update description: Crées la documentation pour la fonctionnalité en cours. Mets à jour le readme global du projet si nécessaire. Lie les documents entre eux pour ne pas avoir de documentation orpheline. La documentation est générée dans les répertoire de documentation du projet. model: sonnet allowed-tools: [Bash, Read, Write, Edit, Glob, Grep] version: 1.0.0 license: MIT
Documentation de fonctionnalité
Instructions à Exécuter
IMPORTANT : Exécute ce workflow étape par étape :
Génère ou met à jour la documentation pour la fonctionnalité en cours de développement, en s'assurant que tous les documents sont liés et que le README principal est à jour.
Purpose
Maintenir une documentation cohérente, à jour et bien interconnectée pour le projet.
Variables
- CURRENT_BRANCH: Branche Git en cours
- DOC_DIR: Répertoire de documentation du projet (détection automatique)
- README_PATH: Chemin vers le README principal du projet
- FEATURE_NAME: Nom de la fonctionnalité extraite de la branche et des modifications
Relevant Files
README.md- Documentation principale du projetdocs/- Répertoire de documentation standard- Fichiers source de la fonctionnalité
- Fichiers de tests associés
Workflow
1. Analyse du contexte
- Identifie la branche Git en cours (git branch --show-current)
- Analyse les modifications de la branche :
- Fichiers modifiés (git status)
- Diff par rapport à main/master (git diff)
- Commits de la branche (git log)
- Extrait le nom de la fonctionnalité depuis :
- Le nom de la branche (ex: feature/user-auth → User Authentication)
- Les commits de la branche
- Les prompts récents de la session
- Détermine le répertoire de documentation :
- Cherche
docs/,documentation/, ou équivalent - Crée le répertoire si nécessaire
- Cherche
- Identifie les informations clés :
- Fichiers principaux modifiés
- Tests associés
- Dépendances ajoutées/modifiées
2. Génération de la documentation
- Crée ou met à jour le fichier de documentation :
- Titre et description claire
- Utilisation et exemples
- Architecture et composants
- Configuration nécessaire
- Tests et validation
- Limitations et notes
- Format Markdown structuré avec :
- Table des matières si nécessaire
- Blocs de code avec syntaxe
- Liens vers fichiers sources
- Exemples d'utilisation concrets
3. Mise à jour du README principal
- Vérifie si la fonctionnalité doit être mentionnée dans le README
- Ajoute ou met à jour la section appropriée :
- Fonctionnalités principales
- Structure du projet
- Documentation disponible
- Maintient la cohérence du format existant
- Préserve l'ordre et la hiérarchie
4. Liaison des documents
- Identifie les documents connexes :
- Documentation de fonctionnalités liées
- Guides d'architecture
- Tutoriels
- ADRs (Architecture Decision Records)
- Ajoute des liens bidirectionnels :
- Depuis le nouveau document vers les connexes
- Depuis les connexes vers le nouveau document
- Vérifie l'absence de liens cassés
- Crée un index si nécessaire pour les projets volumineux
5. Validation et rapport
- Vérifie la qualité de la documentation :
- Tous les exemples sont fonctionnels
- Les liens sont valides
- Le formatage Markdown est correct
- Pas de typos évidentes
- Génère un rapport de ce qui a été créé/modifié
Report
Affiche un résumé structuré :
Documentation générée :
- Fonctionnalité : [NOM]
- Fichier créé/modifié : [CHEMIN]
- Taille : [LIGNES] lignes
Modifications README :
- Section modifiée : [SECTION]
- Ajouts : [DESCRIPTION]
Liens créés :
- [DOC1] ↔ [DOC2]
- [DOC3] ↔ [DOC4]
Documents liés :
- [LISTE DES DOCS CONNEXES]
Best Practices
- Documentation focalisée sur l'utilisation, pas l'implémentation
- Exemples concrets et testés
- Langage clair et concis (style bullet points)
- Liens relatifs pour la portabilité
- Pas de duplication entre README et docs détaillées
- README = vue d'ensemble, docs/ = détails
- Maintenir la cohérence du ton et du format
API Documentation Generator
Documentation
Automatically generates OpenAPI/Swagger API documentation.
Technical Writer
Documentation
Writes clear technical documentation following top style guides.
Typed Documentation Forms System
Documentation
Add typed comments, documentation, todos, and metadata to Scheme code using `(doc ...)` forms. Doc annotations are authoritative for type inference, extracted by search commands (lf-todo, lf-types), and integrated with the type checker and LSP. Useful for annotating functions, marking deprecations, or tracking localized improvements alongside the code.