Claude · Eine eigene Skill bauen und packen

Eine Skill ist ein Ordner mit einer Datei SKILL.md im Wurzelverzeichnis, und genau diese Datei ist der Unterschied zwischen einem Claude, der Ihre Arbeit vage kennt, und einem Claude, der Ihre Arbeit zuverlässig so erledigt, wie Ihr Team es erwartet. Sie wissen schon, dass Claude Anweisungen in einem Prompt folgen kann. Eine Skill macht diese Anweisungen portabel, wiederverwendbar und lädt sie automatisch nur dann, wenn sie relevant sind.

Diese Lektion zeigt Ihnen die Anatomie einer eigenen Skill, geht eine echte durch (die Report-Vorlage Ihres Unternehmens) und gibt Ihnen eine saubere `SKILL.md`, die Sie kopieren können.

Was eine Skill tatsächlich ist

Eine Skill ist ein gepacktes Set an Anweisungen und optional unterstützenden Dateien, das Claude bei Bedarf lädt, wenn eine Aufgabe zu ihrer Beschreibung passt. Denken Sie an einen Ordner, den Claude „öffnen“ kann, wenn es entscheidet, dass die Arbeit ihn erfordert.

Die minimal funktionsfähige Skill ist eine einzige Datei:

report-template/
└── SKILL.md

Das ist eine vollständige, gültige Skill. Alles andere ist optional.

Der entscheidende Mechanismus: Claude liest nicht permanent den vollen Inhalt jeder Skill. Es liest die Metadaten (Name und Beschreibung) der verfügbaren Skills und zieht den vollständigen Body der SKILL.md sowie Hilfsdateien nur dann in den Kontext, wenn eine Anfrage passt. Das nennt man progressive disclosure, und deshalb skalieren Skills besser als ein gigantischer System-Prompt. Sie kkDie durchschnittliche Zahl neuer Nutzer, die jeder bestehende Nutzer über Empfehlungen generiert. Über 1,0 verstärkt sich das Wachstum selbst und wird exponentiell.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 liegt unter docs.claude.com/en/docs/agents-and-tools/agent-skills. Setzen Sie ein Bookmark; das Format entwickelt sich weiter.

Die Anatomie von SKILL.md

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

Das Frontmatter trägt die zwei Felder, die am meisten zählen:

• `name`: ein kurzer, menschenlesbarer Identifier.
• `description`: ein bis zwei Sätze, die sagen, WAS die Skill tut und, entscheidend, WANN sie 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 die Skill überhaupt geladen wird. Steht in Ihrer Beschreibung „Formatiert Reports“, hat Claude keinen Trigger. Steht dort „Verwenden, wenn der Nutzer darum bittet, einen Quartals- oder Monatsbericht im Acme-Hausstil zu schreiben, zu formatieren oder zu finalisieren“, weiß Claude genau, wann es danach greifen soll.

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

Der Body

Unter dem Frontmatter enthält der Markdown-Body die eigentlichen Anweisungen: die Regeln, die Struktur, das Do's and Don'ts, Beispiele. Hier steht die Substanz, die Claude liest, sobald die Skill ausgelöst wurde.

Bleiben Sie fokussiert. Wenn der Body aufquillt, verlagern Sie Details in Hilfsdateien und verweisen darauf.

Hilfsdateien

Eine Skill kann mit unterstützenden Dateien in ihrem Ordner ausgeliefert werden:

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

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

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

Eine konkrete Skill: die Report-Vorlage des Unternehmens

Nehmen wir an, Ihr Unternehmen erstellt ein monatliches Business Review. Jedes hat die gleichen Abschnitte, den gleichen Ton, eine verpflichtende Executive Summary mit maximal fünf Bullets und die Regel, dass alle Dollarbeträge Year-over-Year-Deltas zeigen. Neue Mitarbeitende machen es monatelang falsch.

Sie könnten diese Regeln in jeden Prompt kopieren. Eine Skill ist besser, weil die Regeln an einer versionierten Stelle 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.

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

Achten Sie darauf, was der Body tut. ErErDas Verhältnis von Interaktionen (Likes, Kommentare, Shares) zur Reichweite eines Inhalts. Zeigt, wie stark die Zielgruppe reagiert, gemessen an der Zahl der Personen, die den Inhalt gesehen haben.Vollständige Definition ansehen → ist konkret und überprüfbar. „Cut filler adjectives“ ist eine Regel, nach der Claude handeln kann. „Mach es gut“ ist keine.

Wann eine Skill besser ist als ein überladener Prompt

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

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

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

Kontexteffizienz. Einen Styleguide mit 2.000 Wörtern in jeden Prompt zu kopieren verbrennt TokensTokensEin Token ist die grundlegende Texteinheit, die Sprachmodelle verarbeiten, oft ein Wortfragment, ein ganzes Wort oder ein Satzzeichen und nicht ein einzelnes Zeichen.Vollständige Definition ansehen → in jedem Turn, auch wenn die Konversation zu unverwandten Themen abdriftet. Eine Skill lädt nur beim Trigger, Ihr Kontextfenster bleibt schlank.

