Die schwierigsten Engineeringaufgaben erfordern oft mehr als nur gute Prompts. Sie können Referenzskripte, Vorlagen, Checklisten und andere unterstützende Dateien erfordern. Mit Skills können Sie all dies in Ordnern bündeln, die Cascade aufrufen (lesen und verwenden) kann.
Skills sind eine hervorragende Möglichkeit, Cascade beizubringen, mehrstufige Workflows konsistent auszuführen.
Cascade verwendet schrittweise Offenlegung: Standardmäßig werden dem Modell nur der name und die description des Skills angezeigt. Der vollständige Inhalt von SKILL.md und die zugehörigen Dateien werden nur geladen, wenn Cascade entscheidet, den Skill aufzurufen (oder wenn Sie ihn per @mention erwähnen). Dadurch bleibt Ihr Kontextfenster auch bei vielen definierten Skills schlank.
Weitere Details zur Skills-Spezifikation finden Sie auf agentskills.io.
So erstellen Sie einen Skill
Über die Benutzeroberfläche (am einfachsten)
- Öffne das Cascade-Panel
- Klicke auf die drei Punkte oben rechts im Panel, um das Customizations-Menü zu öffnen
- Klicke auf den Bereich
Skills
- Klicke auf
+ Workspace, um einen Workspace-spezifischen Skill zu erstellen, oder auf + Global, um einen globalen Skill zu erstellen
- Gib dem Skill einen Namen (nur Kleinbuchstaben, Ziffern und Bindestriche)
Workspace-Skill (projektspezifisch):
- Erstellen Sie ein Verzeichnis:
.windsurf/skills/<skill-name>/
- Legen Sie eine
SKILL.md-Datei mit YAML-Frontmatter an
Globaler Skill (in allen Workspaces verfügbar):
- Erstellen Sie ein Verzeichnis:
~/.codeium/windsurf/skills/<skill-name>/
- Legen Sie eine
SKILL.md-Datei mit YAML-Frontmatter an
Jeder Skill benötigt eine SKILL.md-Datei mit YAML-Frontmatter, die die Metadaten des Skills enthält:
---
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]
Erforderliche Frontmatter-Felder
- name: Eindeutiger Bezeichner für den Skill (wird in der UI angezeigt und für @-Erwähnungen verwendet)
- description: Kurze Erklärung, die dem AI-Modell angezeigt wird, um ihm zu helfen zu entscheiden, wann der Skill aufgerufen werden soll
Beispiele für gültige Namen: deploy-to-staging, code-review, setup-dev-environment
Hinzufügen unterstützender Ressourcen
SKILL.md. Diese Dateien werden für Cascade verfügbar, wenn der Skill aufgerufen wird:
.windsurf/skills/deploy-to-production/
├── SKILL.md
├── deployment-checklist.md
├── rollback-procedure.md
└── config-template.yaml
description im Frontmatter deines Skills ist entscheidend: Es hilft Cascade zu verstehen, wann der Skill aufgerufen werden soll. Schreibe Beschreibungen, die klar erklären, was der Skill macht und wann er verwendet werden sollte.
Sie können einen Skill jederzeit explizit auslösen, indem Sie @skill-name in das Cascade-Eingabefeld eingeben. Dies ist nützlich, wenn Sie sicherstellen möchten, dass ein bestimmter Skill verwendet wird, oder wenn Sie einen Skill ausführen möchten, der durch Ihre Anfrage möglicherweise nicht automatisch ausgelöst wird.
| Geltungsbereich | Speicherort | Verfügbarkeit |
|---|
| Workspace | .windsurf/skills/ | Nur aktueller Workspace. Mit Ihrem Repo versioniert. |
| Global | ~/.codeium/windsurf/skills/ | Alle Workspaces auf Ihrem Rechner. Nicht versioniert. |
| System (Enterprise) | Betriebssystemspezifisch (siehe unten) | Alle Workspaces, von der IT bereitgestellt. Schreibgeschützt. |
Für agentenübergreifende Kompatibilität erkennt Windsurf auch Skills in .agents/skills/ und ~/.agents/skills/. Wenn Sie das Lesen der Claude Code-Konfiguration aktiviert haben, werden außerdem .claude/skills/ und ~/.claude/skills/ durchsucht.
Skills auf Systemebene (Enterprise)
| OS | Pfad |
|---|
| macOS | /Library/Application Support/Windsurf/skills/ |
| Linux/WSL | /etc/windsurf/skills/ |
| Windows | C:\ProgramData\Windsurf\skills\ |
SKILL.md, genau wie bei Workspace-Skills.
Erstelle einen Skill mit Bereitstellungsskripten, Umgebungskonfigurationen und Rollback-Verfahren:
.windsurf/skills/deploy-staging/
├── SKILL.md
├── pre-deploy-checks.sh
├── environment-template.env
└── rollback-steps.md
Richtlinien für Code-Reviews
.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
-
Schreibe klare Beschreibungen: Die Beschreibung hilft Cascade dabei zu entscheiden, wann der Skill aufgerufen werden soll. Sei präzise darin, was der Skill macht und wann er verwendet werden sollte.
-
Relevante Ressourcen einbeziehen: Vorlagen, Checklisten und Beispiele machen Skills nützlicher. Überlege, welche Dateien jemandem helfen würden, die Aufgabe zu erledigen.
-
Aussagekräftige Namen verwenden:
deploy-to-staging ist besser als deploy1. Namen sollten klar erkennen lassen, was der Skill macht.
Skills vs Rules vs Workflows
| Skills | Rules | Workflows |
|---|
| Zweck | Mehrstufige Abläufe mit unterstützenden Dateien | Verhaltensregeln („wie sich Cascade verhalten soll“) | Prompt-Vorlagen für wiederholbare Aufgaben |
| Struktur | Ordner mit SKILL.md + beliebigen Ressourcendateien | Einzelne .md-Datei mit Frontmatter | Einzelne .md-Datei |
| Aufruf | AI-Modell entscheidet (schrittweise Offenlegung) oder @mention | always_on / glob / model_decision / manual | Nur manuell über /slash-command |
| Im System-Prompt? | Nein — nur Name + Beschreibung bis zum Aufruf | Hängt vom Aktivierungsmodus ab | Nein — als verfügbare Befehle aufgeführt |
| Am besten geeignet für | Deployments, Code-Reviews und Testverfahren, die Skripte/Vorlagen benötigen | Code-Stil, Projektkonventionen, Vorgaben | Einmalige Runbooks, die du explizit auslöst |
- Workflows - Automatisieren Sie wiederkehrende Aufgaben mit wiederverwendbaren Markdown-Workflows, die per Slash-Befehlen ausgelöst werden
- AGENTS.md - Stellen Sie verzeichnisspezifische Anweisungen bereit, die automatisch basierend auf dem Dateispeicherort angewendet werden
- Memories & Rules - Bewahren Sie Kontext über Unterhaltungen hinweg mit automatisch generierten Memories und benutzerdefinierten Regeln
