Skip to main content
Les skills sont des unités fonctionnelles autonomes que vous pouvez enseigner à Devin CLI. Ils regroupent des prompts, l’accès aux outils, des autorisations et des workflows dans un package réutilisable qui peut être invoqué aussi bien par l’agent que par l’opérateur humain.

Que sont les skills ?

Considérez les skills comme des connaissances expertes que vous donnez à l’agent. Un skill peut lui apprendre à :
  • revoir du code selon les standards de votre équipe
  • générer un type spécifique de composant
  • exécuter un workflow de déploiement
  • effectuer un audit de sécurité
  • configurer un nouveau service à partir d’un template

Invocation par commande slash

Les utilisateurs peuvent invoquer des skills avec /skill-name dans le chat.

Autonomie de l’agent

L’agent peut invoquer des skills de manière autonome lorsque c’est pertinent.

Autorisations limitées au périmètre

Les skills peuvent avoir leurs propres autorisations et restrictions.

Outils approuvés automatiquement

Approuvez à l’avance les outils dont un skill a besoin afin qu’il s’exécute sans demande d’autorisation.

Exécution en sous-agent

Exécutez les skills comme des sous-agents indépendants avec leur propre fenêtre de contexte.

Dérogation de modèle

Utilisez un modèle différent pour des skills spécifiques.

Exemple rapide

Créez un skill de revue de code dans .devin/skills/review/SKILL.md (ou .windsurf/skills/review/SKILL.md) :
Vous pouvez désormais l’utiliser avec /review dans n’importe quelle session.

Fonctionnement des skills

Lorsqu’un skill est invoqué :
  1. Le prompt du skill est injecté dans la conversation
  2. Les outils listés dans le champ allowed-tools du skill (s’il est spécifié) sont approuvés automatiquement : ils s’exécutent donc sans demande d’autorisation. Les outils non listés restent disponibles et passent par les vérifications d’autorisation habituelles
  3. Les permissions du skill (allow, deny, ask) sont appliquées. Utilisez permissions.deny pour bloquer un outil pendant l’exécution du skill
  4. Le modèle spécifié est utilisé (s’il diffère de celui en cours)
allowed-tools et permissions s’appliquent aux skills qui s’exécutent en ligne. Un skill qui s’exécute en tant que sous-agent (subagent: true ou agent:) tire plutôt ses accès aux outils du profil de sous-agent.

Déclencheurs de skills

Les skills peuvent être invoqués de deux façons :
Définissez triggers: [user] pour empêcher l’agent d’invoquer un skill de sa propre initiative.

Skills tiers

Nous prenons en charge les standards .agents pour les skills, ce qui permet aux outils d’installation de skills tiers de fonctionner avec Devin CLI.
Les skills tiers peuvent exécuter du code arbitraire. Installez-les à vos risques et périls.

Où se trouvent les Skills

Les skills peuvent être définis au niveau d’un seul projet ou partagés entre tous les projets : Les skills de projet se trouvent dans le répertoire .devin/skills/ ou .windsurf/skills/ à la racine de votre projet et sont versionnés, ce qui permet de les partager avec votre Team. Les deux emplacements utilisent le même format SKILL.md. Les skills globaux se trouvent dans ~/.config/devin/skills/ (conformément aux conventions XDG) ou ~/.codeium/<channel>/skills/ (où <channel> vaut windsurf, windsurf-next ou windsurf-insiders selon le canal de votre CLI) et sont disponibles dans tous les projets sur votre machine.
Windows : Le chemin des skills globaux correspond au répertoire des données d’application de votre système. Sous Windows, utilisez %APPDATA%\devin\skills\<name>\SKILL.md (généralement C:\Users\<YourUser>\AppData\Roaming\devin\skills\<name>\SKILL.md) au lieu de ~/.config/devin/skills/.

Étapes suivantes

Créer des skills

Découvrez le format complet d’un skill, y compris les options de frontmatter, le contenu dynamique et des exemples.

Plugins

Regroupez des skills dans un plugin que vous pouvez installer et partager d’un projet à l’autre.