Skill

# Ancre Skill dans ton agent

## Objectif
Emploie « Skill » avec précision dans le code, la documentation et les échanges : Un dossier versionnable d’instructions et de ressources qu’un agent peut découvrir puis charger pour appliquer une procédure réutilisable.

## Prérequis
- Inspecte comment le terme est employé aujourd’hui dans le dépôt, la documentation et les prompts.
- Repère les notions voisines déjà nommées : Prompt, Outil, Model Context Protocol (MCP).
- Préserve les usages corrects existants.

## Définition de travail
Un dossier versionnable d’instructions et de ressources qu’un agent peut découvrir puis charger pour appliquer une procédure réutilisable.

## Différence décisive
La skill organise un savoir-faire ; elle n’est ni l’outil qui agit, ni l’agent qui choisit, ni un prompt ponctuel.

## Exemple qui compte comme Skill
Une skill d’audit UI décrit ses déclencheurs, ses étapes, ses preuves et les références à charger.

## Contre-exemple
Une requête API isolée sans procédure de décision n’est pas une skill complète.

## Critères d’acceptation
- Chaque usage du terme correspond à la définition de travail.
- Les cas limites sont tranchés avec la différence décisive, pas à l’intuition.
- Les notions voisines (Prompt, Outil, Model Context Protocol (MCP)) sont désignées par leur propre terme.

## Garde-fous
- Montre d’abord les changements envisagés avant toute action externe.
- Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
- Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.

## Format de sortie
- Résultat obtenu ou verdict.
- Fichiers ou actions concernés.
- Vérifications exécutées et preuves observables.
- Blocages ou limites restantes.

• Prérequis · Le vocabulaire agentique déjà employé dans le dépôt et la documentation

# Cartographie les notions voisines

## Objectif
Étends la même rigueur aux notions liées (Prompt, Outil, Model Context Protocol (MCP)) pour que le vocabulaire du projet reste cohérent.

## Contrôles
- Relève chaque notion voisine employée sans définition.
- Applique sa différence décisive documentée.
- Note les cas encore ambigus pour la fiche suivante.

## Garde-fous
- Montre d’abord les changements envisagés avant toute action externe.
- Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
- Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.

## Format de sortie
- Résultat obtenu ou verdict.
- Fichiers ou actions concernés.
- Vérifications exécutées et preuves observables.
- Blocages ou limites restantes.

sha256:9807b7db0f3763f32400f6fdf7f8c1a81a4844791a9ebb1446c4ebd4f6c2c779

# Corrige une confusion autour de Skill

## Symptôme observé
[DÉCRIS ICI LE SYMPTÔME]

## Contrôles observables
- Compare l’usage contesté à la définition de travail : Un dossier versionnable d’instructions et de ressources qu’un agent peut découvrir puis charger pour appliquer une procédure réutilisable.
- Applique la différence décisive : La skill organise un savoir-faire ; elle n’est ni l’outil qui agit, ni l’agent qui choisit, ni un prompt ponctuel.
- Confronte le cas au contre-exemple documenté : Une requête API isolée sans procédure de décision n’est pas une skill complète.

## Causes possibles
- Le terme est employé pour une notion voisine (Prompt, Outil, Model Context Protocol (MCP)).
- La forme observée (interface, script, service) est confondue avec le comportement réel.
- Un alias (compétence agent, SKILL.md) porte un autre sens dans le projet.

## Corrections bornées
- Renomme ou reclasse uniquement les usages qui contredisent la définition de travail.
- Documente chaque choix en citant la différence décisive.

## Vérification finale
- Relis chaque occurrence corrigée face à l’exemple et au contre-exemple documentés.

## Garde-fous
- Montre d’abord les changements envisagés avant toute action externe.
- Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
- Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.

## Format de sortie
- Résultat obtenu ou verdict.
- Fichiers ou actions concernés.
- Vérifications exécutées et preuves observables.
- Blocages ou limites restantes.

• Prérequis · Le vocabulaire agentique déjà employé dans le dépôt et la documentation

# Fixe le vocabulaire dans le projet

## Objectif
Transforme la clarification en règle réutilisable pour éviter que la confusion revienne.

## Contrôles
- Ajoute la définition de travail au glossaire du projet.
- Relie chaque terme voisin à sa propre entrée.
- Vérifie les nouveaux documents face à la différence décisive.

## Garde-fous
- Montre d’abord les changements envisagés avant toute action externe.
- Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
- Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.

## Format de sortie
- Résultat obtenu ou verdict.
- Fichiers ou actions concernés.
- Vérifications exécutées et preuves observables.
- Blocages ou limites restantes.

sha256:2545aaa255c31ebc1a069dedc2254b3ebb40c7dea5e12a7623f4f1a42baf59a7