de skills43
Intégrez du Python avec cogapp pour générer automatiquement des sections de docs markdown (tableaux, aide CLI, blocs de code) afin que la documentation reste synchronisée avec le code.
Fournit des patterns pour intégrer du code Python à l'intérieur du markdown en utilisant cogapp (nedbat/cog) afin que le contenu généré — tableaux, sortie de l'aide CLI --help, exemples de code — soit produit en ligne et maintenu à jour. Elle documente comment écrire des blocs cog, exécuter cog pour régénérer le contenu et intégrer des vérifications dans la CI.
Utilisez ceci lorsque votre projet a une documentation qui doit être dérivée du code (aide CLI, tableaux auto-générés, exemples de sorties) et que vous voulez vous assurer que les docs sont toujours cohérentes avec la base de code. Également utile pour les étapes de CI qui échouent lorsque les docs sont obsolètes.
cog -r, cog --check, et patterns d'intégration CI.Agents pouvant exécuter du Python et des opérations sur fichiers (ex: agents de type Copilot, agents d'automatisation locale, exécuteurs CI).
Cogapp-markdown is a documentation automation skill that embeds Python via cogapp to auto-generate markdown sections like CLI help output and tables. No bundled scripts to test. SKILL.md is well-structured with clear install instructions, syntax reference, key patterns for Click and argparse, and CI integration guidance. Clean from a security perspective — no remote execution, credentials, or destructive patterns.
Solid documentation-oriented skill. The subprocess.run example for argparse CLIs is fine in context (only capturing --help output). No security concerns.
