SKILL.md-Dateien in einem entsprechend benannten Verzeichnis definiert. Auf dieser Seite finden Sie alles, was Sie wissen müssen, um wirkungsvolle Skills zu schreiben.
Dateistruktur
/my-skill verwendet). Die Datei SKILL.md enthält optionales YAML-Frontmatter und den Prompt-Inhalt des Skills.
Unter Windows bezieht sich
%APPDATA% typischerweise auf C:\Users\<YourUser>\AppData\Roaming.Frontmatter-Referenz
Alle Frontmatter-Felder
Modell-Override
model, um ein Skill mit einem anderen Modell auszuführen als dem aktiven Modell der aktuellen Sitzung. Das ist nützlich, wenn Sie für einfache Aufgaben ein schnelleres Modell oder für komplexe Aufgaben ein leistungsfähigeres Modell verwenden möchten:
--model (z. B. opus, sonnet, swe, codex). Die vollständige Liste finden Sie unter Models. Nach Abschluss des Skills kehrt die Sitzung zum zuvor aktiven Modell zurück.
Skills als Subagents ausführen
subagent: true
subagent: true, um den Skill mit dem Standardprofil subagent_general als Subagent auszuführen:
agent: <profile>
agent, um den Skill als Subagent mit einem bestimmten benutzerdefinierten Subagent-Profil auszuführen:
agent muss dem Namen eines registrierten Subagent-Profils entsprechen (entweder eines integrierten Profils wie subagent_explore / subagent_general oder eines benutzerdefinierten Profils, das Sie definiert haben). Der Subagent übernimmt den System-Prompt, die Tool-Einschränkungen und das Modell des Profils — der Inhalt des Skills wird dabei zur Aufgabe.
Wenn sowohl
agent als auch subagent gesetzt sind, hat agent Vorrang. Das Feld model im Skill überschreibt das Modell des Subagent-Profils, wenn beide angegeben sind.Skills, die als Subagenten ausgeführt werden, erzeugen keine verschachtelten Subagenten — wenn ein Skill bereits innerhalb eines Subagenten ausgeführt wird, wird er stattdessen inline ausgeführt, um eine unendliche Rekursion zu verhindern.
Subagents mithilfe von Skills orchestrieren
/health-check führt den Orchestrator im Haupt-Agenten aus. Dabei wird /research-changes aufgerufen, das einen Subagenten startet, um das Repo zu untersuchen. Sobald das abgeschlossen ist, wird /validate-tests aufgerufen, das einen weiteren Subagenten startet, um die Tests auszuführen. Der Orchestrator führt anschließend beide Ergebnisse in einer abschließenden Zusammenfassung zusammen.
Ein Subagenten-Skill setzt beim Aufrufen anderer Skills niemals einen Subagenten ein, selbst wenn diese Skills subagent: true haben — sie werden stattdessen inline ausgeführt. Das bedeutet, dass du dir keine Gedanken über unbegrenzte Verschachtelung machen musst. Das Orchestrierungsmuster geht immer nur eine Ebene tief: Der Orchestrator startet Subagenten, und diese Subagenten führen alles andere inline aus.
Prompt-Inhalt
Berechtigungen
allow— Diese Geltungsbereiche werden bei der Skill-Ausführung automatisch freigegebendeny— Diese Geltungsbereiche werden bei der Skill-Ausführung blockiertask— Bei diesen Geltungsbereichen wird der Nutzer immer zur Bestätigung aufgefordert
Skill-Berechtigungen sind additiv zu den Basisberechtigungen der Sitzung (sie ersetzen sie nicht). Ein Skill kann keine Berechtigungen gewähren, die auf einer höheren Ebene verweigert werden (in der Projekt- oder Organisationskonfiguration).
Zulässige Tools
read, edit, grep, glob, exec
Sie können auch MCP-Tools zulassen:
Beispiele
Code-Review-Skill
Komponentengenerator
Bereitstellungs-Checkliste
Suchprofi
Tipps
Prompts fokussiert halten
Ein Skill sollte eine Sache gut machen. Erstelle mehrere Skills statt eines Mega-Skills.
Beispiele hinzufügen
Zeige dem Agenten in deinem Prompt, wie eine gute Ausgabe aussieht.
allowed-tools verwenden
Wenn du Tools einschränkst, werden Skills sicherer und vorhersehbarer.
Mit /skill-name testen
Führe deinen Skill aus und passe den Prompt iterativ an, bis die Ausgabe deinen Vorstellungen entspricht.

