Technical Writing

Le skill seo aide à auditer, planifier et mettre en œuvre le SEO technique, l’optimisation on-page, les données structurées, les Core Web Vitals et le maillage des mots-clés. Utilisez-le pour la crawlabilité, l’indexabilité, les métadonnées, le schema, les modifications du maillage interne, du sitemap et du robots, ou pour le SEO de Keyword Research, avec des recommandations concrètes et directement applicables à chaque page.

La skill java-coding-standards fournit des conseils pratiques pour écrire un Java 17+ lisible et maintenable dans des services Spring Boot, avec un focus sur les conventions de nommage, l’immutabilité, `Optional`, les streams, les exceptions, les génériques et l’organisation des packages. Utilisez-la pour coder, refactorer et appliquer les java-coding-standards lors des revues de code.

cpp-coding-standards est un guide de standards de codage C++ basé sur les C++ Core Guidelines. Utilisez-le pour écrire, relire et refactorer du C++ moderne, avec un accent sur la sécurité, la clarté, la maintenabilité, RAII, la sécurité des types et les bonnes conceptions. Idéal pour cpp-coding-standards en revue de code et pour des décisions d’équipe concrètes.

code-tour crée des fichiers CodeTour `.tour` réutilisables avec de vrais ancrages sur les fichiers et les lignes. Utilisez le skill code-tour pour des parcours d’onboarding, des visites d’architecture, des tours de PR, des chemins d’analyse RCA, ainsi que du code-tour pour la rédaction technique lorsque vous avez besoin d’un chemin guidé plutôt que d’un simple résumé linéaire.

Le skill article-writing aide à rédiger des contenus longs avec une structure solide, une voix cohérente et des éléments factuels étayés. Utilisez-le pour des articles, des guides, des tutoriels, des newsletters et des workflows de copywriting où une prose soignée, prête à publier, est essentielle.

architecture-decision-records aide à consigner les décisions d’architecture prises pendant les sessions Claude Code sous forme d’ADR structurés. La skill repère les moments de décision, enregistre le contexte, les alternatives et la justification, puis maintient un journal d’ADR utile aux futurs mainteneurs. Elle convient particulièrement à la rédaction technique et aux équipes d’ingénierie qui ont besoin d’un historique de décisions durable.

api-design est une skill de conception d’API REST conçue pour planifier et relire des endpoints, le nommage des ressources, les codes d’état, la pagination, le filtrage, le versioning et les réponses d’erreur.

brainstorming est une compétence de pré-implémentation qui explore le contexte, pose des questions de clarification une par une et impose une validation du design avant tout code. Elle inclut un compagnon visuel optionnel et une prise en charge solide de la planification des exigences.

writing-plans aide à transformer une spec ou un document d’exigences en un plan d’implémentation détaillé, avec des indications au niveau des fichiers, un séquencement des tâches, des étapes de test et une invite de relecture avant de commencer à coder.

doc-coauthoring propose un workflow structuré pour rédiger de la documentation avec l’IA : collecte du contexte, plan itératif, rédaction section par section et test lecteur pour produire des specs, RFC et propositions prêtes à relire.

technical-writer est un skill léger de documentation conçu pour produire des README, documentations d’API, guides d’installation, tutoriels, documents d’onboarding et notes de version plus clairs. Il met la rédaction technique au service des objectifs utilisateur, des quick starts, des exemples et du dépannage. Le skill est livré sous la forme d’un unique fichier SKILL.md, sans scripts ni modèles supplémentaires.

document-release est une compétence de mise à jour documentaire après livraison qui lit la documentation du projet, recoupe le diff livré, puis met à jour README, ARCHITECTURE, CONTRIBUTING, CLAUDE.md, CHANGELOG et VERSION pour que la documentation reflète ce qui a réellement été livré. Utilisez la compétence document-release pour la rédaction technique lorsque le code est déjà fusionné et que vous avez besoin d’un guide document-release fiable.

