Eigene Skills bauen und paketieren

# Eigene Skills bauen und paketieren

Ein Skill ist ein Ordner mit einer SKILL.md-Datei im Wurzelverzeichnis, und genau diese eine Datei entscheidet darüber, ob Claude nur ungefähr weiß, was Sie tun, oder Ihre Arbeit zuverlässig so erledigt, wie Ihr Team es erwartet. Sie wissen bereits, dass Claude Anweisungen in einem Prompt befolgen kann. Ein Skill macht diese Anweisungen portabel, wiederverwendbar und lädt sie automatisch nur dann, wenn sie relevant sind.

Diese Lektion zeigt Ihnen den Aufbau eines Custom Skills, geht ein reales Beispiel durch (die Report-Vorlage Ihres Unternehmens) und gibt Ihnen eine saubere SKILL.md zum Kopieren.

Was ein Skill tatsächlich ist

Ein Skill ist ein paketiertes Set von Anweisungen und optional unterstützenden Dateien, das Claude bei Bedarf lädt, wenn eine Aufgabe zur Beschreibung passt. Stellen Sie es sich als Ordner vor, den Claude „öffnen“ kann, wenn es entscheidet, dass die Arbeit ihn erfordert.

Der minimal funktionsfähige Skill ist eine einzige Datei:

report-template/
└── SKILL.md

Das ist ein vollständiger, gültiger Skill. Alles andere ist optional.

Der entscheidende Mechanismus: Claude liest nicht ständig den vollständigen Inhalt jedes Skills. Es liest die Metadaten (Name und Beschreibung) der verfügbaren Skills und zieht den vollständigen SKILL.md-Body samt Hilfsdateien erst dann in den Kontext, wenn eine Anfrage passt. Das nennt sich Progressive Disclosure, und deshalb skalieren Skills besser als ein riesiger System-Prompt. Sie kkThe average number of new users each existing user generates through referrals. Above 1.0, growth compounds on itself and becomes exponential.Vollständige Definition ansehen →önnen zwanzig Skills installiert haben und zahlen die Kontextkosten nur für die, die eine bestimmte Aufgabe auslöst.

Die offizielle Referenz finden Sie unter docs.claude.com/en/docs/agents-and-tools/agent-skills. Setzen Sie ein Lesezeichen; das Format entwickelt sich weiter.

Der Aufbau von SKILL.md

SKILL.md ist eine Markdown-Datei mit einem YAML-Frontmatter-Block am Anfang (der Abschnitt zwischen den ----Zeilen), gefolgt von frei formulierten Markdown-Anweisungen.

Das Frontmatter enthält die zwei wichtigsten Felder:

• `name`: eine kurze, menschenlesbare Kennung.
• `description`: ein oder zwei Sätze, die sagen, WAS der Skill tut und, ganz wesentlich, WANN ererThe ratio of interactions (likes, comments, shares) to reach for a given piece of content, used to gauge how well audiences respond relative to how many people saw it.Vollständige Definition ansehen → zu verwenden ist.

Den zweiten Teil machen die meisten falsch. Die Beschreibung ist kein Marketingtext für Menschen. Sie ist die Routing-Logik, mit der Claude entscheidet, ob der Skill überhaupt geladen wird. Wenn dort steht „Formatiert Reports“, hat Claude keinen Trigger. Wenn dort steht „Verwenden, wenn der Nutzer darum bittet, einen Quartals- oder Monatsbericht im Acme-Hausstil zu schreiben, zu formatieren oder finalisieren“, weiß Claude genau, wann es danach greifen soll.

Schreiben Sie die Beschreibung wie ein Dispatcher: Nennen Sie die Trigger, die Dokumenttypen, die Verben.

Der Body

Unterhalb des Frontmatters enthält der Markdown-Body die eigentlichen Anweisungen: die Regeln, die Struktur, Do's und Don'ts, Beispiele. Hier steht die Substanz, die Claude liest, sobald der Skill ausgelöst wurde.

