Zum Inhalt springen
Pathrule

skills

Benenne die Aufgabe.
Nicht die Schritte.

Wiederverwendbare Skills für KI-Coding-Agenten: benannte Abläufe, die der Agent aufruft, statt die Schritte neu herzuleiten, sodass der vierte Schritt nicht mehr verloren geht.

Claude CodeBeispiel
Reproduziere die fehlgeschlagene Zahlung von gestern lokal.

Ohne

Event gefunden, Server gestartet und den Payload an den Webhook gesendet.

Webhook abgelehnt: Signaturprüfung fehlgeschlagen.3 von 5 Schritten

Mit dem Skill

Skill replay-stripe-webhook

  • Event per ID abgerufen
  • Lokales Signing-Secret geladen
  • Server mit aktivierten Webhooks gestartet
  • Mit frischem Idempotency-Key erneut abgespielt
  • Handler-Log geprüft

Handler hat 200 zurückgegeben.5 von 5 Schritten

Dieselben Schritte. Jede Woche.

  1. Woche 1du, an claude code

    „Version erhöhen, beide Marken bauen, hochladen, dann taggen.“

  2. Woche 2du, an codex

    „Erst die Version erhöhen. Dann beide Marken, nicht nur eine.“

  3. Woche 3du, an claude code

    „Du hast vor dem Hochladen getaggt. Schon wieder.“

  4. Woche 4du, an jeden Agenten

    ::release-mobile

3 Erklärungen1 Skillseitdem 0 Schritte vergessen

Das Signal ist nicht Komplexität, sondern Wiederholung. Ab mehr als drei Schritten oder bei einer festen Reihenfolge sollte es ein Skill sein. Darunter reicht eine Memory.

Die Beschreibung macht die Arbeit.

SKILL.md
---name: replay-stripe-webhookdescription: Eine Zahlung aus der Produktion gegen den lokalen Server erneut abspielen.---# Einen Stripe-Webhook erneut abspielen1. Event per ID abrufen2. Lokales Signing-Secret laden3. Mit frischem Idempotency-Key erneut abspielen
Prompt„Reproduziere die fehlgeschlagene Zahlung von gestern“
  • „Stripe-Helfer“stripe-helpersübergangen
  • „Eine Zahlung aus der Produktion gegen den lokalen Server erneut abspielen“replay-stripe-webhookaufgerufen

Ein Skill, den der Agent nie aufruft, hat meist ein Beschreibungsproblem. Benenne den Auslöser, nicht das Thema, sonst gewinnt der eigene Plan des Agenten.

Ein Skill. Jeder Pfad, der ihn braucht.

replay-stripe-webhook

Einmal auf Workspace-Ebene geschrieben. Überall angehängt, wo die Aufgabe anfällt, nie kopiert.

  • /services/billingangehängt
  • /services/webhooksangehängt
  • /apps/admin/paymentsangehängt
  • /apps/mobilenicht hier
erreicht
  • Claude Code.claude/skills
  • Codex.agents/skills
  • Cursor, Copilot, Windsurfüber MCP
manual
In Pathrule geschrieben
template
Eine Vorlage, hineinkopiert
github_ref
Abgerufen, dann zwischengespeichert

Wer nächsten Monat ins Team kommt, bekommt den Skill, ohne dass jemand sagen muss, dass es ihn gibt. Veraltete oder widersprüchliche Skills erscheinen als Vorschläge, und ein Mensch genehmigt die Korrektur.

Häufige Fragen.

Was ist ein Skill für KI-Agenten?

Ein benannter, wiederverwendbarer Ablauf, den ein KI-Coding-Agent aufrufen kann, statt die Schritte neu herzuleiten: einen Stripe-Webhook lokal erneut abspielen, die Seed-Fixtures neu erzeugen, die Pre-Release-Checkliste durchgehen. Der Inhalt ist eine kleine Markdown-Datei, deren Frontmatter den Skill benennt und beschreibt, wofür er gedacht ist.

Wann sollte etwas ein Skill sein und keine Memory?

Wenn es eine Abfolge ist und die Reihenfolge zählt. Greif zu einem Skill ab mehr als drei Schritten oder immer dann, wenn ein Teil eine „mach das in dieser Reihenfolge“-Anforderung enthält. Ein oder zwei Zeilen oder ein Fakt, den der Agent nur kennen statt ausführen muss, sind eine Memory.

Warum nutzt mein Agent den Skill nicht, den ich geschrieben habe?

Meistens sagt die Beschreibung nicht, wofür der Skill gedacht ist. Skills werden nach ihrer Beschreibung ausgewählt, deshalb verliert eine vage Beschreibung gegen den eigenen Standardplan des Agenten: Benenne den Auslöser statt des Themas. Die anderen häufigen Ursachen sind ein Geltungsbereich, der nie zu den Pfaden passt, auf denen die Aufgabe anfällt, und ein Ablauf, der noch eine echte Entscheidung in der Mitte hat. Ausführlich: warum Claude-Code-Skills nicht aktiviert werden.

Kann ein ganzes Team einen Skill gemeinsam nutzen?

Ja, und genau deshalb speichert man ihn außerhalb eines Prompts. Skills leben auf Workspace-Ebene und werden über eine Verknüpfung an Knoten gehängt, sodass ein Skill über viele Pfade wiederverwendet wird und der Agent jedes Teammitglieds ihn aufrufen kann. Organisationsmitgliedschaft und Workspace-Zugriff werden serverseitig durchgesetzt. Siehe Rollen und Berechtigungen.

Kann ich Skills nutzen, die jemand anderes veröffentlicht hat?

Ja. Ein Skill kann eine externe GitHub-URL als Quelle haben, und Pathrule ruft den Inhalt ab und speichert ihn zwischen. Die zwischengespeicherte Kopie ist der zuletzt ausgelieferte Snapshot, und der Workspace übernimmt Änderungen von upstream beim nächsten Refresh. Nutze das für Skills, die ein Ökosystem veröffentlicht, dem du vertraust.

Was ist der Unterschied zwischen einem Skill und einem Pathrule Pattern?

Ein Skill ist ein einzelner Ablauf. Ein Pattern ist ein kleines Bündel aus Memories, Regeln und Skills zu einem Thema, jedes Teil vorab auf den Pfad bezogen, zu dem es gehört, weil eine echte Konvention selten aus einer einzigen Datei besteht. Ausführlich: was ein Pathrule Pattern ist und warum es kein Skill ist.

Ersetzen Skills meine Prompts?

Nein, sie nehmen ihnen die Wiederholung. Ein Skill lohnt sich, wenn du merkst, dass du denselben Ablauf erneut erklärst. Der Prompt nennt dann die Aufgabe, statt sie zu beschreiben, und die Schritte driften nicht mehr von einer Erklärung zur nächsten auseinander.

Schreib die Schritte einmal auf.
Danach nennst du nur die Aufgabe.