Einen eigenen Skill bauen

Status: Draft · Lernzeit etwa 80 Minuten plus Testlauf
Mission: Einen kleinen procedural skill aus einem belegten wiederkehrenden Job bauen und prüfen.

Was du danach kannst

Du kannst einen Skill so schneiden, dass Trigger, Schritte, Ressourcen, Completion Criteria und Recovery einen wiederholbaren Prozess ergeben. Ein Test mit neuem Input zeigt, ob der Skill wirklich trägt.

1 · Arbeitsproblem

Viele Skills entstehen als Sammlung aller Hinweise zu einem Thema. Der Agent liest viel und weiß trotzdem nicht, welche Reihenfolge gilt oder wann die Arbeit fertig ist. Ein guter Skill braucht einen engen Job und einen beobachtbaren Ablauf.

2 · Skill-Vertrag

Trigger → Schritte → Feedback → Completion Criteria
             ↘ Ressourcen bei Bedarf
             ↘ Stop → Recovery

Der Skill stabilisiert den Prozess. Fachliche Wahrheit, Kundendaten und aktuelle Produktdetails bleiben in den jeweils zuständigen Quellen.

3 · User-invoked oder model-invoked

Variante	Vorteil	Preis	Passender Einsatz
User-invoked	startet nur bewusst	Mensch muss den Namen kennen	Orchestration, seltene oder weitreichende Jobs
Model-invoked	Agent kann den Skill passend wählen	Beschreibung belegt Context und kann falsch triggern	häufige Disziplin mit klarer Jobklasse

Zu viele manuelle Skills werden schwer merkbar. Dann hilft ein kleiner Router, der auf die passenden Skills verweist. Zu viele automatische Skills erhöhen Context Load. Die kleinste verständliche Sammlung gewinnt.

4 · Baufolge

1. Belegten Job wählen: mindestens zwei ähnliche Runs und ein sichtbarer Engpass im Prozess.
2. Leading Word finden: ein klarer Begriff aus der Arbeitssprache verankert Trigger und Ablauf.
3. Invocation festlegen: user- oder model-invoked begründet wählen.
4. Schritte schreiben: jede Handlung endet mit einem prüfbaren Completion Criterion.
5. Ressourcen auslagern: Vorlagen, lange Regeln und branchenspezifische Referenzen hinter Context Pointern halten.
6. Feedback einbauen: Preview, Test, Diff oder menschliches Urteil.
7. Recovery schreiben: Stop, Diagnose, letzter guter Stand, begrenzter Neustart.
8. Prüfen und kürzen: Duplikate, No-ops und veraltete Sedimente entfernen.
9. Mit neuem Input testen: gleicher Prozess, anderes Ergebnis.

5 · Minimaler Aufbau

---
name: kurzer-skill-name
description: Was der Skill tut und bei welcher Jobklasse er startet.
---

# Skill-Name

## Prozess
1. Erster Schritt. Fertig, wenn …
2. Zweiter Schritt. Fertig, wenn …

## Feedback
Preview oder Test, der den Lauf beobachtbar macht.

## Recovery
Stop, Diagnose und Rückkehr zum letzten guten Stand.

Die konkrete Frontmatter hängt von der Runtime ab. Vor Installation gilt deren aktuelle Spezifikation.

6 · Demonstration: Story-Entwurf

Der belegte Job lautet: Aus freigegebenem C0-Rohmaterial entsteht ein Story-Entwurf mit drei Frames.

• Trigger: „Story aus freigegebenem Rohmaterial vorbereiten“.
• Schritte: Quelle prüfen, Kernaussage wählen, drei Frames schreiben, Tonkarte anwenden, Preview erzeugen.
• Ressourcen: Tonkarte und Frame-Vorlage.
• Completion Criteria: drei lesbare Frames, Quelle benannt, keine neuen Tatsachen, Preview vorhanden.
• Recovery: bei unbelegter Aussage stoppen und zur Quelle zurückgehen.
• Human Gate: Veröffentlichung bleibt außerhalb des Skills.

7 · Eigene Aufgabe

Fülle den Skill Builder aus und baue danach nur die kleinste lauffähige Fassung.

Teste drei Fälle:

1. Normalfall: Der Skill soll starten und den Ablauf vollständig fahren.
2. Grenzfall: Der Input ist unvollständig; der Skill soll fragen oder stoppen.
3. Gegenbeispiel: Ein ähnlicher Auftrag gehört nicht zu diesem Skill; er soll nicht starten.

8 · Lern- und Betriebsbeweis

Beleg	Mindestanforderung
Artefakt	Skill-Datei plus nur benötigte Ressourcen
Erklärung	Invocation, Leading Word und Completion Criteria in eigenen Worten
Wiederholung	zweiter Run mit neuem C0-Input
Recovery	ein absichtlich fehlerhafter Input wurde sicher gestoppt
Pflege	Owner und nächstes Review stehen fest

9 · Fehlerweg

• Premature completion: Kriterien schärfen, bevor der Ablauf weiter zerlegt wird.
• Sprawl: Referenzen hinter Pointer legen und Branches trennen.
• Duplication: jede Regel an einer maßgeblichen Stelle halten.
• No-op: Sätze entfernen, die das Verhalten nicht verändern.
• Falscher Trigger: Beschreibung mit echter Jobklasse und Ausnahmen neu schreiben.

10 · Datenwand und Freigabe

Der erste Test nutzt C0-Material und einen isolierten Arbeitsraum. Skripte, Connectoren, Installationen und externe Writes werden separat geprüft. Ein funktionierender Skill erhält erst nach Review einen Platz im produktiven Harness.

11 · Quellen

• Matt Pocock: Skills for Real Engineers
• Anthropic: Skill-Struktur
• Anthropic Skills Repository

Prüfdatum für Produktaussagen: 12. Juli 2026.