Bleiben Sie fokussiert. Wenn der Body aufgeht wie ein Hefeteig, verschieben Sie Details in Hilfsdateien und verweisen darauf.

Hilfsdateien

Ein Skill kann unterstützende Dateien in seinem Ordner mitbringen:

• Eine template.md oder template.docx, der Ihre Reports entsprechen müssen.
• Einen Ordner examples/ mit zwei oder drei Musterergebnissen.
• Skripte, etwa ein validate.py, das einen Entwurf gegen Formatierungsregeln prüft.
• Referenzdaten, etwa eine approved-language.md mit compliance-sicheren Formulierungen.

Claude kann diese Dateien lesen, wenn der Skill aktiv ist, und in Ausführungsumgebungen wie Claude Code oder dem Agent SDK auch Skripte ausführen, die Sie mitliefern. Sie verweisen aus dem Body darauf, damit Claude weiß, dass es sie gibt und wofür jede da ist.

report-template/
├── SKILL.md
├── template.md
├── examples/
│   └── q3-sample.md
└── scripts/
    └── validate.py

Ein konkreter Skill: die Report-Vorlage des Unternehmens

Angenommen, Ihr Unternehmen erstellt ein monatliches Business Review. Jedes hat dieselben Abschnitte, denselben Ton, eine Pflicht-Executive-Summary mit maximal fünf Bullets und die Regel, dass alle Dollarbeträge Year-over-Year-Deltas zeigen. Neue Mitarbeiter machen es monatelang falsch.

Sie kkThe average number of new users each existing user generates through referrals. Above 1.0, growth compounds on itself and becomes exponential.Vollständige Definition ansehen →önnten diese Regeln in jeden Prompt kopieren. Ein Skill ist besser, weil die Regeln an einem versionierten Ort liegen, automatisch laden, wenn jemand einen Report schreibt, und sich für alle aktualisieren, wenn Sie die Datei bearbeiten.

Hier eine saubere, vollständige SKILL.md dafür:

---
name: acme-monthly-report
description: >
  Use when the user asks to write, draft, format, or finalize Acme's
  monthly business review (MBR) or any monthly/quarterly business report
  in Acme house style. Applies the standard section structure, tone, and
  financial formatting rules.
---

# Acme Monthly Business Review

Apply these rules when producing an Acme MBR.

## Required structure (in order)

1. **Executive Summary** — max 5 bullets, each one sentence.
2. **Key Metrics** — table of metric, current value, YoY delta.
3. **Wins** — 3 to 5 items, outcome-focused.
4. **Risks & Mitigations** — each risk paired with an owner.
5. **Next Month's Priorities** — max 3, each with a measurable target.

## Formatting rules

- Every dollar or percentage figure must show a year-over-year delta
  in parentheses, e.g. `$1.2M (+14% YoY)`.
- Use the company template in `template.md` as the skeleton.
- Tone: direct, no hedging. Cut filler adjectives.
- Never invent numbers. If a metric is missing, write `[TK: source needed]`.

## Before finishing

Run `scripts/validate.py` against the draft and fix any flagged issues.

Beachten Sie, was die Beschreibung leistet. Sie listet die Verben („write, draft, format, finalize“), den Dokumentnamen und sein Akronym („monthly business review (MBR)“) und die Varianten („monthly/quarterly business report“). Damit hat Claude mehrere Wege, eine echte Nutzeranfrage zu matchen.

Beachten Sie, was der Body leistet. ErErThe ratio of interactions (likes, comments, shares) to reach for a given piece of content, used to gauge how well audiences respond relative to how many people saw it.Vollständige Definition ansehen → ist spezifisch und überprüfbar. „Cut filler adjectives“ ist eine Regel, nach der Claude handeln kann. „Mach es gut“ nicht.

Wann ein Skill besser ist als ein vollgestopfter Prompt

Beide Ansätze legen Claude Anweisungen vor. Die Unterschiede sind operativ.

