Cascade Skills

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.

Comment créer une compétence

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)

Création manuelle

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

Format du fichier SKILL.md

Chaque skill doit avoir un fichier SKILL.md avec un front matter YAML contenant les métadonnées de la skill :

Exemple de compétence

---
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

Placez tous les fichiers associés dans le dossier de la skill, à côté de 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

Invocation automatique

Lorsque votre requête correspond à la description d’un skill, Cascade invoque automatiquement ce skill et utilise ses instructions et ressources pour accomplir la tâche. C’est la manière la plus courante d’utiliser les skills : vous décrivez simplement ce que vous voulez faire et Cascade détermine quels skills sont pertinents. Le champ 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é.

Invocation manuelle

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ées de skills

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)

Les organisations Enterprise peuvent déployer des skills disponibles dans tous les workspaces et qui ne peuvent pas être modifiés par les utilisateurs finaux :

OS	Path
macOS	`/Library/Application Support/Windsurf/skills/`
Linux/WSL	`/etc/windsurf/skills/`
Windows	`C:\ProgramData\Windsurf\skills\`

Chaque skill correspond à un sous-répertoire contenant un fichier SKILL.md, comme pour les skills du workspace.

Exemples de cas d’usage

Flux de déploiement

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

Incluez des guides de style, des listes de contrôle de sécurité et des modèles de revue de code :

.windsurf/skills/code-review/
├── SKILL.md
├── style-guide.md
├── security-checklist.md
└── review-template.md

Procédures de test

Regrouper les modèles de test, les exigences de couverture et les configurations CI/CD :

.windsurf/skills/run-tests/
├── SKILL.md
├── test-template.py
├── coverage-config.json
└── ci-workflow.yaml

Bonnes pratiques

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

Les trois permettent de personnaliser Cascade, mais diffèrent par leur structure, leur mode d’invocation et leur coût en contexte :

	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

Règle générale : si Cascade doit le prendre en compte automatiquement et qu’il nécessite un fichier associé, utilisez un Skill. S’il s’agit d’une courte contrainte de comportement, utilisez une règle. Si vous voulez toujours le déclencher vous-même, utilisez un Workflow. Si les Skills ne correspondent pas à ce que vous recherchez, consultez ces autres fonctionnalités de Cascade :

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

Éditeur

Cascade

Comptes

Gestion du contexte

Dépannage

Sécurité

Skills

Comment créer une compétence

Utiliser l’interface (le plus simple)

Création manuelle

Format du fichier SKILL.md

Exemple de compétence

Champs de frontmatter requis

Ajout de ressources supplémentaires

Utilisation des compétences

Invocation automatique

Invocation manuelle

Portées de skills

Skills au niveau du système (Enterprise)

Exemples de cas d’usage

Flux de déploiement

Directives pour la revue de code

Procédures de test

Bonnes pratiques

Skills vs règles vs workflows

​Comment créer une compétence

​Utiliser l’interface (le plus simple)

​Création manuelle

​Format du fichier SKILL.md

​Exemple de compétence

​Champs de frontmatter requis

​Ajout de ressources supplémentaires

​Utilisation des compétences

​Invocation automatique

​Invocation manuelle

​Portées de skills

​Skills au niveau du système (Enterprise)

​Exemples de cas d’usage

​Flux de déploiement

​Directives pour la revue de code

​Procédures de test

​Bonnes pratiques

​Skills vs règles vs workflows

​Documentation associée

Comment créer une compétence

Utiliser l’interface (le plus simple)

Création manuelle

Format du fichier SKILL.md

Exemple de compétence

Champs de frontmatter requis

Ajout de ressources supplémentaires

Utilisation des compétences

Invocation automatique

Invocation manuelle

Portées de skills

Skills au niveau du système (Enterprise)

Exemples de cas d’usage

Flux de déploiement

Directives pour la revue de code

Procédures de test

Bonnes pratiques

Skills vs règles vs workflows

Documentation associée