Skills
Une skill (compétence) est un document d'instructions réutilisable, rédigé en Markdown, qu'un agent peut consulter à la demande pendant l'exécution d'une tâche. Les skills permettent de formaliser des conventions, des procédures ou des règles que l'agent appliquera de manière cohérente.
Contrairement aux prompts qui sont injectés au début d'une conversation, les skills sont lues activement par l'agent via l'outil intégré ReadSkill lorsqu'il en a besoin. Un agent ne peut accéder qu'aux skills qui lui sont explicitement assignées.
Champs du formulaire
Les informations suivantes définissent une skill dans la bibliothèque.
Catégories
Les skills sont organisées en cinq catégories pour faciliter la gestion et le filtrage.
Fonctionnement à l'exécution
Outil ReadSkill
Chaque agent dispose d'un outil intégré nommé ReadSkill qui lui permet d'interagir avec ses compétences assignées. Cet outil propose deux opérations :
- Lister — L'agent consulte la liste de ses skills disponibles (nom, description, catégorie)
- Lire — L'agent récupère le contenu complet d'une skill par son nom
Contrôle d'accès
Un agent ne peut lire que les skills qui lui sont assignées dans sa configuration. Toute tentative d'accès à une skill non assignée est refusée. Les skills désactivées sont également masquées.
Différence avec les prompts
| Prompts | Skills | |
|---|---|---|
| Injection | Automatique, au début du message | À la demande, par l'agent |
| Accès | Via la bibliothèque de prompts | Via l'outil ReadSkill |
| Portée | Une seule conversation | Toutes les tâches de l'agent |
| Variables | {{variable}} remplacées à la sélection |
Contenu statique |
| Référence croisée | Peut référencer des skills via {{skill:nom}} |
Indépendantes |
Assigner des skills à un agent
Les skills sont assignées par nom dans la configuration de l'agent (onglet Paramètres > Agents). Un agent peut avoir plusieurs skills, et une même skill peut être partagée entre plusieurs agents.
Lors de l'exécution, l'agent décide lui-même quand consulter ses skills en fonction du contexte de la tâche. Il n'est pas obligé de les lire toutes à chaque interaction.
Champs du formulaire
Identifiant unique de la skill. Sert aussi de référence dans les prompts et la configuration des agents.
Résumé court affiché dans la liste et dans le sélecteur de skills de l'agent. Aide à identifier rapidement le rôle de la skill.
Classification parmi les catégories disponibles. Permet le filtrage dans la liste.
Corps de la skill en Markdown. Peut contenir des titres, listes, blocs de code, tableaux — tout ce qui aide l'agent à comprendre et appliquer les instructions.
Catégories
Instructions au niveau du système, réservées à un usage interne
Conventions de code, guides de style, règles de programmation
Procédures de travail, décomposition de tâches, schémas de délégation
Cadres d'analyse, critères d'évaluation, grilles de notation
Skills personnalisées créées par l'utilisateur (catégorie par défaut)
Outil ReadSkill
L'agent interagit avec ses skills via l'outil intégré ReadSkill. Cet outil ne nécessite aucune confirmation de validation.
{"operation": "list"}
Consulte la liste des skills disponibles pour l'agent. Retourne le nom, la description et la catégorie de chaque skill assignée et activée.
{"name": "conventions-code"}
Récupère le contenu Markdown complet d'une skill par son nom. L'agent reçoit toutes les instructions et peut les appliquer immédiatement.
- Un agent ne peut lire que les skills assignées dans sa configuration
- Les skills désactivées sont masquées même si elles sont assignées
- Toute tentative d'accès non autorisé est refusée avec une erreur
Référence depuis les prompts
Les skills peuvent également être invoquées depuis la bibliothèque de prompts via une syntaxe dédiée.
Les références {{skill:nom}} sont résolues automatiquement côté serveur. Contrairement aux variables qui sont remplacées avant l'envoi, les skills restent intactes jusqu'à l'exécution par l'agent.
Assignation aux agents
Rédigez les instructions dans la bibliothèque de skills
Dans Paramètres > Agents, ajoutez la skill par son nom
L'agent consulte ses skills selon le contexte de la tâche