caveman est une compétence de communication ultra-condensée pour des réponses techniques brèves, des résumés et de l’aide au débogage. Elle conserve le sens technique, supprime le superflu et reste active après déclenchement jusqu’à ce que vous disiez stop caveman ou mode normal. Idéale pour la rédaction technique, les notes de revue de code, les mises à jour d’incident et les échanges plus rapides quand vous connaissez déjà le sujet.

La skill edit-article aide à restructurer des brouillons existants, à améliorer la clarté et à resserrer le style. Utilisez-la lorsque vous avez besoin d’un guide fiable edit-article pour réviser des articles, surtout dans des workflows de rédaction technique où l’ordre des sections et les dépendances comptent.

writing-shape est une compétence de rédaction conversationnelle qui transforme une matière brute en Markdown en article publiable. Elle aide à choisir une accroche, à développer le texte paragraphe par paragraphe et à arbitrer la structure pour la rédaction technique, les notes d’entretien, le nettoyage de transcript et les brouillons imparfaits. Utilisez le guide writing-shape quand vous avez besoin d’un processus éditorial guidé plutôt que d’une simple consigne ponctuelle.

grill-with-docs est une compétence de planification et de documentation qui met votre plan à l’épreuve face au modèle de domaine déjà présent dans le dépôt, affine la terminologie et met à jour CONTEXT.md et les ADR au fur et à mesure que les décisions se stabilisent. Utilisez-la pour la rédaction technique, l’ingénierie orientée produit et tout workflow où un langage ancré dans le dépôt compte davantage qu’un brainstorming basé uniquement sur un prompt.

ubiquitous-language est un skill orienté DDD qui extrait un glossaire partagé à partir des conversations, signale les termes ambigus et les synonymes, puis écrit UBIQUITOUS_LANGUAGE.md. Utilisez-le pour définir les termes du domaine, aligner les équipes et améliorer l’« ubiquitous language » en rédaction technique.

python-code-style aide à gérer le formatage Python, le linting, les conventions de nommage, les annotations de type et les docstrings. Utilisez-la pour relire des pull requests, harmoniser les conventions d’équipe et configurer des recommandations ruff, mypy ou pyright dans `pyproject.toml`.

architecture-decision-records aide les équipes à rédiger et maintenir des ADR avec un contexte clair, des décisions, des alternatives et des conséquences, pour une documentation technique durable des choix d’architecture.

La skill changelog-automation aide les équipes à concevoir des workflows de changelog avec Keep a Changelog, SemVer, les notes de version et Conventional Commits. Servez-vous-en pour cadrer le contexte d’installation, définir les entrées d’usage et améliorer la cohérence des notes de version pour la rédaction technique et la documentation développeur.

La skill add-educational-comments ajoute des commentaires pédagogiques dans un fichier de code donné tout en préservant sa structure et son comportement. Elle peut demander un fichier si aucun n’est fourni, s’adapte au niveau du lecteur et respecte des limites claires d’augmentation du nombre de lignes pour une édition de code à visée pédagogique.

gws-docs vous aide à lire et à écrire dans Google Docs via l’interface `gws` CLI, avec un contrôle au niveau des méthodes pour la création, la récupération et les mises à jour par lots. Suivez le parcours d’installation, de schéma et d’utilisation dans le guide gws-docs pour la rédaction technique et l’automatisation de la documentation.

adr-skill aide les équipes à créer et maintenir des Architecture Decision Records exécutables par des agents. Il facilite la rédaction, l’initialisation d’un dossier ADR, le choix de modèles, la mise à jour des statuts et la validation des décisions grâce à des checklists, scripts et exemples.

Clarify améliore les textes UX confus, les messages d’erreur, les libellés, les étapes d’onboarding et les consignes afin que les utilisateurs puissent agir avec moins d’hésitation. Ce skill est utile pour la rédaction technique, les contenus de support et les équipes produit qui ont besoin d’un texte d’interface plus clair. Il commence par prendre en compte le contexte, l’audience et l’état de l’utilisateur avant de reformuler, pour aboutir à un résultat plus direct, plus précis et plus facile à utiliser.