Go Documentation
Commentaires godoc, README, CONTRIBUTING, CHANGELOG, tests d'exemple, docs API, llms.txt — la documentation comme livrable de premier ordre
- Quoi
- Commentaires godoc, README, CONTRIBUTING, CHANGELOG, tests d'exemple, docs API, llms.txt — la documentation comme livrable de premier ordre
- Coût
- Gratuit
- Prérequis
- un projet Go (la chaîne d'outils go)
- Installation
- Copiez le prompt d’installation ci-dessous dans votre Muse — votre agent fait le reste.
Sélectionné par Skill Harbor — un skill de documentation Go qui traite la doc comme un livrable de premier ordre : précise, guidée par des exemples, écrite pour le lecteur qui n'a jamais vu la base de code. Il couvre les commentaires godoc, README, CONTRIBUTING, CHANGELOG, les liens Go Playground, les tests d'exemple, les docs API et llms.txt — avec un mode écriture (compléter la documentation manquante via une checklist) et un mode révision (auditer l'exhaustivité par couche), plus un mode d'orchestration qui parallélise le travail de documentation entre paquets avec des sous-agents. Distinct des skills samber déjà publiés — la documentation n'avait aucune couverture ; et contrairement au skill addyosmani-documentation-and-adrs (qui porte sur les décisions d'architecture), celui-ci porte sur les couches de documentation face au code d'un projet Go. Crédit : @samber. Bémols honnêtes : la documentation pourrit — le skill donne les couches et la checklist, mais personne ne les maintiendra à jour à votre place ; les tests d'exemple servent à la fois de documentation et de tests, soit deux fois la maintenance. Skill Harbor ne vérifie jamais le code, examinez-le vous-même avant usage.
Version :
Installation
Prérequis : un projet Go (la chaîne d'outils go) Installe-moi « Documentation Go ». Commentaires godoc, README, CONTRIBUTING, CHANGELOG, tests d'exemple, docs API, llms.txt — la documentation comme livrable de premier ordre Dépôt : https://github.com/samber/cc-skills-golang/blob/main/skills/golang-documentation/SKILL.md 1. Récupère le fichier SKILL.md du skill samber-golang-documentation depuis le dépôt dans un dossier temporaire et résume en une ou deux phrases ce qu'il fait. 2. Contrôle de sécurité : examine le SKILL.md et les scripts pour tout contenu suspect (appels réseau inattendus, commandes shell, récolte d'identifiants). Ce dépôt ne doit contenir aucun secret dans le code ; les identifiants passent uniquement par le coffre sécurisé, les hôtes autorisés sont déclarés dans le SKILL.md. Vérifie que c'est bien le cas ; STOP sur le moindre signal d'alerte et préviens-moi. 3. Installe-le comme skill : copie le SKILL.md et ses fichiers auxiliaires dans le répertoire des skills de l'agent, dans un dossier nommé « samber-golang-documentation ». 4. Vérifie sans appels réseau : frontmatter valide, fichiers en place. 5. Indique ce qui a été installé, où, et ce qu'il me reste à faire moi-même (ex. tout compte, clé API ou outil CLI mentionné dans les prérequis ci-dessus). GitHub est optionnel : si j'ai un compte GitHub ou le CLI gh, tu peux l'utiliser ; sinon, l'accès public suffit. Règles : ne touche à rien en dehors du dossier temporaire et de la cible d'installation. Ne me demande jamais de coller des secrets dans le chat ; les identifiants passent par le coffre sécurisé ou des variables d'environnement. Si quelque chose semble anormal, arrête-toi et demande-moi.
Questions
Comment installer une création ?
Chaque fiche produit contient un prompt d’installation à copier-coller. Collez-le dans votre Muse et il installe la création pour vous — sans configuration manuelle.
Où va mon argent ?
Directement au vendeur. Skill Harbor ne traite jamais les paiements : le paiement se fait sur la page du vendeur, généralement via Stripe.
Que signifie le ✓ à côté du nom d’un créateur ?
Il signifie que nous avons confirmé l’identité de la personne derrière la fiche. Il ne dit rien sur le code lui-même — vérifiez toujours une création avant de l’installer.