SebastienElet/agent-skills

Maintenir les instructions des agents de codage et leurs chemins de découverte. À utiliser lors de la création ou de la modification de AGENTS.md, CLAUDE.md, des règles d'agent ou des projections d'instructions. Assurez-vous d'utiliser cette compétence chaque fois que les directives de l'agent ou son déploiement changent, même si la demande ne nomme qu'un seul agent.

Qu'est-ce que agent-skills ?

Cette compétence est conçue pour les développeurs qui gèrent des systèmes multi-agents de codage tels que Claude Code, Cursor ou Codex. Elle fournit une politique de maintenance centralisée pour les instructions des agents, garantissant qu'elles restent ciblées, découvrables et dérivées d'une source canonique unique. Les agents assistés par l'IA s'appuient souvent sur des fichiers d'instructions, des règles ou des projections qui peuvent devenir incohérents au fil du temps. Cette compétence aide à éviter des pièges courants, comme le fait de placer des instructions conditionnelles dans des fichiers toujours chargés (ce qui augmente le coût contextuel pour chaque tâche) ou de traiter des mécanismes de règles nommés de manière similaire (par exemple, les règles de Markdown de Claude et les règles de commande Codex) comme équivalents alors qu'ils ont des sémantiques de découverte différentes. Elle applique une méthode en cinq étapes : lire la politique de maintenance, inspecter la hiérarchie des instructions existante, choisir une source canonique, mettre à jour tous les installateurs et générateurs, puis vérifier chaque projection d'agent indépendamment. Cette compétence doit être invoquée chaque fois que des directives d'agent ou leur déploiement changent, même si la demande ne concerne qu'un seul agent, car la mise à jour d'une seule projection peut laisser d'autres agents avec un comportement obsolète en silence.

Compatible avec✓Claude Code✓Codex CLI~Cursor

npx skills add https://github.com/SebastienElet/agent-skills/tree/HEAD/skills/agent-instructions

Documentation

Maintenance des Instructions d'Agent

Vue d'ensemble

Gardez les directives des agents ciblées, découvrables et dérivées d'une source canonique unique. Appliquez la politique de maintenance partagée avant de modifier le contenu des instructions, les adaptateurs, le déploiement ou la vérification.

Utilisation

Utilisez cette compétence pour les modifications apportées aux instructions globales ou de projet, aux fichiers de règles spécifiques aux agents et à la configuration qui les expose. Par exemple : $agent-instructions add a Codex instruction source.

Étapes

Lisez references/maintenance.md complètement.
Inspectez la hiérarchie des instructions existante et chaque chemin de découverte affecté par le changement.
Choisissez une source canonique et conservez les emplacements spécifiques aux agents comme projections ou adaptateurs.
Mettez à jour chaque installateur, fichier généré, index et barrière de vérification qui consomme la source.
Vérifiez indépendamment chaque projection d'agent affectée.

Pièges

Placer des directives conditionnelles dans des instructions toujours chargées — chaque tâche paie le coût contextuel ; exposez-les comme une compétence pour les agents qui prennent en charge la divulgation progressive.
Traiter des mécanismes nommés de manière identique comme équivalents — les règles Markdown de Claude et les règles de commande Codex ont des sémantiques différentes ; vérifiez le contrat de découverte du consommateur.
Mettre à jour une seule projection — un autre agent conserve silencieusement un comportement obsolète ; énumérez chaque consommateur déclaré et testez sa destination réelle.

Contraintes

Maintenez une source canonique pour le comportement des instructions partagées.
N'injectez jamais une règle conditionnelle dans un fichier d'instructions toujours chargé comme correctif de compatibilité.
Ne signalez jamais une projection comme saine sans avoir vérifié sa destination de déploiement réelle.