Skills schreiben

Ein Skill ist ein benannter Ablauf, den der Assistent aufrufen kann, statt die Schritte jedes Mal neu herzuleiten. Memories sagen dem Assistenten, was gilt. Regeln sagen ihm, was er nicht tun soll. Skills sagen ihm Schritt für Schritt, wie er eine bestimmte Aufgabe erledigt.

Diese Seite beschreibt, wann sich ein Skill lohnt, was hineingehört und wie Skills gespeichert und zugeordnet werden.

Wann sich ein Skill lohnt

Greif zu einem Skill, wenn du merkst, dass sich dasselbe Muster wiederholt. Das typische Signal: „Der Assistent geht immer wieder dieselben Schritte durch und vergisst manchmal einen.“

• Betriebliche Abläufe. „Einen Stripe-Webhook lokal erneut abspielen.“ „Die Seed-Fixtures neu erzeugen.“ „Die Checkliste vor dem Release abarbeiten.“
• Eigene Workflows. „Einen Draft-PR mit den richtigen Labels und den richtigen Reviewern öffnen.“ „Version hochzählen, taggen und pushen.“
• Domänenspezifische Anleitungen. „Ein neues Analytics-Event von Anfang bis Ende bauen: Spalte, Typ, Dashboard.“

Umfasst das Muster nur ein oder zwei Zeilen, reicht eine Memory. Ein Skill ist sinnvoll, wenn der Ablauf mehr als drei Schritte hat oder irgendeine Vorgabe der Art „in genau dieser Reihenfolge“ enthält.

Quellen

Jeder Skill-Eintrag hat einen Quellwert, der Pathrule sagt, wo sein Inhalt liegt.

• manual. Der Inhalt wird direkt in Pathrule geschrieben und unverändert gespeichert. Das ist der Standard. Nutze ihn, wenn der Ablauf vollständig dem Workspace gehören soll.
• template. Ein von Pathrule bereitgestellter Einstiegs-Skill, der in den Workspace kopiert wird und dort bearbeitet werden kann.
• github_ref. Der Skill verweist auf eine externe GitHub-URL. Nutze das für Skills aus Skill-Ökosystemen, denen du vertraust.

Bei github_ref-Skills speichert der Workspace einen Snapshot des Inhalts aus dieser Quelle, und der Skill ist im Workspace schreibgeschützt: VS Code weist dich darauf hin, stattdessen die Quelle zu bearbeiten.

Aufbau der SKILL.md

Ein Skill ist eine kleine Markdown-Datei mit Frontmatter, gefolgt vom eigentlichen Ablauf.

---
name: replay-stripe-webhook
description: Replay a Stripe webhook against the local server with the right signing secret and the right idempotency key handling.
---

# Replay a Stripe webhook

Use this when a payment event from production needs to be reproduced locally.

## When to invoke

- A customer reports a missing receipt and you have the event id.
- You are debugging a webhook handler change.

## Procedure

1. Find the event in Stripe Dashboard. Copy its id.
2. Run `stripe events resend evt_xxx --webhook-endpoint we_local`.
3. Watch the local handler. It must accept and process the event without double charging.
4. If the handler returns 5xx, the customer support page is the next stop, not a retry.

## What NOT to do

- Do not replay against production webhooks.
- Do not skip the idempotency key check.

Das Frontmatter muss name und description enthalten. Alles darunter ist der Inhalt, dem der Assistent folgt. Er darf so kurz oder so lang sein, wie es nötig ist.

Zuordnung

Ein Skill liegt an genau einem Workspace-Pfad, genau wie eine Regel. Leg ihn an den Pfad, an dem der Ablauf am relevantesten ist. Der Skill zum erneuten Abspielen von Webhooks gehört nach services/billing/webhooks. Der Release-Skill gehört ins Workspace-Root. Ein neuer Skill, dessen Name mit einem bestehenden Skill im Workspace übereinstimmt, wird abgelehnt. Aktualisiere also den bestehenden, statt eine zweite Kopie anzulegen.

Der Assistent findet Skills über den Kontext, den Pathrule für einen Pfad liefert (genau wie Memories und Regeln), also über pathrule_get_context, und liest einen Skill mit pathrule_read_skill vollständig. Beim Sync schreibt Pathrule Skills außerdem in die Skill-Ordner von Clients, die sie lesen, etwa .claude/skills für Claude Code und .agents/skills für Codex.

