Les Skills sont des fichiers SKILL.md que vous validez dans vos dépôts et qui enseignent à Devin des procédures réutilisables : tout workflow répétable que vous souhaitez voir Devin suivre de manière cohérente. Tester votre application avant d’ouvrir une PR, déployer vers un environnement, analyser une base de code, générer l’ossature d’un nouveau service — si vous pouvez l’écrire sous forme d’instructions étape par étape, vous pouvez en faire une Skill.
Ils suivent le standard ouvert Agent Skills, de sorte que les mêmes fichiers de Skills fonctionnent avec plusieurs outils d’IA pour le code.
Placez les fichiers de Skills à l’emplacement .agents/skills/<skill-name>/SKILL.md dans votre dépôt. Devin les découvre automatiquement dans tous vos dépôts connectés. Consultez la spécification Agent Skills pour la référence complète du format de fichier.
Pourquoi les Skills sont importantes
- Doit être exécuté de la même manière à chaque fois — check-lists de test, étapes de déploiement, procédures de revue
- Nécessite des connaissances propres au dépôt — quels services démarrer, quels ports utiliser, quelles commandes exécuter
- Bénéficie d’un contexte dynamique — récupération des diffs Git, des noms de branche ou des informations d’environnement au moment de l’exécution
Devin suggère automatiquement des skills
- Un résumé de ce qui a été appris (par exemple « comment démarrer le backend avec Docker »)
- Le contenu proposé du fichier
SKILL.md
- Un bouton “Create PR” pour valider le skill dans votre dépôt
Au fil du temps, Devin constitue dans votre dépôt une bibliothèque de skills sur la façon d’exécuter, de tester et de déployer votre application.
Vérification avant d’ouvrir une PR
---
name: test-before-pr
description: Run the local dev server and verify pages before opening any PR that touches frontend code.
---
## Setup
1. Install dependencies: `npm install`
2. Start the database: `docker-compose up -d postgres`
3. Run migrations: `npx prisma migrate dev`
4. Start the dev server: `npm run dev`
5. Wait for "Ready on http://localhost:3000"
## Verify
1. Read the git diff to identify which pages changed
2. Open each affected page in the browser
3. Check for: console errors, layout issues, broken links
4. Screenshot each page at desktop (1280px) and mobile (375px) widths
## Before Opening the PR
1. Run `npm run lint` and fix any issues
2. Run `npm test` and confirm all tests pass
3. Include screenshots in the PR description
Déploiement dans un environnement
---
name: deploy
description: Deploy the app to a target environment and run smoke tests.
argument-hint: <environment>
triggers: ["user"]
---
## Deploy
1. Make sure you are on the correct branch for this deploy
2. Run `./scripts/deploy.sh $0`
3. Wait for the deploy script to complete successfully
## Verify
1. Curl `https://$0.example.com/health` and confirm a 200 response
2. Run the smoke test suite: `npm run test:smoke -- --env=$0`
3. Report the deployment URL and test results
## Current context
- Branch: !`git branch --show-current`
- Last commit: !`git log --oneline -1`
@skills:deploy staging remplace $ARGUMENTS et $0 par staging, et les blocs !`command` insèrent des informations Git en temps réel. Le champ triggers: ["user"] garantit que Devin n’exécute ce skill que lorsque vous le demandez explicitement — il ne s’activera pas automatiquement.
Explorer une partie de la base de code
---
name: investigate
description: Research a part of the codebase and produce a written summary with file references.
allowed-tools: Read, Grep, ListDir
argument-hint: <topic or area to investigate>
---
## Research
1. Search the codebase for files related to: $ARGUMENTS
2. Read the most relevant files thoroughly
3. Trace the call chain and data flow
## Summarize
1. Write a summary of how $ARGUMENTS works
2. Include specific file paths and line numbers for every claim
3. Note any concerns, edge cases, or areas that need attention
allowed-tools limite Devin à des opérations en lecture seule — aucune modification, aucune commande shell. C’est utile pour les tâches d’exploration où vous souhaitez une analyse sans effets de bord.
Découverte des compétences
- Dépôts indexés — le backend de Devin indexe les fichiers
SKILL.md dans tous les dépôts connectés à votre organisation. Ceux-ci sont disponibles immédiatement au démarrage d’une session, avant que des dépôts ne soient clonés.
- Dépôts clonés — au fur et à mesure que les dépôts sont clonés sur la machine associée à la session, Devin les analyse à la recherche de fichiers
SKILL.md présents sur le disque. Les compétences détectées sur le disque mettent à jour ou remplacent toute compétence indexée correspondante provenant du même dépôt, garantissant que Devin utilise toujours la dernière version sur la branche en cours de travail.
Lorsqu’un clonage de dépôt se termine en cours de session, Devin réanalyse automatiquement ce dépôt afin que les compétences nouvellement ajoutées ou modifiées soient prises en compte sans avoir besoin de redémarrer la session.
Emplacements pris en charge pour les fichiers de skill
SKILL.md dans tous les répertoires suivants :
.agents/skills/<skill-name>/SKILL.md (recommandé).github/skills/<skill-name>/SKILL.md.claude/skills/<skill-name>/SKILL.md.cursor/skills/<skill-name>/SKILL.md.codex/skills/<skill-name>/SKILL.md.cognition/skills/<skill-name>/SKILL.md.windsurf/skills/<skill-name>/SKILL.md
Les sept chemins sont analysés dans chaque dépôt.
Ce que Devin charge depuis un fichier de skill
--- en haut) et en extrait :
| Champ | Rôle |
|---|
name | Identifie le skill. Revient au nom du répertoire parent s’il est omis. |
description | Brève description affichée dans la liste des skills pour que Devin (et vous) sachiez ce que fait le skill. |
allowed-tools | Restreint les outils que Devin peut utiliser tant que le skill est actif. |
| Champ | Rôle |
|---|
argument-hint | Texte d’aide affiché à côté du nom du skill décrivant les arguments attendus. |
triggers | Contrôle qui peut invoquer le skill — ["user", "model"] par défaut. Définissez ["user"] pour empêcher Devin de l’activer automatiquement. |
$ARGUMENTS — remplacé par la chaîne complète d’arguments passée lorsque le skill est invoqué (par exemple via @skills:deploy staging prod). Vous pouvez aussi accéder individuellement aux arguments par index : $ARGUMENTS[0] ou $0 pour le premier, $ARGUMENTS[1] ou $1 pour le second, etc. Les arguments sont séparés par des espaces.!`command` — la commande est exécutée à la racine du dépôt et remplacée par sa sortie standard, ce qui permet aux skills d’inclure des valeurs dynamiques comme des noms de branches ou des numéros de port.
Au début de chaque session, Devin a accès à une liste de tous les skills disponibles (nom + description). Lorsqu’un skill est invoqué, Devin lit le fichier SKILL.md complet et injecte son contenu dans son contexte actuel en tant qu’instruction système. Cela signifie que Devin suit activement les étapes du skill pour le reste de la tâche — ce n’est pas qu’une simple référence, cela guide directement le comportement de Devin.
Devin peut utiliser les skills de plusieurs façons :
Lorsque Devin détermine qu’une compétence est pertinente pour la tâche en cours, il l’invoque automatiquement. Par exemple, si vous demandez à Devin de corriger un bug dans du code front-end et qu’il existe une compétence test-before-pr, Devin l’activera avant d’ouvrir la PR. Définissez triggers: ["user"] dans le frontmatter pour empêcher l’invocation automatique pour les compétences que vous ne souhaitez déclencher qu’explicitement.
Indiquer une compétence dans votre prompt
@skills:skill-name à votre message :
Fix the login bug on the /auth page @skills:test-before-pr
$ARGUMENTS, $ARGUMENTS[0], $1, etc.
Une seule compétence active à la fois
- Compétences globales / au niveau de l’organisation — À l’heure actuelle, les compétences sont définies à l’intérieur des dépôts. Pour des compétences valables à l’échelle de l’organisation, vous pouvez créer un dépôt dédié « skills » comme solution de contournement. Nous étudions une prise en charge native des compétences au niveau de l’organisation, applicables à tous les dépôts.
- Composer plusieurs compétences — Actuellement, une seule compétence peut être active à la fois. Nous travaillons sur la prise en charge de l’enchaînement et de la composition de workflows.
Les skills et les playbooks donnent tous deux à Devin des instructions réutilisables, mais ils fonctionnent différemment :
| Skills | Playbooks |
|---|
| Où ils résident | Dans votre dépôt sous forme de fichiers SKILL.md — versionnés aux côtés de votre code | Dans l’application web Devin — gérés via l’interface utilisateur |
| Comment ils sont déclenchés | Devin les découvre et les invoque automatiquement, ou vous les référencez avec @skills:name dans n’importe quel prompt | Rattachés manuellement à une session au moment où vous la démarrez |
| Portée | Limitée à un dépôt — Devin sélectionne les bons skills en fonction des dépôts pertinents pour la tâche | À l’échelle de l’organisation — n’importe quel membre de l’équipe peut rattacher n’importe quel playbook à n’importe quelle session |
| Suggestion automatique | Devin suggère de nouveaux skills après avoir testé votre application ou appris quelque chose de nouveau | Créés manuellement par les membres de l’équipe |
| Idéal pour | Procédures de test, configuration de développement local, listes de contrôle de déploiement, workflows spécifiques à un dépôt | Modèles de prompts réutilisables, modèles de tâches multi-dépôts, guides d’onboarding |
Si vous avez déjà des playbooks qui fonctionnent bien, rien ne presse pour migrer — ils continueront à fonctionner. Mais pour de nouvelles instructions, nous recommandons de commencer par des skills.
- Agent Skills specification — le standard ouvert pour le format de fichier
SKILL.md, les champs de frontmatter et la structure des répertoires
- Knowledge — pour des conseils contextuels et des informations factuelles (pas des procédures détaillées étape par étape)
- Playbooks — pour des modèles de prompts réutilisables, associés aux sessions
