Lesedauer 12 Minuten

Claude kann Briefe formulieren, Tabellen auswerten und lange Dokumente zusammenfassen. Wie dein Team auf Kundenbeschwerden antwortet, welche Floskeln bei euch tabu sind oder welche Vorlage die Buchhaltung für Berichte erwartet, weiß Claude aber nicht. Also erklärst du es jedes Mal neu, kopierst dieselben Anweisungen in den Chat und hoffst, dass diesmal nichts vergessen wird. Mit Agent Skills ist damit Schluss. Du schreibst dein Wissen einmal in einen Ordner, und Claude holt es sich, wenn es gebraucht wird.

Alles, was Du über Claude Skills wissen musst

In diesem Tutorial baust du Schritt für Schritt einen eigenen Skill, und zwar für eine Aufgabe, die fast jedes Unternehmen kennt: Kundenmails beantworten. Danach klären wir, in welchen Programmiersprachen du Hilfsskripte schreiben kannst und wie du den Überblick behältst, wenn aus einem Skill zehn werden. Für Fortgeschrittene zeige ich dir anschließend, wie du mehrere Skills zu einem Plugin schnürst und im ganzen Team verteilst. Am Ende gibt es noch ein paar Hinweise für alle, die entscheiden müssen, ob sich das Thema für ihr Team lohnt.

Was ist ein Agent Skill?

Ein Skill ist ein Ordner mit einer Datei namens SKILL.md. Oben in dieser Datei steht ein kurzer Block mit Name und Beschreibung, darunter folgen die eigentlichen Anweisungen als ganz normaler Text. Zusätzlich darf der Ordner Vorlagen, Referenzdokumente und kleine Skripte enthalten.

Stell dir das Ganze wie eine Einarbeitungsmappe für neue Kolleginnen vor. Auf dem Deckel steht, wofür die Mappe gedacht ist. Drinnen stehen die Arbeitsschritte, und hinten sind Musterbriefe und Checklisten eingeheftet.

Anthropic hat Agent Skills eingeführt und am 18. Dezember 2025 als offenen Standard veröffentlicht, dokumentiert auf agentskills.io. Inzwischen verstehen auch andere Werkzeuge wie Cursor oder Codex das Format. Bei Claude funktionieren Skills in Claude.ai, Claude Code, dem Claude Agent SDK und über die API. In den Tarifen Pro, Max, Team und Enterprise kosten sie nichts extra, überf die API zahlst du die normalen Preise. Seit dem 20. August 2026 ist die Skills API auf der Claude Platform allgemein verfügbar.

Warum Claude Skills so sparsam mit Kontext umgehen

Du könntest natürlich alle Anweisungen in einen riesigen Systemprompt packen. Dann liest Claude bei jeder Anfrage alles mit, auch wenn du nur ein Rezept für Linsensuppe suchst. Skills arbeiten stattdessen mit Progressive Disclosure:

Claude lädt Informationen stufenweise und nur bei Bedarf. Um im Bild zu bleiben: Claude liest erst den Deckel der Mappe und schlägt sie nur auf, wenn sie zur Aufgabe passt.

Stufe Was geladen wird Wann
1. Metadaten Name und Beschreibung aus dem Kopfbereich Immer, schon beim Start
2. Anweisungen Der restliche Inhalt der SKILL.md Wenn Claude den Skill für passend hält oder du ihn aufrufst
3. Zusatzdateien Musterbriefe, Checklisten, Skripte Erst während der Ausführung, wenn die Anleitung darauf verweist

Du kannst also Dutzende Skills installieren, ohne dass Claude dadurch merklich mehr liest. Pro Skill kostet die erste Stufe nur eine Handvoll Tokens.

Claude Skill: Progressive Disclosure.

Schritt 1: Den Skill Ordner anlegen

Unser Beispiel-Skill hilft dem Kundenservice eines kleinen Online-Shops für Gartenmöbel. Er soll freundliche Antworten auf Beschwerden, Lieferfragen und Rücksendewünsche entwerfen. In Claude Code legst du Skills für ein Projekt unter .claude/skills/ ab, persönliche Skills für alle Projekte unter ~/.claude/skills/.

Claude Skill Ordnerstruktur

Schritt 2: Die SKILL.md schreiben

Das Herzstück sieht so aus:

Der Name besteht aus Kleinbuchstaben und Bindestrichen. Die Beschreibung ist der wichtigste Satz im ganzen Skill, denn nur sie sieht Claude, bevor es entscheidet, ob der Skill überhaupt passt. Die Musterantworten liegen bewusst in einer eigenen Datei. Claude öffnet sie nur, wenn es sie braucht.

