Skip to main content
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)

  1. Öffne das Cascade-Panel
  2. Klicke auf die drei Punkte oben rechts im Panel, um das Customizations-Menü zu öffnen
  3. Klicke auf den Bereich Skills
  4. Klicke auf + Workspace, um einen Workspace-spezifischen Skill zu erstellen, oder auf + Global, um einen globalen Skill zu erstellen
  5. Gib dem Skill einen Namen (nur Kleinbuchstaben, Ziffern und Bindestriche)

​
Manuelle Erstellung

Workspace-Skill (projektspezifisch):
  1. Erstellen Sie ein Verzeichnis: .windsurf/skills/<skill-name>/
  2. Legen Sie eine SKILL.md-Datei mit YAML-Frontmatter an
Globaler Skill (in allen Workspaces verfügbar):
  1. Erstellen Sie ein Verzeichnis: ~/.codeium/windsurf/skills/<skill-name>/
  2. Legen Sie eine SKILL.md-Datei mit YAML-Frontmatter an

​
SKILL.md-Dateiformat

Jeder Skill benötigt eine SKILL.md-Datei mit YAML-Frontmatter, die die Metadaten des Skills enthält:

​
Beispiel-Skill

​
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

Platziere alle unterstützenden Dateien im Skill-Ordner neben SKILL.md. Diese Dateien werden für Cascade verfügbar, wenn der Skill aufgerufen wird:

​
Skills aufrufen

​
Automatisches Aufrufen

Wenn deine Anfrage mit der Beschreibung eines Skills übereinstimmt, ruft Cascade den Skill automatisch auf und verwendet dessen Anweisungen und Ressourcen, um die Aufgabe zu erledigen. Dies ist die am häufigsten genutzte Art, Skills zu verwenden – du beschreibst einfach, was du tun möchtest, und Cascade bestimmt, welche Skills relevant sind. Das Feld 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.

​
Manuelles Auslösen

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.

​
Skill-Geltungsbereiche

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)

Enterprise-Organisationen können Skills bereitstellen, die in allen Workspaces verfügbar sind und nicht von Endnutzern geändert werden können: Jeder Skill ist ein Unterverzeichnis mit einer Datei namens SKILL.md, genau wie bei Workspace-Skills.

​
Anwendungsbeispiele

​
Bereitstellungs-Workflow

Erstelle einen Skill mit Bereitstellungsskripten, Umgebungskonfigurationen und Rollback-Verfahren:

​
Richtlinien für Code-Reviews

Fügen Sie Styleguides, Sicherheitschecklisten und Review-Vorlagen hinzu:

​
Testverfahren

Bündeln Sie Testvorlagen, Anforderungen an die Testabdeckung und CI/CD-Konfigurationen:

​
Best Practices

  1. 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.
  2. Relevante Ressourcen einbeziehen: Vorlagen, Checklisten und Beispiele machen Skills nützlicher. Überlege, welche Dateien jemandem helfen würden, die Aufgabe zu erledigen.
  3. 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

Alle drei passen Cascade an, unterscheiden sich aber in Struktur, Aufruf und Kontextkosten: Faustregel: Wenn Cascade es automatisch aufgreifen soll und unterstützende Dateien benötigt, verwende einen Skill. Wenn es eine kurze Verhaltensvorgabe ist, verwende eine Rule. Wenn du es immer selbst auslösen möchtest, verwende einen Workflow. Wenn Skills nicht das sind, was Sie suchen, sehen Sie sich diese anderen Cascade-Funktionen an:
  • 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