Versionierung und Ownership. Eine Skill ist ein Ordner, also lebt sie in Git. Sie prüfen Änderungen in einem Pull Request, rollen eine schlechte Bearbeitung zurück und behalten eine einzige Quelle der Wahrheit. Prompts, die über die Notizen einzelner Personen verstreut sind, driften auseinander.

Mitgelieferte Assets und Code. Ein Prompt ist nur Text. Eine Skill kann eine echte template.docx, Beispiel-Outputs und ausführbare Validierungsskripte mitbringen.

Der ehrliche Tradeoff: eine Skill ist mehr Setup. Für eine Einmalaufgabe, die Sie nie wiederholen, prompten Sie einfach. Greifen Sie zur Skill, wenn eine Aufgabe wiederkehrend ist, eine richtige Antwort hat und die Regeln stabil genug sind, dass Pflege sich lohnt.

Wo Ihre Skill läuft

Dasselbe SKILL.md-Format funktioniert über die Anthropic-Oberflächen hinweg, und genau darum geht es beim einmaligen Packen.

• In den Claude-Apps (Web, Desktop, Mobile) können Sie Skills hinzufügen, sodass sie in Ihren Chats und Projects gelten.
• 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 eigenen Agenten dauerhafte Fähigkeiten geben, ohne bei jedem Call den System-Prompt neu zu schreiben.

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

Eine Anmerkung zu den Nachbarn in diesem Ökosystem. Eine Skill sind Anweisungen und Assets. Das Model Context Protocol (MCP), dokumentiert unter modelcontextprotocol.io, ist der Weg, über den Claude sich per Connectors mit lebenden Tools und Datenquellen verbindet (Ihre Datenbank, Ihr Ticketsystem). Sie ergänzen sich: eine Skill kann Claude sagen, *wie* ein Report formatiert wird, während ein MCPMCPEin offener Standard, mit dem KI-Assistenten einheitlich und kontrolliert an die Werkzeuge und Daten des Unternehmens angebunden werden, statt jede Integration einzeln zu bauen.Vollständige Definition ansehen → Connector Claude die aktuellen Metriken liefert, die hineingehören. Verwenden Sie eine Skill nicht, um eine Datenverbindung zu simulieren, und einen Connector nicht, um Stilregeln zu tragen.

Packen und ausliefern

Wenn der Ordner stimmt, ist das Packen vor allem Disziplin.

Halten Sie `SKILL.md` kurz, verlagern Sie Details nach unten. Der Body sollte scanbar sein. Wächst ein Abschnitt über eine Bildschirmhöhe, verlagern Sie ihn in eine referenzierte Hilfsdatei. Claude liest den Body zur Orientierung und öffnet Helper nach Bedarf.

Testen Sie den Trigger, nicht nur den Output. Schreiben Sie drei realistische Anfragen, die ein Nutzer tippen könnte, und prüfen Sie, ob Claude die Skill für jede tatsächlich lädt. Feuert sie nicht bei „stell das MBR für diesen Monat zusammen“, fehlt Ihrer Beschreibung eine Trigger-Formulierung. Reparieren Sie die Beschreibung, bevor Sie den Body anfassen.

Machen Sie Skripte ausführbar und abhängigkeitsarm. Ein validate.py, das zehn Pakete braucht, scheitert in der Hälfte Ihrer Umgebungen. Wo möglich Standard Library.

Versionieren Sie sie in Git. Behandeln Sie den Skill-Ordner wie Code. Die offiziellen Anthropic-Repos unter github.com/anthropics enthalten Beispiel-Skills und die SDKs, deren Struktur und Konventionen ein Studium wert sind.

Schreiben Sie für die Failure Modes des Modells. Neigt Claude dazu, sich zu verklausulieren, soll Ihr Body „no hedging“ sagen. Neigt es dazu, Zahlen zu erfinden, ergänzen Sie eine explizite Regel „never invent numbers“ mit einer [TK]-Platzhalter-Konvention, wie im Beispiel oben. Sie kodieren die Korrekturen, die Sie andernfalls jedes Mal tippen würden.

Eine schnelle Iterationsschleife

Der schnellste Weg, eine Skill richtig zu bekommen:

1. Entwerfen Sie SKILL.md mit einer scharfen Beschreibung und einem minimalen Body.
2. Werfen Sie drei echte Anfragen darauf und beobachten Sie, ob sie triggert.
3. Lesen Sie den Output 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 der Output ohne Ihr Eingreifen besteht.

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

Key Takeaways

• Eine Skill ist ein Ordner mit einer SKILL.md im Wurzelverzeichnis; eine einzelne Datei mit name- und description-Frontmatter ist bereits eine gültige Skill.
• Die description ist Routing-Logik, kein Label: benennen Sie die Verben, Dokumenttypen und Trigger, damit Claude die Skill genau dann lädt, wenn es soll.
• Wählen Sie eine 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 verlagern 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.