Schritt 3: Ein kleines Skill Skript als Korrekturleser

Jedes Team hat Formulierungen, die es nicht mehr hören kann. Bei unserem Shop stehen in tabuwoerter.txt zum Beispiel “leider nicht möglich”, “wie bereits erwähnt” und “Das ist nicht unser Problem”. Ob ein Text solche Phrasen enthält, prüft ein Skript zuverlässiger als ein Sprachmodell, weil es stur jedes Wort vergleicht:

Die Tabuliste pflegt das Serviceteam selbst, ganz ohne Programmierkenntnisse: eine Phrase pro Zeile, fertig. Claude bekommt nur das Ergebnis der Prüfung zu sehen und formuliert bei Bedarf um.

Schritt 4: Claude Skill ausprobieren

Kopiere eine echte Kundenmail in den Chat, etwa: “Mein Sonnenschirm kam mit gebrochener Strebe an, was jetzt?” Claude erkennt anhand der Beschreibung, dass der Skill passt, liest die Anleitung, schaut in die Musterantworten und prüft den Entwurf auf Tabuwörter. Heraus kommt eine Antwort, die nach eurem Team klingt. Greift der Skill nicht, liegt es fast immer an der Beschreibung.

So schreibst du eine Skill Beschreibung, die funktioniert

Behandle die Beschreibung wie ein Auswahlkriterium. Sie sollte in ein bis zwei Sätzen sagen, was der Skill tut und wann er benutzt werden soll. Ein Negativbeispiel:

Damit kann Claude nichts anfangen. Welche Texte? In welcher Situation? Besser ist es so:

Noch ein paar Faustregeln: Halte die SKILL.md kurz und lagere Details in eigene Dateien aus. Schreib die Schritte in der Reihenfolge auf, in der Claude sie ausführen soll. Und baue lieber drei kleine Skills mit klarer Aufgabe, zum Beispiel für Kundenmails, Protokolle und Stellenanzeigen, als einen Alleskönner, der bei jeder zweiten Anfrage anspringt.

Welche Programmiersprachen kann ich für Skills verwenden?

Die SKILL.md selbst schreibst du in ganz normaler Sprache, ergänzt um ein bisschen Markdown für Überschriften und Listen. Eine Programmiersprache brauchst du nur, wenn dein Skill Hilfsskripte mitbringt, wie unseren Tabuwort-Prüfer. Und auch die sind freiwillig.

Claude startet solche Skripte über die Kommandozeile, genau wie in der Anleitung oben mit python scripts/tabu_check.py. Deshalb funktioniert im Prinzip jede Sprache, die auf dem ausführenden Rechner installiert ist. Welche das sind, hängt davon ab, wo der Skill läuft:

Umgebung Wo laufen die Skripte? Welche Sprachen?
Claude Code Auf deinem eigenen Rechner Alles, was dort installiert ist, etwa Python, Node.js, Bash oder PowerShell
Claude.ai In der Code-Ausführungsumgebung von Anthropic Vor allem Python, JavaScript (Node.js) und Shell-Befehle
Claude API In einem Container ohne Internetzugang Wie bei Claude.ai, aber nur mit bereits vorinstallierten Paketen

In der Praxis reichen fast immer Python, JavaScript oder ein kurzes Shell-Skript. Unsere Tabuwort-Prüfung lässt sich zum Beispiel auch in ein paar Zeilen Bash schreiben, ganz ohne Python:

Und wer im Team lieber JavaScript schreibt, prüft damit die Längenvorgabe aus dem Tonfall-Abschnitt. Höchstens 150 Wörter, das kontrolliert dieses Skript:

In der SKILL.md ergänzt du dann einfach einen Schritt wie “Prüfe die Länge mit node scripts/laenge_check.js entwurf.txt“. Ein praktischer Nebeneffekt: Den Code eines Skripts muss Claude gar nicht lesen. Es führt das Skript aus und bekommt nur die Ausgabe zu sehen, das spart Kontext.

Bei der Wahl der Sprache helfen drei Fragen. Wer im Team kann das Skript später noch lesen und anpassen? Läuft der Skill auch in Claude.ai oder über die API, wo nicht jede Sprache zur Verfügung steht? Und braucht das Skript Zusatzpakete? Über die API kannst du zur Laufzeit keine Pakete nachinstallieren, du bist dort also auf das angewiesen, was schon vorhanden ist. Je weniger Abhängigkeiten, desto weniger Ärger. Für Prüfungen wie unsere genügt die Standardausstattung der jeweiligen Sprache völlig.

