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.
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. Die allowed-tools eines benutzerdefinierten Profils stellen eine echte Einschränkung dar (nicht aufgeführte Tools stehen dem Subagenten nicht zur Verfügung) — auf diese Weise führen Sie einen Skill mit einem begrenzten Tool-Satz aus.
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
deny lässt sich ein Tool für einen Inline-Skill vollständig sperren. Einträge mit Tool-Namen wie exec oder edit blockieren das gesamte Tool, und mcp__server__tool-Muster blockieren MCP-Tools — siehe Tool-basierte Berechtigungen.
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).
Skill-Berechtigungen gelten nur, wenn der Skill inline ausgeführt wird. Sie werden nicht angewendet, wenn der Skill als Subagent ausgeführt wird (
subagent: true oder agent:).Automatisch genehmigte Tools
allowed-tools listet Tools auf, die während der Ausführung des Skills automatisch genehmigt sind, sodass der Agent sie ohne Berechtigungsabfrage verwenden kann:
permissions.allow-Eintrag für den jeweiligen Tool-Namen. Verfügbare Tool-Namen: read, edit, grep, glob, exec
Sie können auch MCP-Tools automatisch genehmigen:
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.
Verweigern, was ein Skill nicht tun darf
Verwende
permissions.deny (oder ein benutzerdefiniertes Subagent-Profil), um Tools zu blockieren. allowed-tools überspringt lediglich Prompts.Mit /skill-name testen
Führe deinen Skill aus und passe den Prompt iterativ an, bis die Ausgabe deinen Vorstellungen entspricht.