Einen Skill gezielt mit ::skill-name aufrufen

Normalerweise wählt der Assistent den passenden Skill selbst aus. Willst du einen bestimmten erzwingen, schreib an beliebiger Stelle in deinem Prompt :: gefolgt vom Skill-Namen, zum Beispiel ::release-check oder ::replay-stripe-webhook. Für diesen Durchgang behandelt der Assistent den genannten Skill als verbindlichen Workflow, ohne dass du lange Anweisungen schreiben musst. In Claude Code und Codex erkennt der Prompt-Hook die Markierung, bevor der Agent handelt; in anderen Clients erhält der Assistent dieselbe Anweisung, wenn er über MCP Kontext anfordert.

Das Verhalten ist auf Sicherheit ausgelegt:

• Passt der Name auf mehr als einen Skill, wird kein Skill aufgerufen, statt zu raten.
• Passt der Name auf keinen Skill, wird der Assistent angewiesen, anzuhalten und das mit dir zu klären, bevor er irgendetwas bearbeitet. Er kann veröffentlichte Kandidaten vorschlagen und wartet auf deine Zustimmung, bevor er einen davon zum Workspace hinzufügt.
• Code-artige Verwendungen von :: wie button::before oder std::vector werden ignoriert, damit normale Prompts nicht falsch gedeutet werden.

Damit ist ::skill-name ein schneller, pfadunabhängiger Weg, einen bekannten Team-Ablauf in den aktuellen Durchgang zu holen.

Ablauf beim Erstellen

Zwei Wege führen zum selben Ergebnis.

• Manuell erstellen. Nutze in VS Code am richtigen Pfad New Skill… und schreib den Inhalt der SKILL.md. Im Terminal führst du pathrule skill add --path /services/billing/webhooks --name replay-stripe-webhook --description "Replay a Stripe webhook locally" aus; ohne --body öffnet die CLI deinen Editor.
• Vom Assistenten erstellen lassen. In Claude Code (oder einem beliebigen MCP-Client) bittet die Nutzerin oder der Nutzer den Assistenten, „daraus einen Skill zu machen“. Der Assistent folgt einem kleinen Muster zur Skill-Erstellung: Absicht erfassen, die Person befragen, die SKILL.md entwerfen und dann pathrule_write_skill mit dem vollständigen Inhalt aufrufen.

Bei unverbindlicheren Szenarien entwirft der Assistent den Skill im Gespräch und wartet auf Zustimmung, bevor er pathrule_write_skill aufruft. Gespeichert wird also der geprüfte Entwurf, kein stiller Schreibvorgang im Hintergrund.

Versionierung und gleichzeitige Bearbeitung

Skills tragen wie Memories und Regeln ein Versions-Token. Bearbeiten zwei Teammitglieder denselben Skill, entsteht ein sauberer Konflikt, statt dass sie sich gegenseitig überschreiben. In VS Code stehen dir dabei dieselben Konfliktoptionen zur Verfügung wie bei einer Memory.

Anti-Patterns

• Skills, die eigentlich Memories sind. Lautet der Inhalt „so arbeiten wir, das gilt“, mach eine Memory daraus.
• Skills, die eigentlich Regeln sind. Lautet der Inhalt „tu niemals X“, mach eine Regel daraus.
• Ein Skill, der zu viel macht. Teil ihn in zwei benannte Skills auf, wenn der Ablauf zwei klar getrennte Einstiegspunkte hat.
• Externe Skills, denen du nicht vertraust. Ein github_ref-Skill ist Code, der in den Anweisungen deines Assistenten läuft. Behandle ihn wie eine Abhängigkeit.

Erstellen lokal und in der Cloud

Die add-Beispiele für das Terminal auf dieser Seite gelten für einen Cloud-Workspace. Im lokalen Modus legst du Einträge in Local Console, in VS Code oder über lokales MCP an und bearbeitest sie dort; die Wissensbefehle der CLI listen, lesen und durchsuchen sie.

Weiterlesen

• Memories schreiben für Fakten und Entscheidungen.
• Regeln schreiben für Einschränkungen.
• MCP-Tools-Referenz für die Tools, mit denen der Assistent Skills schreibt.