Une compétence (skill) encapsule un workflow réutilisable et à la demande pour un agent IA : des instructions pour une tâche récurrente (quand la faire et comment), plus des scripts ou ressources optionnels que l'agent charge uniquement lorsque la tâche est pertinente. C'est la différence entre réexpliquer une procédure à chaque fois et l'enseigner une seule fois.
SKILL = a self-contained folder the agent can pull in on demand:
SKILL.md → metadata + instructions (the TRIGGER + the STEPS)
scripts/ → optional helper scripts the agent runs (e.g. a linter, a generator)
resources/ → optional templates, examples, reference files
→ loaded ONLY when relevant → keeps the base context small, the workflow repeatable
L'avantage est une divulgation progressive : l'agent sait que la compétence existe à partir d'une brève description, et ne charge les instructions et scripts complets que lorsqu'une tâche correspondante se présente — de sorte que des dizaines de compétences ne surchargeant pas chaque conversation.
Une compétence a trois parties : le déclencheur (quand), les étapes (comment), et tous les scripts auxiliaires (outils). Gardez-la concentrée et composable — un travail fait bien, pas un fourre-tout.
---
name: changelog-entry
description: Add a CHANGELOG entry. Use when finishing a user-facing change.
---
# Add a changelog entry
## Steps
1. Read the latest commits since the last release tag.
2. Categorize each as Added / Changed / Fixed.
3. Prepend a dated section to CHANGELOG.md under [Unreleased].
4. Run `scripts/validate.sh` to check the format.
La description est le déclencheur — elle indique à l'agent quand utiliser cette compétence. La liste numérotée est les étapes, et validate.sh est un script auxiliaire qui garantit la correction afin que l'agent n'ait pas à raisonner sur le format à partir de zéro. Parce que la compétence est petite et univoque, elle se compose proprement avec d'autres (par exemple, une compétence « release » séparée peut l'appeler).
Les compétences transforment un agent d'un assistant généraliste que vous réinstruisez constamment en un agent qui connaît vos procédures récurrentes. En encapsulant le déclencheur, les étapes et les scripts dans une unité concentrée et composable qui ne se charge que sur demande, vous codifiez les connaissances institutionnelles une fois et les réutilisez de manière fiable — obtenant des résultats cohérents sur les tâches répétitives sans les réexpliquer, et sans payer le coût contextuel de chaque workflow sur chaque requête.