CommunityRédaction et éditiongithub.com

write-agent-skill

Concevoir, rédiger, réviser ou auditer des compétences réutilisables pour agents IA et leurs packages d'instructions SKILL.md.

Qu'est-ce que write-agent-skill ?

Cette compétence est un assistant expert pour les développeurs et utilisateurs avancés d'agents IA (comme Claude Code, Cursor, Codex, etc.) qui souhaitent créer, améliorer ou auditer des compétences personnalisées. Elle guide l'utilisateur tout au long du processus : définition du contrat de la compétence, rédaction du fichier `SKILL.md` avec un frontmatter YAML approprié, intégration de références, scripts et évaluations, et enfin tests et révisions. L'accent est mis sur la création de packages d'instructions précis, cohérents et exécutables par un agent, en évitant les inventions d'APIs non documentées et en s'appuyant sur des exemples concrets. La compétence elle-même utilise un format structuré et des règles de conception (définition du déclencheur, gestion des limites, procédure de décision, critères d'arrêt, etc.) pour garantir la qualité et la réutilisabilité. Elle est conçue pour être utilisée directement dans un agent hôte, et son fonctionnement se base sur les instructions détaillées de son propre fichier `SKILL.md`.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/rafik-mikhail/write-agent-skill/tree/main

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Compétence de rédaction d'agent

Objectif

Fournir un package d'instructions exécutables par un agent pour un travail cohérent et réutilisable. Ancrez-le dans la tâche, les exemples, l'environnement d'outils, les artefacts existants et les corrections de l'utilisateur. Si aucun exemple réel n'est disponible, étiquetez les hypothèses et rédigez des instructions minimales testables plutôt que d'inventer des API spécifiques à un produit. Terminez et présentez la compétence réellement demandée, et non seulement un plan, un rapport d'avancement ou une critique.

Définir le contrat

  1. Énoncez le déclencheur : la tâche et l'entrée qui doivent activer cette compétence, ainsi que les demandes adjacentes qui ne devraient pas. Rédigez la description comme une règle de routage concise spécifiant ce qu'elle fait et quand l'utiliser.
  2. Énoncez les entrées requises et facultatives, l'autorité autorisée de l'agent, le résultat attendu et la définition de la tâche terminée. Résolvez les chevauchements avec les compétences voisines lors du transfert ; ne fusionnez pas des étapes distinctes simplement parce qu'elles partagent un sujet.
  3. Marquez les comportements obligatoires (passerelles de sécurité ou de correction), les heuristiques par défaut et les améliorations facultatives. Les instructions ne peuvent pas appliquer les autorisations d'exécution : utilisez les contrôles de la plateforme pour l'accès au système de fichiers, au réseau et aux outils.

Rédiger SKILL.md

Utilisez un frontmatter YAML avec un name en minuscules avec traits d'union correspondant à son dossier et une description spécifique. Suivez le format et les capacités de la plateforme hôte ; ne présumez pas de métadonnées facultatives ou de allowed-tools appliquant l'accès sur toutes les plateformes.

Gardez le corps concis : tâche et limites, entrées, procédure de décision, gestion des arrêts/échecs, contrat de sortie et pièges non évidents. Donnez un chemin par défaut plutôt qu'un menu d'alternatives équivalentes. Donnez des étapes exactes pour les opérations fragiles ; laissez une place au jugement justifié dans la sélection du contexte. Évitez de reformuler la même interdiction dans chaque section ou d'intégrer la réponse d'une tâche ponctuelle comme une procédure générale.

Déplacez les grandes références de domaine vers des fichiers references/ ciblés et dites exactement à l'agent quand les lire. Ajoutez des scripts réutilisables pour un travail répétitif et déterministe uniquement après avoir confirmé leurs dépendances d'exécution et leur comportement de validation. Conservez les références directement accessibles depuis SKILL.md et ne prétendez pas qu'un brouillon a été installé, exécuté ou validé quand ce n'est pas le cas.

Tester et réviser

Commencez par 2 à 3 cas représentatifs, dont un cas limite ; ajoutez des cas de déclenchement négatif et adverses lorsque la compétence agit sur du contenu non fiable ou a des limites importantes. Exécutez des sessions fraîches avec et sans la compétence ou par rapport au brouillon précédent. Évaluez les sorties observables et le comportement des outils, pas la qualité stylistique des instructions. Inspectez les traces pour détecter les étapes inutiles, les preuves manquées, les activations erronées et l'élargissement du périmètre. Pour les vérifications mécaniques, utilisez du code ; pour les jugements substantiels, faites appel à des humains. Supprimez les instructions qui ajoutent du coût sans prévenir une défaillance réelle.

Vérification de livraison

Avant de répondre, vérifiez que l'artefact complet demandé est effectivement présent et cohérent en interne. Lorsque l'utilisateur demande le Markdown complet, livrez l'intégralité du SKILL.md actuel, pas des fragments de correctif. Si vous créez un fichier, vérifiez qu'il existe et contient le brouillon complet ; signalez honnêtement le statut non testé. Résumez brièvement ce qui a changé et les éventuels besoins de validation restants. Ne transformez pas une demande pour une compétence en une suite non liée sans une demande claire.

Skills associés