Wie kann ich mehrere Claude Skills verwalten?

Der erste Skill ist schnell geschrieben. Gefährlich wird es, wenn er gut funktioniert, denn dann will die Buchhaltung einen eigenen, das Marketing zwei und die Personalabteilung auch einen. Nach ein paar Monaten liegen zwanzig Ordner herum, und niemand weiß mehr, welcher davon aktuell ist. Mit ein paar Gewohnheiten bleibt die Sammlung trotzdem übersichtlich.

Der richtige Ablageort

Wo ein Skill liegt, entscheidet darüber, wer ihn nutzen kann. In Claude Code gibt es drei Möglichkeiten:

Ablageort Wer nutzt ihn? Gut geeignet für
~/.claude/skills/ Nur du, in allen Projekten Persönliche Vorlieben, etwa deine eigene Mail-Signatur oder dein Lieblingsformat für Notizen
.claude/skills/ im Projekt Alle, die an diesem Projekt arbeiten Teamregeln, die nur hier gelten, zum Beispiel die Kundenantworten für den Gartenmöbel-Shop
Plugin Alle, die das Plugin installieren Pakete aus mehreren Skills, die ganze Abteilungen oder Firmen nutzen sollen

In Claude.ai lädst du eigene Skills in den Einstellungen als ZIP-Datei hoch und schaltest sie dort einzeln an oder aus. Brauchst du einen Skill gerade nicht, deaktivierst du ihn einfach, statt ihn zu löschen.

Skills sauber voneinander abgrenzen

Das häufigste Problem bei vielen Skills sind Beschreibungen, die sich überschneiden. Hast du einen Skill für “Kundenmails” und einen zweiten für “Reklamationen”, muss Claude bei einer Beschwerde raten, welcher gemeint ist. Schreib deshalb in jede Beschreibung, wofür der Skill zuständig ist und wofür nicht:

Ein einheitliches Namensschema hilft zusätzlich. Wenn alle Skills des Kundenservice mit service- beginnen und alle der Buchhaltung mit buha-, erkennst du schon an der Ordnerliste, wem was gehört.

Manche Skills nur auf Zuruf starten

Nicht jeder Skill soll von allein anspringen. Den Skill für den monatlichen Newsletter willst du vermutlich lieber selbst auslösen, bevor Claude bei jeder Erwähnung des Wortes “Newsletter” mit dem Entwerfen beginnt. In Claude Code rufst du einen Skill mit einem Schrägstrich und seinem Namen auf, also zum Beispiel /newsletter. Mit einer zusätzlichen Zeile im Kopfbereich sorgst du dafür, dass Claude ihn nur dann verwendet:

Mehrere Skills als Paket verteilen

Sobald mehrere Abteilungen dieselben Skills brauchen, lohnt sich ein Plugin. Darin bündelst du zum Beispiel alle Service-Skills und stellst sie über einen eigenen Marketplace bereit. Die Kolleginnen installieren das Paket einmal und bekommen Änderungen automatisch mit. In den Tarifen Team und Enterprise können Admins Skills außerdem zentral für die ganze Organisation bereitstellen. Wie du so ein Plugin Schritt für Schritt baust, zeigt der nächste Abschnitt.

Pflege nicht vergessen

Skills veralten wie jedes andere Dokument. Die Rückgabefrist ändert sich, eine Vorlage wird ersetzt, jemand verlässt das Team. Ein paar einfache Regeln helfen:

  • Jeder Skill hat eine verantwortliche Person, die du am besten gleich in die SKILL.md schreibst.
  • Projekt-Skills liegen mit im Versionsverwaltungssystem, etwa in Git. So siehst du, wer wann was geändert hat, und kannst Fehler rückgängig machen.
  • Einmal im Quartal schaut jemand die Liste durch und löscht, was niemand mehr nutzt.

Das klingt nach Bürokratie, kostet aber weniger Zeit als die Suche nach dem Grund, warum Claude plötzlich die alte Rückgabefrist von 14 Tagen nennt.

Claude Skill Plugin

Für Fortgeschrittene: Ein Claude Skill Plugin bauen

Irgendwann reicht es nicht mehr, Skill-Ordner per Hand von Rechner zu Rechner zu kopieren. Bei Gartenglück wollen inzwischen fünf Leute im Service mit denselben Skills arbeiten, und jede Änderung an der Tabuliste soll bei allen ankommen. Dafür gibt es Plugins: Ein Plugin ist ein Ordner, den Claude Code als ein Paket installiert und lädt. Neben Skills kann es auch Hooks, Subagenten oder MCP-Server enthalten, wir bleiben hier aber bei Skills. Dieser Abschnitt wird etwas technischer. Wenn du vor allem entscheiden und nicht selbst basteln willst, kannst du direkt zu den fertigen Skills springen.