Wiederverwendung. Ein Prompt stirbt, wenn die Konversation endet. Ein Skill liegt in einem Ordner und greift jedes Mal, in jedem Chat, für jeden, der ihn installiert hat.

Automatisches Triggern. Bei einem Prompt muss der Nutzer daran denken, die Regeln mitzugeben. Bei einem Skill lädt Claude sie, wenn die Aufgabe zur Beschreibung passt. Der neue Kollege, der gar nicht weiß, dass es die Regeln gibt, bekommt sie trotzdem angewendet.

Kontexteffizienz. Einen Styleguide mit 2.000 Wörtern in jeden Prompt zu kopieren verbrennt TokensTokensA token is the basic unit of text that language models process, often a word fragment, whole word, or punctuation mark rather than a single character.Vollständige Definition ansehen → in jedem Turn, auch wenn das Gespräch zu ganz anderen Themen abdriftet. Ein Skill lädt nur bei Trigger, Ihr Kontextfenster bleibt schlank.

Versionierung und Ownership. Ein Skill ist ein Ordner, also lebt ererThe ratio of interactions (likes, comments, shares) to reach for a given piece of content, used to gauge how well audiences respond relative to how many people saw it.Vollständige Definition ansehen → in Git. Sie prüfen Änderungen in einem Pull Request, rollen eine schlechte Änderung zurück und behalten eine einzige Source of Truth. Prompts, die über die Notizen verschiedener Leute verstreut sind, driften auseinander.

Mitgelieferte Assets und Code. Ein Prompt ist nur Text. Ein Skill kann ein echtes template.docx, Beispielergebnisse und ausführbare Validierungsskripte mitbringen.

Der ehrliche Tradeoff: Ein Skill bedeutet mehr Setup. Für eine einmalige Aufgabe, die Sie nie wiederholen, prompten Sie einfach. Greifen Sie zum Skill, wenn eine Aufgabe wiederkehrend ist, eine richtige Antwort hat und die Regeln stabil genug sind, um die Pflege zu rechtfertigen.

Wo Ihr Skill läuft

Dasselbe SKILL.md-Format funktioniert über alle Anthropic-Oberflächen hinweg, und genau darum paketiert man es einmal.

• In den Claude-Apps (Web, Desktop, Mobile) kkThe average number of new users each existing user generates through referrals. Above 1.0, growth compounds on itself and becomes exponential.Vollständige Definition ansehen →önnen Sie Skills hinzufügen, sodass sie in Ihren Chats und Projects greifen.
• In Claude Code liegen Skills neben Ihrem Repo und triggern bei Coding- und Dokumentaufgaben im Terminal.
• Über das Claude Agent SDK und die Messages API sind Skills Teil davon, wie Sie einem managed oder custom Agent dauerhafte Fähigkeiten geben, ohne bei jedem Call den System-Prompt neu zu schreiben.

Wegen dieser Portabilität sind Beschreibung und Struktur so wichtig. Sie schreiben die Routing-Logik einmal, und sie funktioniert überall dort, wo der Skill geladen wird.

Eine Anmerkung zu den Nachbarn in diesem Ökosystem. Ein Skill sind Anweisungen und Assets. Das Model Context Protocol (MCP), dokumentiert unter modelcontextprotocol.io, ist der Weg, über den Claude sich per Connectors mit Live-Tools und Datenquellen verbindet (Ihre Datenbank, Ihr Ticketing-System). Sie ergänzen sich: Ein Skill kann Claude sagen, *wie* ein Report zu formatieren ist, während ein MCP-Connector Claude die Live-Metriken liefert, die hineingehören. Verwenden Sie keinen Skill, um eine Datenverbindung vorzutäuschen, und keinen Connector, um Stilregeln zu transportieren.

Paketieren und ausliefern

Sobald Ihr Ordner stimmt, ist Paketieren vor allem Disziplin.

