Meilleurs skills pour : Documentation automatique

Documentation

Ce skill guide la structuration de la documentation Ark selon le framework Diataxis (Tutoriels, Guides pratiques, Concepts fondamentaux, Référence). Il aide à décider où placer chaque contenu, à réviser les PR de documentation et à restructurer une documentation existante. Idéal pour créer des docs cohérentes adaptées aux besoins des développeurs, contributeurs et opérateurs.

Documentation

Permet d'enrichir les sections de documentation trop succintes qui ne présentent qu'une signature et un exemple trivial sans expliquer pourquoi utiliser l'API. Fournit un modèle d'expansion en cinq parties pour ajouter motivation, contraste avec les alternatives et exemple réaliste, afin que les lecteurs comprennent quand et pourquoi choisir cette API.

Documentation

Génère la documentation d'API, les fichiers README et met à jour les docstrings. Suit des normes comme Google, NumPy ou Sphinx. Utile pour maintenir une documentation claire, concise et à jour du code.

Documentation

Fournit des bonnes pratiques et des modèles pour différents types de documentation : README, références API, commentaires de code et diagrammes d'architecture. Aide à maintenir la cohérence et la clarté lors de la création ou l'amélioration de la documentation de projet, notamment pour les projets open source ou les API.

Documentation

Guide la recherche et la récupération de documentation technique officielle, de références d'API et de patterns d'implémentation. Utilisé pour explorer des frameworks inconnus, des besoins de version spécifique ou des bonnes pratiques lors de décisions techniques.

Documentation

Synchronise la documentation anglaise (README.md) et chinoise (README_ZH.md) en traduisant les sections nouvelles ou modifiées entre les deux fichiers. Préserve les blocs de code, le formatage et la cohérence des termes techniques. Utile pour maintenir une documentation bilingue dans des projets multilingues.

Documentation

Scanne les métadonnées YAML de tous les fichiers markdown dans le dossier docs/ pour fournir un aperçu structuré de la documentation disponible, sans charger le contenu complet. Utilisez ceci en début de session ou pour identifier rapidement les spécifications, plans et contextes pertinents.

Documentation

Cette compétence propose un workflow structuré pour mettre à jour la documentation du projet, notamment CLAUDE.md, README et CHANGELOG. Elle guide à travers des phases comme l'inventaire des documents existants, l'analyse de l'historique Git pour identifier les changements nécessaires, l'optimisation pour la lisibilité par l'IA et la cohérence entre les documents. À utiliser lors de la synchronisation de la documentation avec les modifications de code ou pour améliorer l'efficacité de la documentation pour les agents de codage IA.

Documentation

Rédige une documentation KDoc concise pour les classes et fonctions Kotlin, avec des résumés courts sans métadonnées ni documentation de variables. Utile lors de l'ajout de KDoc à des fichiers Kotlin en suivant des règles qui excluent les membres privés ou évidents.

Documentation

Automatise la génération parallèle de documentation technique (API, code, README, architecture, guides) en orchestrant des agents spécialisés. Utile pour produire rapidement une documentation complète et cohérente sur de larges bases de code.

Documentation

Génère une documentation complète de projet incluant des fichiers README, des documentations d'API (OpenAPI/Swagger), des commentaires de code avec docstrings appropriées (Python, JSDoc), des vues d'architecture et des journaux de modifications. Utile pour créer une nouvelle documentation à partir de zéro ou améliorer la documentation existante afin d'assurer la clarté et la cohérence des projets.

Documentation

Met à jour le fichier CHANGELOG.md en remplaçant la section [Unreleased] par la version actuelle du plugin et la date, puis ajoute une nouvelle section [Unreleased] vide. Utilisez-le lors de la finalisation d'une version pour préparer les entrées du journal des modifications.

Documentation

Génère ou met à jour des entrées de changelog axées sur l'impact métier en analysant les différences de fichiers via git diff. Utile pour préparer des notes de version, suivre l'historique des modifications et regrouper les changements par module ou fonctionnalité.

Documentation

Maintenez la documentation d'intégration GCP lors de modifications touchant la configuration Google Cloud, OAuth, Secret Manager, Cloud Run ou les variables d'environnement.

Documentation

Met à jour l'ensemble de la documentation du projet après des modifications de code. Analyse les changements via git, met à jour les fichiers KNOWLEDGE_BASE.md, README.md et leur version chinoise, puis vérifie l'intégrité des modifications.

Documentation

Cette compétence permet de créer, mettre à jour et réviser la documentation en markdown pour Turbot Guardrails. Elle s'applique à des tâches comme la rédaction de nouvelles pages, l'ajout de captures d'écran, la correction de liens et la vérification de la conformité au style. Elle est utile lorsque vous travaillez dans le répertoire docs/ ou que vous suivez les directives de style du projet.

Documentation

Résume les résultats d’une exploration technique ou de conception limitée dans le temps (spike) pour réduire l’incertitude avant des décisions d’implémentation. Ce document capture la question posée, l’approche suivie, les preuves recueillies et des recommandations claires, permettant à l’équipe d’agir sans répétitions. À utiliser après un spike pour éclairer les choix technologiques, les études de faisabilité ou les preuves de concept.

Documentation

Génère ou met à jour la documentation pour la fonctionnalité en cours de développement, en créant des liens vers les documents existants et en s'assurant que le README principal est à jour. Utile lors de l'ajout de nouvelles fonctionnalités pour maintenir une documentation cohérente et interconnectée.

Documentation

Vérifier et mettre à jour la documentation du dépôt lorsque le comportement, les commandes ou les preuves de validation changent.

Documentation

Exporte un catalogue complet de toutes les compétences Claude disponibles, en les découvrant depuis les sources personnelles, projet et plugins. Utile pour générer une documentation centralisée ou vérifier rapidement les compétences installées.

Documentation

Génère une documentation complète et des références d'API pour les projets logiciels. Elle crée des fichiers README, des documentations d'endpoints API, des vues d'architecture et des docstrings en code. Permet de maintenir une documentation cohérente et à jour avec des exemples fonctionnels et des guides de dépannage.

Documentation

Rédige un guide pratique orienté vers un objectif concret utilisant les types et API de ZIO Blocks. Idéal pour produire un tutoriel pas à pas qui enseigne comment accomplir une tâche spécifique, avec des exemples réalistes et un résultat fonctionnel.

Documentation

S'applique lors de l'édition, la mise à jour ou la maintenance de roadmap.md. Impose des règles de concision (supprimer les redondances, limiter les paragraphes), une structure d'entrée de version, des tableaux de comparaison et des listes d'interdictions. Utile pour garder les documents roadmap clairs et à haute densité d'information.

Documentation

Crée des entrées de journal horodatées pour documenter les découvertes, réunions, revues de code, articles ou événements significatifs. Structure les informations avec un résumé, un type d'événement, des sources et des tags, puis enregistre le fichier dans `docs/log/` avec un nom basé sur la date et un slug descriptif.