Die Ordnerstruktur

Aus unseren beiden Service-Skills wird ein Plugin namens gartenglueck-service:

Die Skill-Ordner übernimmst du unverändert. Ein Fehler passiert beim ersten Plugin besonders oft: In den Ordner .claude-plugin/ gehört nur die Datei plugin.json. Der Ordner skills/ liegt direkt im Hauptverzeichnis des Plugins. Packst du ihn versehentlich mit in .claude-plugin/, findet Claude Code deine Skills nicht, und eine Fehlermeldung bekommst du auch keine.

Das Manifest: plugin.json

Die plugin.json ist der Beipackzettel des Pakets:

Der Name hat eine wichtige Nebenwirkung. Er wird zum Präfix für alle enthaltenen Skills. Aus /kundenantworten wird nach dem Verpacken /gartenglueck-service:kundenantworten. So kommen sich zwei Plugins mit gleichnamigen Skills nicht in die Quere. Verweist irgendwo eine Anleitung auf den alten Aufruf, musst du sie anpassen.

Auch die Versionsnummer hat ihren Zweck. Claude Code nimmt die Version zuerst aus der plugin.json, dann aus dem Marketplace-Eintrag und, wenn beides fehlt, aus dem Git-Commit. Pflegst du die Nummer in der plugin.json, solltest du sie bei jeder Änderung erhöhen, damit die Kolleginnen das Update auch bekommen.

Falls dein Plugin später Hooks oder MCP-Server mitbringt, die auf Dateien im Paket zugreifen, nutze dort die Variable ${CLAUDE_PLUGIN_ROOT} statt fester Pfade. Installierte Plugins liegen in einem Cache-Verzeichnis, und ein fest eingetragener Pfad von deinem Rechner zeigt dort ins Leere.

Lokal testen

Einen Marketplace brauchst du zum Ausprobieren noch nicht. Starte Claude Code einfach mit dem Plugin-Ordner:

Jetzt kannst du /gartenglueck-service:kundenantworten aufrufen oder wie gewohnt eine Kundenmail in den Chat kopieren und schauen, ob der Skill von allein anspringt.

Einen eigenen Marketplace anlegen

Ein Marketplace klingt nach App Store, ist aber nur ein Katalog: ein Ordner oder Git-Repository mit einer Datei .claude-plugin/marketplace.json, die auflistet, welche Plugins es gibt und wo sie liegen. Gehostet wird dabei nichts, ein privates Repository bei GitHub oder GitLab reicht völlig.

Die marketplace.json dazu:

Bevor du den Ordner teilst, lässt du Claude Code prüfen, ob alles stimmt:

Die Prüfung findet Tippfehler und fehlende Felder. Ob sich das Plugin wirklich installieren lässt, zeigt sie nicht, deshalb installierst du es zusätzlich einmal auf deinem eigenen Rechner. Danach schiebst du das Repository auf euren Git-Server.

Installieren im Team

Die Kolleginnen registrieren den Marketplace einmalig und installieren dann das Plugin:

Hinter dem @ steht der Name des Marketplace, davor der Name des Plugin-Eintrags. Bei der Installation wählst du, ob das Plugin nur für dich, für das aktuelle Projekt oder nur lokal gelten soll. Wer lieber klickt, findet alles auch im Menü hinter /plugin. Für die Desktop-App von Claude gibt es Plugin-Marketplaces ebenfalls, dort derzeit noch als Beta.

Ab jetzt änderst du die Tabuliste nur noch an einer Stelle, erhöhst die Version, und das ganze Serviceteam arbeitet mit dem neuen Stand.

Fertige Claude Skills nutzen

Du musst nicht alles selbst bauen. Anthropic bietet vorgefertigte Skills für PowerPoint, Excel, Word und PDF an. Damit erstellt Claude zum Beispiel eine Präsentation für das nächste Teammeeting oder eine Excel-Tabelle mit Diagrammen. Diese Skills gibt es in Claude.ai und über die API, in Claude Code allerdings nicht. Weitere Beispiele findest du im öffentlichen Repository anthropics/skills auf GitHub, das selbst als Marketplace funktioniert. In Claude Code bindest du es so ein:

Das Repository enthält auch eine Vorlage, die sich gut als Startpunkt für eigene Skills eignet.

Ein Wort zur Sicherheit