Halten Sie `SKILL.md` kurz, schieben Sie Details nach unten. Der Body sollte überfliegbar sein. Wächst ein Abschnitt über eine Bildschirmseite hinaus, verschieben Sie ihn in eine referenzierte Hilfsdatei. Claude liest den Body zur Orientierung und öffnet Helper bei Bedarf.

Testen Sie den Trigger, nicht nur das Ergebnis. Schreiben Sie drei realistische Anfragen, die ein Nutzer tippen kkThe average number of new users each existing user generates through referrals. Above 1.0, growth compounds on itself and becomes exponential.Vollständige Definition ansehen →önnte, und prüfen Sie, ob Claude den Skill jedes Mal tatsächlich lädt. Feuert ererThe ratio of interactions (likes, comments, shares) to reach for a given piece of content, used to gauge how well audiences respond relative to how many people saw it.Vollständige Definition ansehen → bei „Stell mal das MBR für diesen Monat zusammen“ nicht, fehlt Ihrer Beschreibung eine Triggerphrase. Reparieren Sie die Beschreibung, bevor Sie den Body anfassen.

Machen Sie Skripte lauffähig und abhängigkeitsarm. Ein validate.py, das zehn Pakete braucht, scheitert in der Hälfte Ihrer Umgebungen. Wo möglich, Standardbibliothek.

Versionieren Sie in Git. Behandeln Sie den Skill-Ordner wie Code. Die offiziellen Anthropic-Repos unter github.com/anthropics enthalten Beispiel-Skills und die SDKs, die sich für Struktur und Konventionen zu studieren lohnen.

Schreiben Sie gegen die Failure Modes des Modells. Neigt Claude zu übermäßigem Absichern, sollte Ihr Body „no hedging“ sagen. Neigt es dazu, Zahlen zu erfinden, ergänzen Sie eine explizite Regel „never invent numbers“ mit einer [TK]-Platzhalterkonvention wie im Beispiel oben. Sie kodieren die Korrekturen, die Sie sonst jedes Mal tippen würden.

Eine schnelle Iterationsschleife

Der schnellste Weg zu einem guten Skill:

1. Entwerfen Sie SKILL.md mit einer scharfen Beschreibung und einem minimalen Body.

2. Werfen Sie drei echte Anfragen dagegen und beobachten Sie, ob ererThe ratio of interactions (likes, comments, shares) to reach for a given piece of content, used to gauge how well audiences respond relative to how many people saw it.Vollständige Definition ansehen → triggert.

3. Lesen Sie das Ergebnis gegen Ihren echten Standard. Notieren Sie jeden Fehlschlag.

4. Machen Sie aus jedem Fehlschlag eine konkrete Regel im Body oder eine neue Hilfsdatei.

5. Wiederholen, bis das Ergebnis ohne Ihr Zutun besteht.

Sie sind fertig, wenn ein Kollege, der die Regeln nie gesehen hat, allein durch Fragen einen korrekten Report bekommt.

Die wichtigsten Erkenntnisse

• Ein Skill ist ein Ordner mit einer SKILL.md im Wurzelverzeichnis; eine einzelne Datei mit name- und description-Frontmatter ist bereits ein gültiger Skill.
• Die description ist Routing-Logik, kein Etikett: Nennen Sie Verben, Dokumenttypen und Trigger, damit Claude den Skill genau dann lädt, wenn es soll.
• Wählen Sie einen Skill statt eines langen Prompts, wenn die Aufgabe wiederkehrend ist, eine richtige Antwort hat und die Regeln stabil genug sind, um sie in Git zu pflegen.
• Halten Sie SKILL.md kurz und schieben Sie Details in Hilfsdateien (Templates, Beispiele, Validierungsskripte), die der Body namentlich referenziert.
• Testen Sie den Trigger mit echten Nutzerformulierungen, bevor Sie den Body polieren, und liefern Sie den Ordner unter Versionskontrolle neben Ihrem übrigen Code aus.