Les tâches d’ingénierie les plus difficiles demandent souvent plus que de simples bons prompts. Elles peuvent nécessiter des scripts de référence, des modèles, des checklist et d’autres fichiers associés. Les skills vous permettent de regrouper tout cela dans des dossiers que Cascade peut invoquer (lire et utiliser).
Les skills sont un excellent moyen d’apprendre à Cascade à exécuter de manière cohérente des workflows en plusieurs étapes.
Cascade utilise la révélation progressive : seuls le name et la description du skill sont affichés au modèle par défaut. Le contenu complet de SKILL.md et les fichiers associés ne sont chargés que lorsque Cascade décide d’invoquer le skill (ou lorsque vous le @mentionnez). Cela permet de conserver une fenêtre de contexte légère même lorsque de nombreux skills sont définis.
Pour plus de détails sur la spécification des skills, consultez agentskills.io.
Utiliser l’interface (le plus simple)
- Ouvrez le panneau Cascade
- Cliquez sur les trois points en haut à droite du panneau pour ouvrir le menu Customisations
- Cliquez sur la section
Skills
- Cliquez sur
+ Workspace pour créer une compétence de workspace (spécifique au projet), ou sur + Global pour créer une compétence globale
- Nommez la compétence (lettres minuscules, chiffres et tirets uniquement)
Skill de workspace (spécifique à un projet) :
- Créez un dossier :
.windsurf/skills/<skill-name>/
- Ajoutez un fichier
SKILL.md contenant un frontmatter YAML
Skill global (disponible dans tous les workspaces) :
- Créez un dossier :
~/.codeium/windsurf/skills/<skill-name>/
- Ajoutez un fichier
SKILL.md contenant un frontmatter YAML
Chaque skill doit avoir un fichier SKILL.md avec un front matter YAML contenant les métadonnées de la skill :
---
name: deploy-to-production
description: Guides the deployment process to production with safety checks
---
## Pre-deployment Checklist
1. Run all tests
2. Check for uncommitted changes
3. Verify environment variables
## Deployment Steps
Follow these steps to deploy safely...
[Reference supporting files in this directory as needed]
Champs de frontmatter requis
- name: Identifiant unique pour la skill (affiché dans l’UI et utilisé pour les @‑mentions)
- description: Brève explication présentée au modèle d’IA pour l’aider à décider quand l’invoquer
Exemples de noms valides : deploy-to-staging, code-review, setup-dev-environment
Ajout de ressources supplémentaires
SKILL.md. Ces fichiers deviennent disponibles pour Cascade lorsque la skill est invoquée :
.windsurf/skills/deploy-to-production/
├── SKILL.md
├── deployment-checklist.md
├── rollback-procedure.md
└── config-template.yaml
Utilisation des compétences
description dans le frontmatter de votre skill est essentiel : il permet à Cascade de comprendre quand invoquer le skill. Rédigez des descriptions qui expliquent clairement ce que fait le skill et quand il doit être utilisé.
Vous pouvez toujours activer explicitement une skill en saisissant @skill-name dans le champ de saisie de Cascade. C’est utile lorsque vous voulez vous assurer qu’une skill spécifique est utilisée, ou lorsque vous voulez invoquer une skill qui pourrait ne pas être déclenchée automatiquement par votre requête.
| Portée | Emplacement | Disponibilité |
|---|
| Workspace | .windsurf/skills/ | Workspace actuel uniquement. Versionné avec votre dépôt. |
| Global | ~/.codeium/windsurf/skills/ | Tous les workspaces sur votre machine. Non versionné. |
| Système (Enterprise) | Spécifique à l’OS (voir ci-dessous) | Tous les workspaces, déployés par l’IT. En lecture seule. |
Pour la compatibilité inter-agents, Windsurf détecte également les skills dans .agents/skills/ et ~/.agents/skills/. Si vous avez activé la lecture de la configuration Claude Code, .claude/skills/ et ~/.claude/skills/ sont également analysés.
Skills au niveau du système (Enterprise)
| OS | Path |
|---|
| macOS | /Library/Application Support/Windsurf/skills/ |
| Linux/WSL | /etc/windsurf/skills/ |
| Windows | C:\ProgramData\Windsurf\skills\ |
SKILL.md, comme pour les skills du workspace.
Créez un skill avec des scripts de déploiement, des configurations d’environnement et des procédures de restauration :
.windsurf/skills/deploy-staging/
├── SKILL.md
├── pre-deploy-checks.sh
├── environment-template.env
└── rollback-steps.md
Directives pour la revue de code
.windsurf/skills/code-review/
├── SKILL.md
├── style-guide.md
├── security-checklist.md
└── review-template.md
.windsurf/skills/run-tests/
├── SKILL.md
├── test-template.py
├── coverage-config.json
└── ci-workflow.yaml
-
Rédigez des descriptions claires : La description permet à Cascade de déterminer quand invoquer la skill. Soyez précis sur ce que fait la skill et dans quelles situations elle doit être utilisée.
-
Incluez les ressources pertinentes : Des modèles, des checklists et des exemples rendent les skills plus utiles. Réfléchissez aux fichiers qui aideraient quelqu’un à accomplir la tâche.
-
Utilisez des noms explicites :
deploy-to-staging est préférable à deploy1. Les noms doivent indiquer clairement ce que fait la skill.
Skills vs règles vs workflows
| Skills | Règles | Workflows |
|---|
| Objectif | Procédures en plusieurs étapes avec fichier associé | Règles de comportement (“comment se comporter”) | Modèles de prompt pour des tâches répétables |
| Structure | Dossier avec SKILL.md + fichier de ressources éventuel | Fichier .md unique avec frontmatter | Fichier .md unique |
| Invocation | Le modèle décide (révélation progressive) ou via @mention | always_on / glob / model_decision / manual | Manuelle uniquement via /slash-command |
| Dans le prompt système ? | Non — uniquement le nom + la description jusqu’à l’invocation | Dépend du mode d’activation | Non — listés comme commandes disponibles |
| Idéal pour | Déploiements, revues de code, procédures de test nécessitant des scripts/modèles | Style de code, conventions du projet, contraintes | Runbooks ponctuels que vous déclenchez explicitement |
- Workflows - Automatisez les tâches répétitives avec des workflows Markdown réutilisables déclenchés via des slash commands
- AGENTS.md - Fournissez des instructions à l’échelle d’un répertoire qui s’appliquent automatiquement en fonction de l’emplacement du fichier
- Memories & Rules - Conservez le contexte d’une conversation à l’autre grâce à des memories générées automatiquement et à des règles définies par l’utilisateur