Skills bringen Anweisungen und manchmal ausführbaren Code mit. Ein manipulierter Skill kann Claude also zu Dingen bringen, die du nicht willst. Anthropic empfiehlt, Skills nur aus vertrauenswürdigen Quellen zu installieren und alles andere vorher gründlich zu prüfen. Schau dir vor allem enthaltene Skripte an, bevor du einen fremden Skill aktivierst, egal ob sie in Python, JavaScript oder Bash geschrieben sind. Für Plugins gilt das genauso: Anthropic weist ausdrücklich darauf hin, dass es nicht kontrolliert, welche Dateien und Programme in Plugins stecken. Einen USB-Stick vom Parkplatz steckst du ja auch nicht einfach in den Firmenrechner. Je mehr Skills im Umlauf sind, desto wichtiger wird diese Prüfung, und auch dafür ist eine verantwortliche Person pro Skill hilfreich.

Was das für Teams und Entscheider bedeutet

Skills sind im Grunde dokumentiertes Firmenwissen, das eine KI direkt anwenden kann. Die Kollegin, die als Einzige weiß, wie der Quartalsbericht formatiert wird, schreibt es einmal auf, und das ganze Team profitiert davon. Fällt sie in den Urlaub, bleibt das Wissen trotzdem verfügbar.

Weil das Format ein offener Standard ist, bindest du dich damit nicht an ein einzelnes Werkzeug. Der Einstieg kostet wenig: ein Ordner, eine Textdatei und eine halbe Stunde Zeit, um einen wiederkehrenden Ablauf sauber aufzuschreiben.

Skripte kannst du später ergänzen, in der Sprache, die dein Team ohnehin beherrscht. Wächst die Sammlung, macht ein eigenes Plugin mit privatem Marketplace aus losen Ordnern ein versioniertes Paket, das sich mit einem Befehl verteilen lässt. Plane aber von Anfang an ein, wer die Skills pflegt, sobald es mehr als eine Handvoll gibt.

Claude Agent Skill FAQ

Brauche ich Programmierkenntnisse für einen Agent Skill?

Nein. Ein Skill kann aus einer einzigen Markdown-Datei mit Anweisungen bestehen. Skripte sind optional und lohnen sich vor allem für Prüfungen, die zuverlässig immer gleich ablaufen sollen.

Welche Programmiersprachen kann ich für Skripte in Skills verwenden?

In Claude Code jede Sprache, die auf deinem Rechner installiert ist. In Claude.ai und über die API laufen Skripte in der Ausführungsumgebung von Anthropic, dort sind vor allem Python, JavaScript (Node.js) und Shell-Befehle üblich. Über die API kannst du keine zusätzlichen Pakete nachinstallieren.

Was ist der Unterschied zwischen einem Skill und einem Plugin?

Ein Skill ist ein einzelner Ordner mit einer SKILL.md. Ein Plugin ist ein Paket mit einer plugin.json, das mehrere Skills und weitere Bausteine bündelt, eine Versionsnummer trägt und sich über einen Marketplace installieren und aktualisieren lässt. Skills aus einem Plugin rufst du mit Präfix auf, etwa /gartenglueck-service:kundenantworten.

Wo funktionieren Agent Skills?

In Claude.ai, Claude Code, dem Claude Agent SDK und über die Claude API. Dank des offenen Standards unterstützen auch andere Werkzeuge wie Cursor oder Codex das Format.

Kosten Skills extra?

In den Tarifen Pro, Max, Team und Enterprise sind sie ohne Aufpreis enthalten. Über die API gelten die normalen API-Preise.

Wie viele Skills kann ich gleichzeitig installieren?

Auch Dutzende sind kein Problem, weil Claude vorab nur Name und Beschreibung liest. Schwieriger wird es bei sich überschneidenden Beschreibungen. Grenze die Zuständigkeiten deshalb klar voneinander ab.

Warum benutzt Claude meinen Skill nicht?

Meistens ist die Beschreibung zu vage, oder ein anderer Skill beansprucht dieselben Anfragen. Bei Plugins liegt der Skill-Ordner manchmal versehentlich in .claude-plugin/ statt im Hauptverzeichnis. Schreib genau in die Beschreibung, was der Skill tut und bei welchen Anfragen er greifen soll.

Sind fremde Skills sicher?

Nur so sicher wie ihre Quelle. Installiere Skills und Plugins aus vertrauenswürdigen Quellen und prüfe enthaltene Skripte, bevor du sie einsetzt.

 

Mehr zum Thema KI lesen

Im Claude Skill Marketplace stöbern