Claude Skills Erstellen: Der Komplette Leitfaden (2026)
27 July 2026 · Aktualisiert 27 July 2026

Gabriel Caetano
ARTIFICIAL INTELIGENCE
Claude Skills Erstellen: Der Komplette Leitfaden (2026)
Erfahren Sie, wie Sie Claude Skills von Grund auf erstellen. Lernen Sie SKILL.md, MCP-Integration, Tests, Bereitstellung und Best Practices für wiederverwendbare KI-Workflows kennen.

1. Was sind Claude Skills? (Und wie unterscheiden sie sich von Prompts)
Bevor du irgendetwas baust, lohnt es sich zu verstehen, was ein Skill auf technischer Ebene eigentlich ist, wie er sich von einem Prompt unterscheidet und wo er im größeren Anthropic Claude-Ökosystem einzuordnen ist. Dieser Abschnitt schafft die konzeptionelle Grundlage, auf der alles andere aufbaut.
Claude Skills definiert
Ein Claude Skill ist eine in sich geschlossene, benannte und versionierte Anweisungseinheit, die Claude bei Bedarf aufrufen kann. Praktisch gesehen ist es einfach ein Ordner. Im einfachsten Fall besteht ein Skill aus einem Verzeichnis mit einer SKILL.md-Datei, und diese Datei muss mit einem YAML-Frontmatter beginnen, das bestimmte Pflichtangaben enthält: Name und Beschreibung.
Dieser Ordner ist schon alles. Es gibt kein separates Modell, keine proprietäre Binärdatei, kein kostenpflichtiges Add-on. Skills sind keine Modelle, keine Plugins im WordPress-Sinne und keine bezahlten Erweiterungen. Es sind Open-Source-Markdown-Anweisungen plus unterstützende Dateien. Das solltest du dir früh bewusst machen, denn es verändert, wie du an die Sache herangehst. Du programmierst kein System. Du schreibst eine Dokumentation, die so klar und so eng gefasst ist, dass Claude ihr jedes Mal perfekt folgen kann.
Skills tauchen hauptsächlich an zwei Stellen auf. In der Claude API kannst du die vorgefertigten Skills von Anthropic nutzen und eigene Skills über die Claude API hochladen – und Skills sind denkbar einfach zu erstellen: einfach ein Ordner mit einer SKILL.md-Datei, die YAML-Frontmatter und Anweisungen enthält. In Claude Code liegen sie in einem Verzeichnis innerhalb deines Projekts oder Plugins. Du legst ein Skills-Verzeichnis im Root deines Plugins oder Projekts an und fügst dort Skill-Ordner mit SKILL.md-Dateien hinzu. Claude entdeckt und nutzt sie dann automatisch, sobald das Plugin installiert ist.
Es gibt außerdem ein öffentliches Verzeichnis mit Beispielen. Anthropic pflegt ein offenes Repository mit Skills, das zeigt, was alles möglich ist. Dieses Repository enthält Skills, die das Potenzial von Claudes Skills-System veranschaulichen – von kreativen Anwendungen wie Kunst, Musik und Design über technische Aufgaben wie das Testen von Web-Apps und die Generierung von MCP-Servern bis hin zu Workflows für Unternehmen. Das sind wertvolle Referenzen, wenn du anfängst, deine eigenen Skills zu bauen.
Das beste Bild dafür: Wenn Prompts Post-its sind, die du hinkritzelst und dann wegwirfst, dann sind Skills dokumentierte Standardarbeitsanweisungen. Ein Post-it erinnert eine Person einmal. Eine Standardarbeitsanweisung legt fest, wie eine Aufgabe von allen erledigt wird – dauerhaft, mit klarem Verantwortlichen und einer Versionsnummer.
Ein paar Begriffe solltest du dir jetzt schon einprägen, denn sie tauchen im gesamten Guide immer wieder auf:
- SKILL.md: die Pflichtdatei im Zentrum jedes Skills. Achte auf die Großschreibung des Dateinamens in Anthropics Implementierung, auch wenn viele Leute allgemein von der „skill.md-Datei" sprechen.
- Frontmatter: der YAML-Block am Anfang der Datei mit Metadaten wie name und description.
- Skill-Body: die Markdown-Anweisungen unterhalb des Frontmatters.
- Skill-Builder: der Erstellungsprozess – egal ob über eine Vorlage, die API oder ein Verzeichnis in Claude Code.
- Invocation (Aufruf): der Moment, in dem Claude entscheidet, dass ein Skill relevant ist, und ihn lädt.
- Skill-Scope: wie eng oder breit der Zweck eines Skills gefasst ist.
Läuft Claude bei dir die ganze Woche über mehrere Repos, um deine Skill-Bibliothek zu testen? Dann bist du wahrscheinlich beim Max 20x Plan für 200 $/Monat, abgerechnet in USD. Mit Bleap zahlst du zum echten Wechselkurs, ohne FX-Gebühren, und bekommst pauschal 20% Cashback auf Claude-, ChatGPT- und Gemini-Verlängerungen – ganz ohne Kartenabo. Jetzt die Bleap-Karte holen →
Claude Prompts vs. Skills: Die entscheidenden Unterschiede
Häufig kommt die Frage auf, warum man nicht einfach bei einem guten Prompt bleiben kann. Manchmal ist das auch die richtige Wahl. Aber sobald eine Aufgabe wiederholt ausgeführt wird, geteilt wird oder geschäftskritisch ist, hat ein Skill in fast jeder Hinsicht die Nase vorn. Hier die Details im Überblick.
Beständigkeit. Ein Prompt existiert nur innerhalb des Gesprächsabschnitts, in den er eingefügt wird. Sobald die Sitzung endet, ist er weg. Ein Skill dagegen bleibt über Sitzungen und Nutzer hinweg bestehen. Es wird gespeichert, indexiert und ist immer dann verfügbar, wenn es gebraucht wird.
Auffindbarkeit. Das ist der subtile Punkt. Claude kann einen Prompt erst sehen, wenn ihn jemand einschleust. Ein Skill dagegen macht sich selbst sichtbar. Beim Start lädt der Agent Name und Beschreibung jedes installierten Skills vorab in seinen System-Prompt – gerade genug Information, damit Claude weiß, wann welcher Skill zum Einsatz kommen sollte, ohne gleich den kompletten Inhalt in den Kontext zu laden. Claude entscheidet aktiv, wann es auf einen Skill zurückgreift. Auf einen Prompt, den es nie gesehen hat, kann es dagegen nie zurückgreifen.
Wiederverwendbarkeit. Ein Skill kann von jedem berechtigten Nutzer oder Subagenten aufgerufen werden, ohne dass jemand Text kopieren und einfügen muss. Ein Prompt muss dagegen manuell geteilt und immer wieder neu geteilt werden – und verändert sich dabei jedes Mal ein Stück.
Versionierung. Skills lassen sich über die Zeit weiterentwickeln und nachverfolgen. Rohe Prompts, die einfach in Nutzernachrichten stehen, lassen sich auf keine sinnvolle Weise versionieren.
Tool-Integration. Skills können Skripte und Referenzmaterial bündeln und genau beschreiben, wie und wann sie einzusetzen sind. Prompts können diese Struktur von Natur aus nicht abbilden.
Kombinierbarkeit. Skills können auf andere Ressourcen verweisen und in Subagenten für delegierte Aufgaben eingebunden werden. Prompts sind dagegen monolithische Textblöcke.
Hier ist ein direkter Vergleich anhand von acht Dimensionen:
Dimension | Roher Prompt | Claude Skill |
|---|---|---|
Persistenz | Gilt nur für einen Gesprächsverlauf | Bleibt über Sitzungen und Nutzer hinweg bestehen |
Wiederverwendbarkeit | Muss jedes Mal neu kopiert werden | Wird automatisch aufgerufen, kein Kopieren nötig |
Versionierung | Keine | Semantische Versionierung, über die Zeit nachvollziehbar |
Auffindbarkeit | Unsichtbar, bis eingefügt | Wird über Name und Beschreibung sichtbar gemacht |
Tool-Zugriff | Kann keine Tools bündeln | Kann Skripte und Ressourcen bündeln |
Teilen | Manuell, driftet ständig auseinander | Einheitliche Quelle der Wahrheit |
Testing | Ad-hoc | Strukturierte Sammlung an Testfällen |
Sicherheit / Zugriff | Keine Zugriffskontrolle | Abgestufte Zugriffsebenen |
Wann nutzt man einen Prompt, wann baut man eine Skill? Die Entscheidung ist eigentlich ganz einfach. Nutze einen Prompt für einmalige, experimentelle oder sehr kontextspezifische Anfragen. Baue eine Skill, wenn eine Aufgabe regelmäßig wiederkehrt, konsistente Ergebnisse liefern muss, von mehreren Personen genutzt wird oder Wissen enthält, das sonst bei jeder Sitzung neu erklärt werden müsste. Wenn du merkst, dass du dieselben Anweisungen zum zweiten Mal einfügst, ist das dein Signal.
Wo Skills im Anthropic-Claude-Ökosystem einzuordnen sind
Skills existieren nicht isoliert. Wenn du verstehst, wie sie sich zum Rest des Claude-Ökosystems verhalten, verhinderst du, dass du eine Skill für etwas baust, das ein anderer Mechanismus ohnehin besser übernimmt.
Skills vs. Projects. In Claude.ai fassen Projects Unterhaltungen und Dateien rund um ein gemeinsames Ziel zusammen. Skills erweitern Projects um wiederverwendbares Verfahrenswissen, sind aber nicht dasselbe. Ein Project ist ein Arbeitsbereich. Ein Skill ist eine Fähigkeit, die du innerhalb dieses Arbeitsbereichs oder überall sonst aufrufen kannst.
Skills vs. MCP. Dieser Unterschied ist wichtig. Das Model Context Protocol ist die Verbindungsebene – der Weg, über den Claude auf externe Tools, Datenquellen und Dienste zugreift. Skills sind die Anweisungsebene, die Claude sagt, wie und wann er handeln soll. Häufig nutzt man beides zusammen: MCP verbindet Claude mit deiner Datenbank, und ein Skill gibt Claude die genaue Vorgehensweise vor, wie diese Daten abgefragt und formatiert werden. Einer der Beispiel-Skills von Anthropic behandelt sogar die Generierung von MCP-Servern – ein gutes Beispiel dafür, wie eng beide Konzepte miteinander verzahnt sind.
Skills vs. Subagents. Skills lassen sich in benutzerdefinierte Subagents einbinden, sodass ein spezialisierter Agent eine ausgelagerte Aufgabe isoliert übernimmt. Du kannst Skills mit deinem Team teilen, indem du sie in ein Repository einpflegst, sie über Plugins verteilst, unternehmensweit ausrollst und in benutzerdefinierte Subagents einbindest, um Aufgaben isoliert und fachkundig zu delegieren. Der Skill liefert das Fachwissen, der Subagent den isolierten Ausführungskontext.
Skills vs. API. Skills sind nicht an die Chat-Oberfläche gebunden. Sie lassen sich programmatisch nutzen – genau das macht sie tauglich für den Produktiveinsatz in Automatisierungen, CI-Pipelines und eingebetteten Produktfunktionen.
Skills vs. Kontext-Hierarchie. Wenn Claude antwortet, wägt er den System-Prompt, die geladenen Skill-Inhalte, die Nachrichten des Nutzers und etwaige Tool-Ergebnisse gegeneinander ab. Skills stehen über der einzelnen Nachricht, aber unter den unveränderlichen Leitplanken auf Systemebene. Wer diese Hierarchie kennt, kann Skills so schreiben, dass sie das Verhalten steuern, ohne gegen Claudes Standardeinstellungen anzukämpfen.
Warum Claude Skills ein Gamechanger für KI-Automatisierung sind
Der strategische Wert von Skills wächst mit der Zeit. Und hier kommt der eigentliche Hebel her.
Prompt-Drift gehört der Vergangenheit an. Wenn ein Team auf einen gemeinsamen Skill zurückgreift, arbeiten alle mit denselben verbindlichen Anweisungen. Die Frage "Welche Version des Prompts nutzt du gerade?" stellt sich einfach nicht mehr. Der Skill ist die einzige Wahrheit.
Zugang für alle. Ein gut gebauter Skill ermöglicht es auch nicht-technischen Kolleginnen und Kollegen, von ausgefeilter Automatisierung zu profitieren. Sie müssen nicht wissen, wie man einen 400 Wörter langen System-Prompt schreibt. Sie beschreiben einfach, was sie brauchen, und Claude greift auf den passenden Skill zurück.
Weniger verschwendeter Context Window. Hier zeigt sich die technische Raffinesse des Designs. Skills nutzen ein dreistufiges Ladesystem, um den Kontext effizient zu verwalten – und dank dieser schrittweisen Offenlegung kannst du zahlreiche verschiedene Skills installieren, um komplexe Aufgaben zu erledigen, ohne dein Context Window zu überladen. Statische Anweisungen bleiben außerhalb der Konversation, bis sie tatsächlich gebraucht werden.
Der Bibliothekseffekt, der sich aufschaukelt. Jeder Skill, den du baust, macht den nächsten wertvoller, weil Skills auf gemeinsame Ressourcen zugreifen und sich zu ganzen Workflows kombinieren lassen. Ein Team mit 40 gut abgegrenzten Skills hat ein grundlegend anderes Leistungsprofil als ein Team, das Prompts zusammenkopiert. Ein Team, das Dutzende Skills im Einsatz hat, berichtete, dass der Overhead für alle 40 Skills zusammen bei rund 1.500 Tokens liegt – nur der jeweils relevante Skill wird bei Bedarf ausgeklappt.
Anwendungsfälle aus der Praxis. Das Muster taucht überall auf: automatisierte Code-Reviews, Playbooks für den Kundensupport, Datennormalisierung, Content-QA, markenkonforme Dokumentenerstellung und die Zusammenführung von Recherche-Ergebnissen. Die Stärke von Skills liegt darin, institutionelles Wissen festzuhalten, Ergebnisse zu standardisieren und komplexe, mehrstufige Workflows zu bewältigen – Aufgaben, die sonst ständige Wiederholungen oder die aufwendige Entwicklung eines eigenen Agenten erfordern würden.
Die These zur Produktivität ist eigentlich ganz einfach. Jede Minute, die ein Wissensarbeiter damit verbringt, einer KI immer wieder denselben Kontext zu erklären, ist verschwendete Zeit – und diese Verschwendung summiert sich im Team schnell zu einem echten Problem. Strukturierte, wiederverwendbare Workflows beseitigen genau diesen Ballast. Wie viel dabei konkret eingespart wird, hängt natürlich von euren eigenen Abläufen ab. Deshalb solltet ihr konkrete Prozentzahlen, die irgendwo im Netz kursieren, immer mit einer gesunden Portion Skepsis betrachten. Die Richtung aber ist eindeutig: weniger Wiederholung, mehr Konsistenz, mehr Hebelwirkung.
2. Wie Claude Skills funktionieren: Architektur, Content-Lifecycle und Skill-Typen
Jetzt, wo du weißt, was Skills sind und warum sie wichtig sind, schauen wir mal unter die Haube. Wenn du die Architektur und den Lifecycle verstehst, kannst du Skills schreiben, die zuverlässig ausgelöst werden – statt Skills, die einfach ungenutzt herumliegen, weil Claude nie erkennt, dass sie relevant sind.
Die Claude-Skill-Architektur im Überblick
Grob läuft es so ab: Ein Nutzer oder Agent stellt eine Anfrage, Claude prüft die Metadaten aller installierten Skills, entscheidet, ob eine davon relevant ist, lädt bei Bedarf den vollständigen Inhalt dieser Skill in den Kontext und generiert dann eine Antwort, die mit diesem Inhalt angereichert ist. Man kann sich das vorstellen als: Nutzer oder Agent → Scan der Skill-Metadaten → Relevanzentscheidung → Laden des Inhalts → angereicherte Antwort.
Jede Skill besteht aus drei konzeptionellen Ebenen:
- Definition. Was die Skill ist: ihr Name, ihre Beschreibung, Version und Metadaten. Das sieht Claude jederzeit.
- Content. Was die Skill in den Kontext einbringt: die vollständigen Anweisungen, Beispiele und alle referenzierten Ressourcen. Das wird nur bei Bedarf geladen.
- Ausführung. Wie Claude den geladenen Inhalt tatsächlich nutzt, um die Aufgabe zu erledigen – inklusive aller Skripte oder Tools, auf die die Skill verweist.
Wo werden Skills gespeichert? Das hängt von deinem Setup ab. In Claude Code liegen sie in einem skills/-Verzeichnis in deinem Projekt oder Plugin. Über die API werden sie in den von Anthropic verwalteten Speicher hochgeladen. Teams pflegen die maßgeblichen Versionen meist in ihrem eigenen Git-Repository und verteilen sie von dort aus.
Woher "weiß" Claude überhaupt, dass ein Skill existiert? Über die stets geladene Metadaten-Ebene. Das YAML-Frontmatter wird immer in Claudes System-Prompt geladen, was pro Skill etwa 100 Token kostet, egal wie viele Skills insgesamt installiert sind. Diese Metadaten-Ebene gibt Claude genau genug Informationen, um zu entscheiden, ob der Skill für die aktuelle Aufgabe relevant ist, ohne den kompletten Inhalt laden zu müssen. Diese 100 Token sind quasi der Eintrittspreis dafür, dass ein Skill überhaupt auffindbar wird – und genau deshalb funktioniert das Konzept auch bei Dutzenden von Skills noch reibungslos.
Ein Skill kann außerdem auf zwei Arten aufgerufen werden. Bei der impliziten Aufrufung entscheidet Claude selbst, dass ein Skill relevant ist – basierend auf der Beschreibung und der Anfrage des Nutzers. Bei der expliziten Aufrufung nennt ein Nutzer oder Agent den Skill direkt beim Namen. Beide Varianten sind völlig legitim; wie du die Balance zwischen ihnen gestaltest, entscheidest du beim Schreiben der Beschreibung.
Der Lebenszyklus von Skill-Inhalten
Ein Skill durchläuft einen vorhersehbaren Lebenszyklus – von der ersten Idee bis zum Produktivbetrieb und darüber hinaus. Wenn du jede Phase und ihre typischen Fehlerquellen verstehst, sparst du dir jede Menge Debugging-Stunden.
Phase 1, Erstellung. Du schreibst die SKILL.md sowie alle unterstützenden Dateien. Hier entscheidet sich der Großteil der Qualität. Stolperfalle: Du fängst an zu schreiben, bevor du das Problem klar definiert hast. Bevor du überhaupt etwas schreibst, solltest du klären, welches Problem dein Skill eigentlich lösen soll – denn starke Skills adressieren konkrete Bedürfnisse mit messbaren Ergebnissen.
Phase 2, Veröffentlichung. Du committest den Skill an den Ort, von dem aus Claude ihn lesen kann: ein Verzeichnis, die API oder eine CI/CD-Pipeline. Stolperfalle: Veröffentlichung am falschen Ort oder Vergessen, das Plugin zu installieren – dann findet Claude den Skill nie.
Phase 3, Indexierung. Claude lädt die Metadaten des Skills beim Start in den System-Prompt. Stolperfalle: Du erwartest, dass ein neu hinzugefügter Skill mitten in einer laufenden Sitzung verfügbar ist, ohne dass ein Neustart oder Neuladen stattfindet.
Phase 4, Aufruf. Claude gleicht eine Anfrage mit der Skill-Beschreibung ab und entscheidet, sie zu nutzen. Fallstrick: Ist die Beschreibung zu eng gefasst, aktiviert Claude den Skill nie.
Phase 5, Einbindung. Der vollständige SKILL.md-Inhalt wird in den Kontext geladen. Der eigentliche Inhalt der Datei ist die zweite Detailebene – wenn Claude den Skill für die aktuelle Aufgabe als relevant einstuft, lädt er ihn, indem er die komplette SKILL.md in den Kontext einliest. Fallstrick: ein überdimensionierter Inhalt, der Kontext frisst und die wichtigen Anweisungen unter sich begräbt.
Phase 6, Ausführung. Claude verarbeitet den angereicherten Kontext, formuliert seine Antwort und führt dabei alle Skripte aus, auf die der Skill verweist. Fallstrick: Anweisungen, die im Widerspruch zu Claudes Standardverhalten stehen und so zu uneinheitlichen Ergebnissen führen.
Phase 7, Iteration. Du versionierst, bearbeitest und veröffentlichst erneut. Fallstrick: Einen Skill zu ändern, ohne die Versionsnummer hochzusetzen – dann weiß niemand mehr, welches Verhalten er gerade vor sich hat.
Die mit Abstand nützlichste Gewohnheit hierbei: Auslösung (Triggering) und Ausführung getrennt voneinander testen. Teste beides separat: Wenn Skills nicht aktiviert werden, erweitere die Beschreibung und ergänze Anwendungsfälle. Sind die Ergebnisse uneinheitlich, mach die Anweisungen konkreter und baue Prüfschritte ein. Das sind zwei unterschiedliche Probleme mit zwei unterschiedlichen Lösungen – wer sie als eines behandelt, dreht sich im Kreis.
Arten von Skill-Inhalten
Nicht jeder Skill erfüllt denselben Zweck. Wenn du erkennst, welchen Typ du gerade baust, bestimmt das, wie du die SKILL.md strukturierst.
Reine Anweisungs-Skills liefern eine Reihe von Verhaltensregeln oder ein schrittweises Vorgehen. Eine Checkliste für Code-Reviews ist das klassische Beispiel: keine externen Daten, keine Tools, einfach ein verlässlicher Ablauf, den Claude jedes Mal befolgt.
Kontext-anreichernde Skills liefern Fachwissen, Referenzdaten oder Terminologie. Man kann sich das wie einen Skill vorstellen, der das Glossar deines Unternehmens, deine Produkttaxonomie oder deine Markensprache mitbringt – so trifft Claude automatisch den richtigen Ton, ohne dass du alles neu erklären musst.
Tool-aktivierende Skills beschreiben, wie und wann bestimmte Tools oder Skripte eingesetzt werden. Sie treten oft zusammen mit MCP-Verbindungen auf und verweisen Claude auf ausführbare Helfer im scripts/-Verzeichnis.
Template-Skills liefern strukturierte Ausgabeformate: ein JSON-Schema, eine Berichtsvorlage, ein Code-Gerüst. Hier zählt vor allem die einheitliche Struktur, nicht nur der Inhalt.
Hybride Skills vereinen mehrere dieser Elemente in einer Einheit. Anthropics eigene Skills zur Dokumentenbearbeitung sind ein gutes Beispiel dafür. Einer der Skills, die Claudes Fähigkeiten zur Dokumentenbearbeitung antreiben, setzt genau da an, wo Claude zwar schon viel über das Verstehen von PDFs weiß, aber nur eingeschränkt in der Lage ist, sie direkt zu bearbeiten – etwa ein Formular auszufüllen. Dieser PDF-Skill verleiht Claude also diese neuen Fähigkeiten. Das verbindet Anweisungen, Tools und Vorlagen miteinander.
Den richtigen Typ wählen. Frag dich, was die Aufgabe wirklich braucht. Geht es nur um eine Verhaltensänderung? Dann reicht ein reiner Anweisungs-Skill. Fehlt Wissen? Dann kontext-anreichernd. Muss etwas Externes ausgeführt werden? Dann tool-aktivierend. Wird eine bestimmte Ausgabestruktur benötigt? Dann ein Template. Trifft mehreres davon zu? Dann hybrid – aber so fokussiert wie möglich halten.
Wie der Typ die Struktur beeinflusst. Reine Anweisungs- und Template-Skills sind meist kurz und passen komplett in den SKILL.md-Textkörper. Kontext-anreichernde und hybride Skills brauchen dagegen oft zusätzliche Dateien – genau dafür ist das System der progressiven Offenlegung gedacht. Als Faustregel gilt: Halte den SKILL.md-Textkörper auf das Wesentliche beschränkt und unter 500 Zeilen. Näherst du dich dieser Grenze, teile den Inhalt lieber in separate Dateien auf.
Wie Claude entscheidet, wann ein Skill zum Einsatz kommt
Dieser Teil wird am häufigsten falsch gemacht, daher lohnt sich besondere Sorgfalt. Die Aktivierung hängt in erster Linie vom Beschreibungsfeld ab. Claude liest die Beschreibung jedes installierten Skills und gleicht sie semantisch mit der aktuellen Anfrage ab. Stimmt die Beschreibung, feuert der Skill zuverlässig. Stimmt sie nicht, bleibt selbst der genialste Skill ungenutzt.
Es gibt eine bekannte Verhaltenseigenart, auf die man sich einstellen sollte. Claude neigt dazu, Skills zu unterauslösen, sie also nicht zu nutzen, obwohl sie hilfreich wären. Um das auszugleichen, solltest du die Skill-Beschreibungen etwas nachdrücklicher formulieren. Anthropic selbst rät dazu, die Situationen, die den Skill aktivieren sollen, konkret auszubuchstabieren – auch die impliziten. Statt eines schlichten Einzeilers könntest du zum Beispiel ergänzen: „Achte darauf, diesen Skill immer dann zu verwenden, wenn der Nutzer Dashboards, Datenvisualisierung, interne Kennzahlen erwähnt oder irgendeine Art von Unternehmensdaten anzeigen möchte – auch wenn er nicht ausdrücklich nach einem Dashboard fragt.“
Explizite Aktivierung funktioniert über direkte Nennung: Ein Nutzer oder Agent benennt den Skill, oder ein Slash-Befehl löst ihn aus. Das ist der zuverlässigste Weg, setzt aber voraus, dass der Aufrufende überhaupt weiß, dass der Skill existiert.
Trigger-Phrasen und Beispiele. Wenn du Beispieläußerungen und Anwendungsfälle in deine Beschreibung aufnimmst, wird der semantische Abgleich präziser. Sie geben Claude konkrete Signale dafür, wann Relevanz besteht. Anthropics Rat, falls ein Skill nicht auslöst, ist unmissverständlich: Wenn Skills nicht aktiviert werden, solltest du die Beschreibung erweitern und Anwendungsfälle ergänzen.
Zuverlässigkeit und Überauslösung. Das Gegenteil kann genauso schiefgehen: Eine Beschreibung, die so weit gefasst ist, dass der Skill bei fast allem anspringt und dabei völlig themenfremde Gespräche kapert. Die Lösung heißt Eingrenzung. Eine eng gefasste Beschreibung mit klaren Auslösebedingungen greift dann, wenn sie soll – und bleibt sonst ruhig.
Mehrere Skills und Priorisierung. Wenn mehrere Skills passen könnten, wägt Claude die Relevanz ab. Prioritätskonflikte sind eine echte Fehlerquelle, und ein wichtiger Teil eines guten Skill-Designs besteht darin, sicherzustellen, dass sich zwei Skills mit überlappenden Beschreibungen nicht denselben Bereich streitig machen.
Dynamischer Kontext. Laufzeitvariablen, die gerade geöffneten Dateien, die verbundenen Tools, die Formulierung der Anfrage – all das beeinflusst, welcher Skill aktiviert wird. Ein Skill, der sich auf eine Datenbank bezieht, aktiviert sich eher, wenn eine Datenbankverbindung besteht. Genau diese Berücksichtigung des dynamischen Kontexts sorgt dafür, dass ein Skill so wirkt, als würde er "einfach wissen", wann er helfen muss.
Wer den ganzen Tag Skills baut und testet, verbraucht sein Claude-Abo ziemlich schnell. Claude Pro kostet 20 $/Monat, Max liegt bei 100 bis 200 $/Monat, abgerechnet in USD. Zahlst du mit Bleap, sparst du dir 0 % FX-Gebühren und bekommst obendrauf 20 % Cashback pauschal auf Claude, ChatGPT und Gemini – ganz ohne Kartenabo. Hol dir die Bleap-Karte →
3. Deinen ersten Claude Skill erstellen: Eine Schritt-für-Schritt-Anleitung
Genug Theorie. Bauen wir gemeinsam einen funktionierenden Skill von Anfang bis Ende. Wir nehmen ein reales Beispiel, einen Code Review Checklist Skill, und gehen jeden Schritt durch, von der Einrichtung bis zum ersten erfolgreichen Aufruf.
Voraussetzungen und Einrichtung der Umgebung
Zunächst solltest du prüfen, ob du überhaupt Zugriff hast. Die Erstellung von Skills ist über Claude Code, die Claude API und Claude.ai möglich, wobei die organisationsweite Verwaltung noch in der Entwicklung ist. Nach aktuellem Stand sind Skills in Claude.ai derzeit nutzerindividuell, organisationsweite Verwaltungs- und Freigabefunktionen sollen aber bald folgen. Bis dahin empfiehlt es sich, ein gemeinsames Dokumentenrepository mit Skill-Spezifikationen anzulegen, um für die kommenden Funktionen gerüstet zu sein und schon jetzt eine gute Governance aufzubauen.
Für den kostenpflichtigen Zugriff sind die passenden Claude-Pläne recht übersichtlich. Die Claude-Preise 2026 verteilen sich auf sieben Stufen: Free (0 $), Pro (20 $/Monat), Claude Max 5x (100 $/Monat), Max 20x (200 $/Monat), Team Standard (25 $/Nutzer/Monat), Team Premium (125 $/Nutzer/Monat) und Enterprise (individuell). Wenn du Skills im Rahmen eines Team-Workflows entwickelst, bieten dir die Team- und Enterprise-Pläne die Admin-Kontrollen, die du früher oder später brauchen wirst. Wer automatisiert und programmatisch arbeitet, zahlt die API separat pro Token.
Benötigtes Wissen. Ehrlich gesagt nicht viel. Grundlegende Markdown-Kenntnisse und ein klares Verständnis der Aufgabe, die du automatisieren möchtest. Das reicht schon.
Empfohlene Tools. VS Code mit einer Markdown-Vorschau-Erweiterung macht das Schreiben von SKILL.md deutlich angenehmer. Git gibt dir von Anfang an eine Versionskontrolle an die Hand. Halte außerdem eine eigene Claude-Konversation nur zum Testen offen, getrennt von deiner eigentlichen Arbeit, damit sich der Kontext nicht mit deinen Tests vermischt.
Lokaler Entwicklungsordner. Richte dir einen Ordner ein, bevor du irgendetwas veröffentlichst, damit deine Skills ein sauberes Zuhause und eine nachvollziehbare Versionshistorie haben.
Drei Wege, einen Skill zu erstellen. Du kannst direkt in einem skills/-Verzeichnis in Claude Code schreiben, ihn über die Claude API hochladen oder mit Anthropics Vorlage starten. Skills, die Claude vom Allround-Assistenten zum spezialisierten Experten machen, kannst du entweder mit der Skill-Creator-Vorlage oder manuell erstellen. Am einfachsten ist es aber, die SKILL.md-Datei mit der Vorlage aufzubauen und von dort aus anzupassen.
Deinen Skill planen, bevor du eine einzige Zeile schreibst
Widersteh dem Drang, sofort den Editor aufzumachen. Die besten Skills werden zuerst durchdacht. Anthropics Leitfaden ist da eindeutig: Bevor du überhaupt eine Datei anfasst, solltest du zwei oder drei konkrete Anwendungsfälle festlegen und dir überlegen, welches Fachwissen oder welche Best Practices eingebaut werden sollten, die der Nutzer sonst jedes Mal neu erklären müsste.
Beantworte diese fünf Fragen, bevor du anfängst zu schreiben:
- Welche konkrete Aufgabe ermöglicht dieser Skill? In unserem Beispiel: „Einen Code-Diff anhand der Qualitäts-Checkliste unseres Teams prüfen und einen strukturierten Ergebnisbericht erstellen.“
- Wie erkennt Claude oder der Nutzer, wann der Skill eingesetzt werden soll? Immer wenn jemand einen Diff oder Pull Request teilt oder um ein Code-Review bittet.
- Welche Informationen müssen im Kontext vorhanden sein, damit der Skill funktioniert? Die Checklisten-Kriterien und das Ausgabeformat. Der Code selbst kommt vom Nutzer.
- Welche Tools braucht der Skill, falls überhaupt? Für eine reine Checkliste keine. Würde er Linter ausführen, bräuchte er Zugriff auf Skripte.
- Wer soll Zugriff haben? Fang privat an und weite es aufs Team aus, sobald sich der Skill bewährt hat.
Lieber eng fassen als zu breit. Ein Skill, der „bei Code hilft“, ist nutzlos, weil er bei allem anspringt und nichts Konkretes liefert. Ein Skill, der „Python-Pull-Requests anhand der Team-Checkliste prüft und Ergebnisse nach Schweregrad gruppiert ausgibt“, ist präzise, springt zuverlässig an und liefert konstant brauchbare Ergebnisse. Enger gefasst gewinnt fast immer.
Schreib zuerst die Beschreibung – wie ein Lastenheft. Behandle die Beschreibung wie eine Spezifikation. Wenn du nicht in zwei, drei Sätzen erklären kannst, was der Skill genau macht und wann er zum Einsatz kommen soll, bist du noch nicht so weit, den Hauptteil zu schreiben.
Finde das minimal sinnvolle Skill-Konzept. Starte mit der kleinstmöglichen Version, die schon einen echten Nutzen bringt, bring sie live und arbeite dich von dort aus weiter vor. Anthropic formuliert das Ziel klar: Am Ende sollst du in der Lage sein, einen funktionierenden Skill in einer einzigen Sitzung zu bauen – genau das verspricht der offizielle Guide jedem, der sich an die vorgegebene Struktur hält.
Schritt 1: Verzeichnis für deinen Skill anlegen
Erstelle einen Ordner für den Skill. Die empfohlene Struktur:
code-review-checklist/
├── SKILL.md ← erforderlich
├── references/ ← optionales Hintergrundwissen
├── scripts/ ← optionale ausführbare Hilfsskripte
└── assets/ ← optionale statische Dateien
Das entspricht genau Anthropics eigener Konvention. Im Skill-Ordner liegt eine SKILL.md-Datei (Pflicht) sowie optional ein scripts/-Verzeichnis für ausführbaren Code, ein references/-Verzeichnis für Dokumentation, die Claude bei Bedarf lädt, und ein assets/-Verzeichnis für Vorlagen und weitere unterstützende Dateien.
Namenskonventionen. Verwende Kebab-Case für Ordnernamen (code-review-checklist, nicht CodeReviewChecklist). Setze ein Kategorie-Präfix davor, damit eine größere Sammlung übersichtlich bleibt: qa-, dev-, ops-, content-. Unser Beispiel könnte also als dev-code-review-checklist abgelegt werden.
Ein Verzeichnis pro Skill. Jeden Skill in sich abgeschlossen zu halten ist mehr als nur Ordnung. Es bedeutet, dass du Skills unabhängig voneinander versionieren, teilen und verschieben kannst – ein enormer Vorteil, sobald du Dutzende davon hast. Jeder Skill ist in seinem eigenen Ordner in sich geschlossen, mit einer SKILL.md-Datei, die die Anweisungen und Metadaten enthält, die Claude verwendet.
Versionskontrolle. Initialisiere Git im Ordner oder im übergeordneten Verzeichnis und nutze Git-Tags für die Skill-Versionen. Wenn du einen Skill von 1.2.0 auf 1.3.0 hochstufst, tag ihn. Dein zukünftiges Ich, das rätselt, warum sich das Verhalten letzten Dienstag verändert hat, wird es dir danken.
Schritt 2: Die SKILL.md-Datei schreiben (Minimalversion)
Hier ist ein vollständiges, funktionierendes SKILL.md für unser Code-Review-Checklist-Skill. Das ist die komplette Datei, vom Frontmatter bis zum Body.
---
name: code-review-checklist
description: >
Reviews code diffs and pull requests against the team's quality
checklist and returns findings grouped by severity. Use this skill
whenever the user shares a diff, a pull request, a code snippet for
review, or asks for a code review, quality check, or PR feedback,
even if they do not explicitly say "checklist."
version: 1.0.0
# Code Review Checklist
You are performing a structured code review. Work through every
item in the checklist below against the code the user provides.
## Checklist
1. **Correctness**, Does the code do what it claims? Flag logic errors.
2. **Null and error handling**, Are edge cases and failures handled?
3. **Security**, Flag hardcoded secrets, unsafe input handling, or
injection risks.
4. **Tests**, Is there adequate test coverage for the change?
5. **Naming and style**, Do names follow our conventions
(kebab-case files, camelCase variables)?
6. **Readability**, Could a new teammate understand this in 60 seconds?
## Output format
Group findings under three headings: **Blocking**, **Should fix**, and
**Nice to have**. For each finding, cite the relevant line or function
and give a one-line, actionable recommendation. End with a one-sentence
overall verdict.
## Guidelines
- If the code is clean, say so plainly. Do not invent issues.
- Be specific. "Improve error handling" is useless;
"wrap the file read in a try/except" is useful.
- Do not rewrite the whole file unless asked. Point to the fix.
Dieser Aufbau orientiert sich eng an Anthropics Vorlage. Die öffentliche Vorlage zeigt das gleiche Grundgerüst: einen Namen und eine klare Beschreibung, was das Skill macht und wann man es einsetzt, eine Überschrift mit Anweisungen, denen Claude folgt, sobald das Skill aktiv ist, einen Beispiele-Abschnitt und einen Guidelines-Abschnitt.
Lasst uns das Wichtigste kommentieren:
- Die description leistet die meiste Arbeit. Achte darauf, dass sie bewusst "aufdringlich" formuliert ist und die Situationen auflistet, die sie auslösen sollen – inklusive des Falls, dass der Nutzer nicht explizit das Wort "Checkliste" verwendet. Das beugt einem zu seltenen Auslösen vor.
- Der Hauptteil ist eine klare Anleitung, kein vager Vorschlag. Die Punkte der Checkliste sind konkret und jeder einzelne ist umsetzbar.
- Das Ausgabeformat ist festgelegt. Genau das macht aus "irgendeinem Feedback" jedes Mal einen konsistenten, vergleichbaren Bericht.
- Die Richtlinien schließen Schlupflöcher, indem sie Claude sagen, keine Probleme zu erfinden und nicht zu viel umzuschreiben.
Typische Anfängerfehler. Zu knapp gehaltene Beschreibungen. Anweisungen, die im Widerspruch zu Claudes Standardverhalten stehen (zum Beispiel, wenn man Claude bittet, sich kurz zu fassen, und gleichzeitig ausführliche Erklärungen verlangt). Textkörper, die über jedes sinnvolle Maß hinauswachsen. Und Ausgabeformate, die nur implizit vorgegeben sind, was zu uneinheitlichen Ergebnissen führt.
Der Laut-Vorlese-Test. Lies deine SKILL.md laut vor. Klingt ein Satz für dich verworren oder mehrdeutig, wird er auch Claude verwirren. Klares Schreiben ist hier keine nette Zugabe – es ist die eigentliche Ingenieursaufgabe.
Schritt 3: Den Skill veröffentlichen
Wie du veröffentlichst, hängt von deiner Umgebung ab.
In Claude Code legst du den Ordner einfach in das skills/-Verzeichnis deines Projekts, und Claude übernimmt ihn automatisch. Du erstellst ein Skills-Verzeichnis im Root deines Plugins oder Projekts und fügst Skill-Ordner mit SKILL.md-Dateien hinzu – Claude erkennt und nutzt sie dann automatisch, sobald das Plugin installiert ist.
Über die API lädst du den Skill-Ordner mithilfe der Skills API hoch. Die Dokumentation von Anthropic enthält dafür einen eigenen Skills API Quickstart.
In Claude.ai fügst du den Skill über die Skills-Oberfläche in deinem Workspace hinzu, fügst die SKILL.md ein oder lädst sie hoch und legst die anfängliche Zugriffsebene fest. Denk daran: In Claude.ai sind Skills aktuell auf den einzelnen Nutzer beschränkt, eine breitere Freigabe ist für die Roadmap geplant.
Zugriffsebene festlegen. Fang privat an. Beweise erst, dass der Skill isoliert funktioniert, bevor du ihn einem Team oder Workspace zugänglich machst. Es ist deutlich einfacher, den Zugriff später zu erweitern, als einen kaputten Skill wieder einzufangen, auf den sich bereits ein Dutzend Leute verlässt.
Nach der Veröffentlichung gibt es einen kurzen Indexierungsschritt, bei dem die Metadaten in den System-Prompt geladen werden. In einer laufenden Sitzung musst du eventuell neu laden oder von vorn beginnen, damit ein neu hinzugefügter Skill verfügbar wird.
Schritt 4: Führe deinen ersten Testaufruf durch
Öffne eine neue Unterhaltung. Das ist wichtig. Eine bestehende Unterhaltung bringt Kontext mit, der verschleiern kann, ob dein Skill tatsächlich ausgelöst wurde oder ob Claude nur auf frühere Nachrichten reagiert.
Teste zuerst den impliziten Aufruf. Füge einen Code-Diff ein und sag einfach: „Kannst du das reviewen?" Erwähne den Skill nicht namentlich. Wenn deine Beschreibung gut ist, sollte Claude automatisch auf den Skill zurückgreifen und die Ausgabe in deinem definierten Format liefern.
Teste danach den expliziten Aufruf. Verweise direkt auf den Skill und bestätige, dass er auf Abruf ausgelöst wird.
Interpretiere die Antwort. Das klarste Signal dafür, dass der Skill geladen wurde, ist, dass die Ausgabe exakt deinem definierten Format entspricht: Befunde gruppiert unter Blocking, Should fix und Nice to have, mit einem Ein-Satz-Fazit. Bekommst du stattdessen generisches Feedback in Fließtext, hat der Skill wahrscheinlich nicht ausgelöst.
Fünf Anzeichen dafür, dass dein Skill funktioniert:
- Die Ausgabe folgt exakt deinem festgelegten Format.
- Claude wendet deine spezifischen Checklistenpunkte an, nicht nur allgemeine Best Practices.
- Sie hält sich an eure Vorgaben (erfindet keine Probleme bei sauberem Code).
- Sie greift bei natürlichen Anfragen, ohne dass ihr sie explizit ansprechen müsst.
- Das Verhalten bleibt bei wiederholten Tests mit unterschiedlichen Eingaben konsistent.
Wenn das Auslösen unzuverlässig ist, denkt an die Trennung der Zuständigkeiten: Probleme beim Triggern behebt ihr, indem ihr die Beschreibung breiter und schärfer formuliert; Probleme bei der Ausgabequalität behebt ihr, indem ihr dem Hauptteil mehr Details und Validierungsschritte hinzufügt.
Typische Anfängerfehler und wie man sie behebt
Ein paar wiederkehrende Fehler sind für den Großteil des anfänglichen Frustes verantwortlich.
Anweisungen, die gegen Claudes Standardverhalten arbeiten. Wenn eure Skill Claude anweist, sich entgegen seinem üblichen Verhalten zu verhalten, ohne das klar zu begründen, bekommt ihr inkonsistente Ergebnisse. Lösung: Erklärt explizit, warum die Abweichung nötig ist, und überprüft das Ergebnis.
Beschreibungen, die so breit gefasst sind, dass die Skill bei allem auslöst. Eine Skill, die bei jeder Nachricht anspringt, ist schlimmer als nutzlos. Lösung: Den Anwendungsbereich eingrenzen und konkrete Auslösebedingungen festlegen.
Falsche Zugriffsebene vor dem Teilen. Eine Skill teamweit zu veröffentlichen, bevor sie getestet wurde, oder eine fehlerhafte Skill offen zugänglich zu lassen. Lösung: Erst privat testen, den Zugriff erst nach erfolgreicher Validierung erweitern.
Überladene Inhalte. Eine aufgeblähte SKILL.md verschwendet Kontext und verschüttet die wichtigen Anweisungen. Lösung: Haltet den Hauptteil unter 500 Zeilen und lagert zusätzliche Details in references/ aus. Wie es in den Richtlinien heißt: Beschränkt den SKILL.md-Hauptteil aufs Wesentliche und bleibt unter 500 Zeilen – nähert ihr euch diesem Limit, teilt den Inhalt auf separate Dateien auf.
Randfälle nicht getestet. Eine Skill, die im Normalfall funktioniert, aber bei ungewöhnlichen Eingaben versagt, untergräbt schnell das Vertrauen. Lösung: Baut euch eine ordentliche Testfall-Bibliothek auf. Erstellt eine Sammlung von Testfällen, die normale Nutzung, Randfälle und Anfragen außerhalb des Anwendungsbereichs abdeckt.
4. Der Aufbau der SKILL.md-Datei: Metadaten, Frontmatter und Textkörper
Du hast jetzt einen funktionierenden Skill gebaut. Schauen wir uns die Datei selbst mal genauer an, denn wer die Struktur von SKILL.md wirklich beherrscht, kommt von Skills, die meistens funktionieren, zu Skills, die zuverlässig funktionieren – im großen Maßstab und teamübergreifend.
Das SKILL.md-Dateiformat verstehen
Warum Markdown? Weil es für Menschen gut lesbar ist, sich in Git sauber vergleichen lässt, überall unterstützt wird und zu Klarheit zwingt. Markdown ist außerdem die Sprache, in der Claude strukturierten Text ohnehin schon "denkt" – Anweisungen in Markdown sind also Anweisungen, denen Claude ganz natürlich folgt. Das ist keine Zufallsentscheidung: Skills sollen genauso von Menschen geschrieben und geprüft werden können, wie sie von Claude ausgeführt werden.
Die zweiteilige Struktur. Jede SKILL.md-Datei besteht aus einem YAML-Frontmatter-Block, gefolgt von einem Markdown-Textkörper. Eine SKILL.md-Datei muss mit einem YAML-Frontmatter beginnen, das einen Dateinamen und eine Beschreibung enthält – diese werden beim Start in den System-Prompt geladen. Das Frontmatter liefert die Metadaten, der Textkörper die eigentlichen Anweisungen.
Wie beide Teile unterschiedlich behandelt werden. Genau das ist der Kern der Progressive-Disclosure-Architektur. Das Frontmatter wird immer geladen. Der Textkörper nur dann, wenn er relevant ist. Das YAML-Frontmatter wird immer in Claudes System-Prompt geladen und kostet dabei etwa 100 Tokens pro Skill – das reicht Claude gerade aus, um die Relevanz einzuschätzen, ohne gleich den kompletten Inhalt laden zu müssen. Der SKILL.md-Textkörper wird erst geladen, wenn Claude entscheidet, dass der Skill relevant ist, und enthält dann die vollständigen Anweisungen, Schritt-für-Schritt-Abläufe, Beispiele und Hinweise zur Fehlerbehebung.
Grenzen der Dateigröße. Es gibt keine strikte, allgemeingültige Zahl, aber als praktische Faustregel gilt: unter 500 Zeilen bleiben. Wird das überschritten, solltest du Inhalte in references/-Dateien auslagern, die Claude bei Bedarf nachlädt. Genau dafür hat Anthropic eine dritte Offenlegungsebene entwickelt: Wenn ein Skill für eine einzelne SKILL.md zu groß wird, übernehmen unterstützende Dateien den Überschuss. Je komplexer Skills werden, desto mehr Kontext kann anfallen, als in eine einzige SKILL.md passt.
Kodierung und Formatierung. Verwende UTF-8-Kodierung und Standard-Zeilenumbrüche. Halte dein Markdown sauber und gut strukturiert, denn die Struktur selbst ist für Claude ein Signal, wie Informationen zu priorisieren sind.
Was die Datei enthält im Vergleich zu dem, was Claude erhält. Das ist nicht dasselbe. Die Datei enthält alles: Frontmatter, Hauptinhalt und Verweise auf Ressourcen. Was Claude zu einem bestimmten Zeitpunkt tatsächlich erhält, hängt von der Offenlegungsebene ab. Beim Start bekommt Claude nur deine ~100-Token-Metadaten. Bei Aufruf des Skills erhält es den Hauptinhalt. Referenzierte Dateien liest es nur, wenn der Hauptinhalt es dazu anweist. Wenn du das bei der Gestaltung mitdenkst, macht das den Unterschied zwischen einem effizienten Skill und einem, der still und heimlich Kontext verschwendet.
YAML-Frontmatter: Jedes Feld erklärt
Das Frontmatter ist klein, aber entscheidend. Zwei Felder sind Pflicht (name und description); der Rest ist optional, aber im großen Maßstab wertvoll. Hier die vollständige Übersicht.
name, die kanonische Kennung des Skills. Verwende Kebab-Case, halte den Namen aussagekräftig und sorge dafür, dass er innerhalb deines Workspace eindeutig ist, damit keine Verwechslungsgefahr besteht, welcher Skill gemeint ist. code-review-checklist ist gut gewählt, helper nicht. Der Name ist sowohl eine für Menschen verständliche Bezeichnung als auch, bei expliziter Aufrufung, der Begriff, den Nutzer tatsächlich verwenden.
version, semantische Versionierung im Format MAJOR.MINOR.PATCH. Erhöhe den PATCH-Wert für kleine Fixes und Klarstellungen, den MINOR-Wert für neue Funktionen, die weiterhin abwärtskompatibel bleiben, und den MAJOR-Wert für Änderungen, die bestehendes Verhalten so verändern, dass es aktuelle Nutzer überraschen könnte. Versionierung sorgt dafür, dass ein Team genau weiß, welches Verhalten es bekommt – sie ist das Rückgrat sicherer Iteration. Wenn du neu veröffentlichst, tagge die Version in Git, damit Datei-Historie und Versionsnummer synchron bleiben.
description, das mit Abstand wichtigste Feld. Es steuert das Auslösen (Invocation Routing) über semantisches Matching und wird immer geladen – es muss sich also seine rund 100 Token wirklich verdienen. Richtlinien, die sich in der Praxis bewährt haben:
- Ziel: etwa 100 bis 200 Wörter. Lang genug, um spezifisch zu sein, kurz genug, um im Always-Loaded-Budget zu bleiben.
- Schreibe auf semantische Ähnlichkeit hin, nicht auf Keyword-Stuffing. Beschreibe die Situationen, die der Skill abdeckt, statt eine Liste von Schlagwörtern aufzuzählen.
- Sei ruhig etwas "aufdringlich", um Untertriggerung zu vermeiden. Liste explizit die Auslöseszenarien auf, auch die impliziten. Denk an Anthropics Beispiel, bei dem klar formuliert wird, dass ein Dashboard-Skill immer dann anspringen soll, wenn ein Nutzer Datenvisualisierung oder interne Metriken erwähnt – selbst wenn nicht ausdrücklich nach einem Dashboard gefragt wird.
- Eine starke Beschreibung liest sich so: "Überprüft Code-Diffs und Pull Requests anhand der Qualitäts-Checkliste des Teams und liefert die Ergebnisse nach Schweregrad gruppiert zurück. Einsetzen, wann immer der Nutzer einen Diff, PR oder Code-Schnipsel zur Überprüfung teilt." Eine schwache liest sich so: "Hilft bei Code." Die erste triggert korrekt, die zweite triggert bei allem oder gar nichts.
author, Zuordnung zu einer Person oder einem Team. Das ist wichtiger, als es zunächst aussieht. Es schafft Verantwortlichkeit (wer diesen Skill besitzt und wen man fragt, wenn er sich falsch verhält) und unterstützt die Governance, wenn deine Skill-Bibliothek wächst.
tags, eine Taxonomie-Strategie, damit sich große Bibliotheken durchsuchen lassen. Empfohlene Kategorien: Bereich (security, data, content), Funktion (review, generation, analysis), Zielgruppe (engineering, support, marketing) und Reifegrad (experimental, stable, deprecated). Nur mit konsistenter Verschlagwortung bleibt eine Bibliothek mit 40 Skills übersichtlich statt chaotisch.
trigger_phrases, ein optionales Array mit Beispielformulierungen, die den Skill auslösen sollen. Sie verbessern die Trefferquote bei der Erkennung, weil Claude damit konkrete Anhaltspunkte bekommt. Fünf bis zehn Beispiele sind der Sweet Spot: genug, um die gängigsten Formulierungen abzudecken, aber nicht so viele, dass man am Ende nur die Beschreibung wiederholt. Beachte, dass die Unterstützung dieses Felds je nach Umgebung variiert – prüfe also das aktuelle Schema für dein Setup. Wo es kein offizielles Feld dafür gibt, packst du entsprechende Beispiele einfach in den Beschreibungstext.
arguments, Definitionen für dynamische Eingaben, die Aufrufer an den Skill übergeben. Jedes Argument legt üblicherweise einen Namen, einen Typ, ob es Pflicht oder optional ist, sowie einen Standardwert fest. Argumente machen einen Skill erst flexibel: Ein Skill zur Berichterstellung könnte etwa ein format-Argument (Standard markdown) oder einen severity_threshold haben. Halte die Argumente möglichst schlank und gut dokumentiert – denn jedes zusätzliche Argument ist etwas, das der Aufrufer verstehen muss, und ein weiterer Pfad, den du testen musst.
Einen wirksamen SKILL.md-Textkörper schreiben
Im Textkörper steckt das eigentliche Fachwissen, und wie du ihn formulierst, entscheidet direkt darüber, wie zuverlässig Claude die Aufgabe ausführt.
Passe die Vorgaben an den Freiraum der Aufgabe an. Anthropic nutzt hier einen anschaulichen Vergleich: Stell dir Claude vor, wie es einen Pfad erkundet – eine schmale Brücke mit Abgründen braucht klare Leitplanken (wenig Freiraum), während ein offenes Feld viele Wege zulässt (viel Freiraum). Also solltest du die Vorgaben deines Skills an das jeweilige „Gelände“ anpassen. Ein Skill zur Compliance-Prüfung braucht enge, genau vorgeschriebene Schritte. Ein Brainstorming-Skill kann deutlich mehr Spielraum lassen. Schränke kreative Aufgaben nicht zu stark ein – und lass bei kritischen Aufgaben nicht zu viel Freiraum.
Baue den Hauptteil vorhersehbar auf. Ein zuverlässiges Muster sieht so aus: eine kurze Aufgabenbeschreibung in einer Zeile, eine Schritt-für-Schritt-Anleitung, ein festes Ausgabeformat und ein Abschnitt mit Richtlinien, der Schlupflöcher schließt. Anthropics eigene Workflow-Beispiele folgen genau diesem Muster und enden mit einer Art Qualitätskontrolle: Entwurf gemäß der Kopfzeilenstruktur und der Ton-Richtlinien erstellen, dann die Checkliste zur Qualitätssicherung durchgehen, bevor der Entwurf abgegeben wird.
Nutze Beispiele und Validierungsschritte. Konkrete Beispiele helfen Claude, die Aufgabe besser zu verstehen, und klare Validierungsschritte fangen Fehler ab, bevor sie beim Nutzer landen. Wenn die Ergebnisse uneinheitlich ausfallen, liegt die Lösung fast immer in mehr Präzision und mehr Validierung – nicht in mehr Text.
Halte es schlank. Jede Zeile, die du hinzufügst, wird beim Aufruf mit in den Kontext geladen. Die Empfehlung von unter 500 Zeilen kommt nicht von ungefähr – sie schützt dein Kontext-Budget und verhindert, dass die wichtigen Anweisungen untergehen.
Unterstützende Dateien nutzen: Referenzen, Skripte und Assets
Die optionalen Verzeichnisse sind der Schlüssel, um SKILL.md schlank zu halten und Claude trotzdem bei Bedarf Zugriff auf mehr Informationen zu geben. Das ist die dritte Stufe der schrittweisen Offenlegung (Progressive Disclosure).
references/ enthält Dokumentation, die Claude bei Bedarf lädt: detaillierte Spezifikationen, umfangreiche Referenztabellen, Style-Guides. Der Haupttext verweist auf diese Dateien, und Claude liest sie nur, wenn die Aufgabe es erfordert. So lässt sich ein Skill mit einer großen Wissensbasis nutzen, ohne bei jedem Aufruf die Kontextkosten dafür zu tragen.
scripts/ enthält ausführbare Helfer. Wenn ein Skill etwas Deterministisches erledigen muss – etwa einen Linter ausführen, eine Datei parsen oder eine API aufrufen – ist ein Skript zuverlässiger, als Claude die Arbeit nur simulieren zu lassen. Der Haupttext gibt vor, wann und wie jedes Skript ausgeführt wird.
assets/ enthält statische Dateien: Vorlagen, Schemas, Boilerplate-Code, Bilder. Ein Skill zur Dokumentenerstellung bewahrt hier zum Beispiel seine Report-Vorlage auf.
Das Grundprinzip dahinter ist ziemlich elegant. Um Skills zu aktivieren, musst du nur eine SKILL.md-Datei mit individuellen Anweisungen für deinen Agenten schreiben. Ein Skill ist im Kern ein Verzeichnis mit einer SKILL.md-Datei und darin organisierten Ordnern für Anweisungen, Skripte und Ressourcen, die dem Agenten zusätzliche Fähigkeiten geben. Fang einfach nur mit der SKILL.md an und ergänze weitere Verzeichnisse erst dann, wenn der Inhalt wirklich zu umfangreich für eine einzelne Datei wird.
Zugriffskontrolle und Paketierung für Teams
Zwei Dinge sind für den produktiven Einsatz noch wichtig: wer einen Skill nutzen darf und wie man ihn verteilt.
Zugriffskontrolle. Lege die Zugriffsebenen bewusst fest: privat für Entwicklung und Tests, Team- oder Workspace-Ebene, sobald sich der Skill bewährt hat. Da Claude.ai Skills derzeit noch auf einzelne Nutzer beschränkt, sollten Teams in der Zwischenzeit ein gemeinsames Repository mit Spezifikationen pflegen. Es empfiehlt sich, ein gemeinsames Dokumenten-Repository mit Skill-Spezifikationen anzulegen – das bereitet die Organisation schon jetzt auf kommende Funktionen vor und sorgt gleichzeitig für eine solide Governance.
Verpackung und Verteilung. Sobald ein Skill wirklich rund läuft, solltest du ihn ordentlich verteilen, statt einfach Dateien hin- und herzuschicken. Der bewährte Weg führt über Git, Plugins und Enterprise-Einstellungen. Du kannst Skills mit deinem Team teilen, indem du sie in ein Repository einpflegst, sie über Plugins breiter streuen oder sie unternehmensweit über die Enterprise-Managed-Settings ausrollen. Für Governance im größeren Maßstab gibt es für Enterprise-Kunden zusätzliche Unterstützung. Enterprise-Kunden können sich mit dem Customer-Success-Team von Anthropic zusammensetzen, um weitere Deployment-Optionen und Governance-Frameworks zu besprechen.
Testen vor der Verteilung. Verteile niemals einen Skill, den du nicht an einer realistischen Sammlung von Testfällen ausprobiert hast. Deck dabei den normalen Ablauf ab, die Grenzfälle und – ganz entscheidend – die Anfragen außerhalb des eigentlichen Anwendungsbereichs, bei denen der Skill nicht anspringen sollte. Gerade Letzteres hilft dir, ein zu häufiges Auslösen des Skills zu erkennen, bevor es deinen Kolleginnen und Kollegen auffällt.
5. Fortgeschrittene Muster: MCP-Integration, Subagenten und Tool-Freigabe
Sobald du dich mit einzelnen Skills sicher fühlst, entsteht der eigentliche Mehrwert durch die Kombination mit dem Rest der Claude-Plattform. Dieser Abschnitt behandelt die Muster, mit denen aus einer Skill-Bibliothek echte Automatisierung wird.
MCP-Integration mit Claude Skills
Das Model Context Protocol verbindet Claude mit externen Systemen: Datenbanken, APIs, Dateispeicher, interne Tools. Skills und MCP ergänzen sich, statt in Konkurrenz zu stehen. MCP liefert die Verbindung; der Skill liefert die Vorgehensweise, um diese Verbindung sinnvoll zu nutzen.
Ein konkretes Beispiel: MCP verbindet Claude mit deiner Analytics-Datenbank. Allein kann Claude zwar Abfragen stellen, kennt aber weder eure Tabellenkonventionen noch eure Definitionen zentraler Kennzahlen oder das Format, in dem euer Team Berichte erwartet. Genau das liefert ein Skill. Er sagt Claude, welche Tabellen welche Daten enthalten, wie "aktiver Nutzer" in eurem Unternehmen definiert ist und wie die Ausgabe genau aussehen soll. Zusammen machen beide aus einer reinen Verbindung einen verlässlichen Analysten.
Anthropics Beispielbibliothek enthält sogar die Generierung von MCP-Servern als eine der demonstrierten Skills – ein Beleg dafür, wie gut die beiden Ebenen zusammenpassen. Wenn du einen Skill zur Tool-Aktivierung entwirfst, geh davon aus, dass MCP den Transport übernimmt, und konzentriere dich in deiner SKILL.md auf die Entscheidungslogik: wann das Tool zum Einsatz kommt, welche Parameter übergeben werden und wie das Ergebnis validiert wird.
Claude Subagenten und Skill-Delegation
Mit Subagenten kannst du eine klar abgegrenzte Aufgabe an einen separaten Agenten mit eigenem, isoliertem Kontext delegieren. Kombinierst du einen Subagenten mit einem Skill, erhältst du einen Experten für eine bestimmte Aufgabe, der deine Hauptkonversation nicht überfrachtet.
Das Muster spielt seine Stärke bei mehrstufigen Pipelines aus. Stellen Sie sich einen Release-Workflow vor: Ein Subagent mit einer Code-Review-Skill prüft den Diff, ein zweiter mit einer Changelog-Skill entwirft die Release Notes, ein dritter mit einer QA-Skill erstellt einen Testplan. Jeder arbeitet isoliert und hat nur den Kontext, den er wirklich braucht. Anthropic beschreibt genau diese Funktion. Man kann Skills in benutzerdefinierte Subagenten einbinden, um Aufgaben isoliert an Spezialisten zu delegieren, und es gibt eine vollständige Anleitung zur Fehlerbehebung – von Skills, die nicht auslösen, bis zu Prioritätskonflikten und Laufzeitfehlern.
Der Vorteil liegt auf zwei Ebenen: ein saubererer Kontext (die Hauptunterhaltung wird nicht durch die Arbeitsnotizen des Subagenten belastet) und eine klarere Spezialisierung (jeder Subagent macht eine Sache richtig gut). Der Preis dafür ist zusätzliche Koordinationskomplexität – Subagenten lohnen sich also dort, wo eine Aufgabe wirklich von Isolation profitiert, nicht bei allem.
Claude Tool-Freigabe und Zugriffskontrolle
Wenn eine Skill Claude die Fähigkeit gibt, Tools zu nutzen – vor allem solche, die echte Aktionen auslösen, wie E-Mails versenden, in eine Datenbank schreiben oder eine kostenpflichtige API aufrufen –, wird die Tool-Freigabe zu einer sicherheitskritischen Angelegenheit. Das Prinzip dahinter: möglichst wenig Rechte. Eine Skill sollte nur die Tools freischalten, die sie wirklich braucht, und Aktionen mit echten Konsequenzen sollten eine Bestätigung erfordern.
Gestalten Sie Ihre Tool-Aktivierungs-Skills so, dass Lesezugriffe ungehindert ablaufen, während Schreib- oder destruktive Operationen erst nach Freigabe ausgeführt werden. Dokumentieren Sie im SKILL.md-Body genau, welche Tools die Skill nutzt und unter welchen Bedingungen – damit sowohl Claude als auch jeder menschliche Prüfer den möglichen Wirkungsbereich versteht. Genau hier zahlen sich auch das author-Feld und eine saubere Versionierung aus: Wenn eine Skill Aktionen ausführen kann, braucht es eine eindeutige Zuordnung, wer dafür verantwortlich ist und welche Version gerade aktiv ist.
Für Unternehmen knüpft das direkt an die verwalteten Enterprise-Einstellungen an, bei denen Administratoren festlegen können, wer Zugriff auf welche Skills und Tools hat. Die Tool-Freigabe sollte von Anfang an Teil des Skill-Designs sein, nicht nachträglich aufgesetzt werden. Ein Skill, der handeln kann, kann auch Schaden anrichten, wenn er fälschlicherweise auslöst – ein weiterer Grund, Beschreibungen eng zu fassen und Anfragen außerhalb des vorgesehenen Bereichs gründlich zu testen.
Skill-Testing und Qualitätssicherung im großen Maßstab
Einen einzelnen Skill zu testen ist einfach. Die Qualität über eine wachsende Bibliothek hinweg zu halten, erfordert Disziplin. Drei Praktiken machen dabei den Unterschied.
Trenne Auslöse-Tests von Ausführungs-Tests. Wie bereits erwähnt, handelt es sich hier um unterschiedliche Fehlerarten. Pflege für beide separate Testfälle: einen Satz, der prüft, ob der Skill auslöst (und nicht auslöst, wenn er es nicht soll), und einen weiteren, der die Qualität der Ausgabe nach der Auslösung überprüft. Teste Auslösung und Ausführung getrennt voneinander. Wenn Skills nicht aktiviert werden, erweitere die Beschreibung und ergänze Anwendungsfälle. Sind die Ergebnisse uneinheitlich, füge den Anweisungen mehr Genauigkeit hinzu und baue Validierungsschritte ein.
Baue dir eine ordentliche Testfall-Bibliothek auf. Halte für jeden Skill dokumentierte Fälle fest, die normale Nutzung, Grenzfälle und Anfragen außerhalb des Anwendungsbereichs abdecken. Führe sie bei jeder Änderung am Skill erneut aus. So fängst du Rückschritte ab, bevor sie bei den Nutzern ankommen – das ist die wertvollste Gewohnheit für eine wachsende Bibliothek.
Achte auf Prioritätskonflikte. Je mehr deine Bibliothek wächst, desto eher konkurrieren zwei Skills mit überlappenden Beschreibungen miteinander. Ein Teil der Qualitätssicherung im großen Maßstab besteht darin, Beschreibungen auf Überschneidungen zu prüfen und den Geltungsbereich so zu schärfen, dass jeder Skill sein klar abgegrenztes Terrain hat. Die Troubleshooting-Guides von Anthropic weisen Prioritätskonflikte ausdrücklich als bekannte Kategorie aus – rechne also damit und gestalte deine Skills entsprechend robust.
Läuft Claude bei dir die ganze Woche über mehrere Repos, um deine Skill-Bibliothek zu testen? Dann bist du wahrscheinlich beim Max 20x Plan für 200 $/Monat, abgerechnet in USD. Mit Bleap zahlst du zum echten Wechselkurs, ohne FX-Gebühren, und bekommst pauschal 20% Cashback auf Claude-, ChatGPT- und Gemini-Verlängerungen – ganz ohne Kartenabo. Jetzt die Bleap-Karte holen →
6. Production Best Practices und der clevere Weg, Claude zu bezahlen
Du hast jetzt alles, was du brauchst, um Skills zu bauen, zu strukturieren und zu kombinieren. Zwei letzte Bausteine machen den Unterschied zwischen einem Hobby und einer echten Produktionspraxis: operative Disziplin und die Fähigkeit, die Kosten für dein Claude-Abo als etwas zu betrachten, das man aktiv optimieren kann.
Checkliste für Production Best Practices
- Scope eng halten. Jeder Skill sollte eine Sache richtig gut machen. Ein enger Scope sorgt für zuverlässiges Triggering und konsistente Ergebnisse.
- Beschreibungen offensiv formulieren. Wirke Undertriggering entgegen, indem du explizit die Szenarien auflistest, die den Skill aktivieren sollen – auch die impliziten.
- Bodies schlank halten. Unter 500 Zeilen, mit Details ausgelagert nach references/. So schützt du dein Context-Budget.
- Alles versionieren. Semantic Versioning plus Git-Tags, damit jeder weiß, welches Verhalten gerade live ist.
- In drei Kategorien testen. Normalfall, Edge Case und Out-of-Scope – Triggering und Ausführung getrennt testen.
- Zugriff bewusst steuern. Erst privat, erst nach Validierung erweitern. Least Privilege für Tools.
- Ein Spec-Repository pflegen. Gerade solange das teamweite Teilen noch nicht ausgereift ist, hält ein gemeinsames Spec-Repo das Team synchron und bereitet euch auf gemanagte Settings vor.
- Ownership dokumentieren. Nutze das Feld author, damit jeder Skill einen klaren Verantwortlichen hat.
Wenn du dich daran hältst, baust du eine Skill-Bibliothek auf, deren Wert sich mit der Zeit vermehrt, statt Altlasten anzuhäufen.
Der Kostenfaktor: Claude bezahlen, ohne Geld zu verlieren
Hier kommt der Teil, den die meisten Guides einfach unter den Tisch fallen lassen. Wer Skills bauen will, muss für Claude bezahlen – und Claude-Abos werden in USD abgerechnet. Claude Pro kostet 20 $/Monat (oder 17 $/Monat bei jährlicher Abrechnung), und Claude Max liegt zwischen 100 und 200 $/Monat. Für Teams startet der Team-Plan bei 25 $ pro Nutzer und Monat, Premium-Plätze mit der Claude-Code-Entwicklungsumgebung kosten 150 $/Monat.
Wenn du im EWR sitzt und ein USD-Abo mit einer typischen europäischen Karte bezahlst, verlierst du bei jeder Verlängerung still und leise Geld. Die meisten Karten schlagen 2-3% Auslandseinsatzentgelt auf einen ohnehin schon aufgeschlagenen Wechselkurs drauf. Bei einem Max-Plan im Gegenwert von 200 € sind diese 2-3% ungefähr 4 bis 6 € im Monat – oder 48 bis 72 € im Jahr, nur an FX-Gebühren. Bei einem fünfköpfigen Team mit Team-Plätzen summiert sich das ziemlich schnell.
Und genau hier kommt Bleap ins Spiel. Bleap ist kein KI-Tool und wird dir auch keine Skills bauen. Es ist ein Fintech-Kartenanbieter – und die clevere Art, genau die KI-Abos zu bezahlen, um die es in diesem Guide geht. Zwei konkrete Vorteile spielen hier direkt eine Rolle:
- 0% FX-Gebühren auf USD-Abos. Du bezahlst deine Claude Pro-, Max- oder Team-Rechnung zum echten Wechselkurs, ganz ohne Auslandseinsatzentgelt und ohne Wochenend-Aufschlag. Das Geld, das sonst in FX-Gebühren geflossen wäre, bleibt in deiner Tasche.
- 20% Cashback auf Claude, ChatGPT und Gemini. Bleap gibt dir pauschal 20% Cashback (ausgezahlt in USDC) auf Abos dieser drei konkreten KI-Tools. Bei einem Claude Pro-Plan für 20 $/Monat ist das jeden Monat bares Geld zurück, und bei einem Max-Plan für 200 $/Monat fällt es noch deutlich stärker ins Gewicht.
Es handelt sich um eine selbstverwaltete Mastercard-Debitkarte, die du überall dort nutzen kannst, wo Mastercard akzeptiert wird – ganz ohne eigenes Monatsabo. Du musst also auf nichts verzichten: Du behältst die volle Kontrolle über dein Geld, zahlst deine KI-Rechnungen genau wie bisher und verlierst kein Geld mehr durch FX-Gebühren, während du gleichzeitig Cashback auf die drei größten KI-Abos bekommst. Für alle, die Claude ernsthaft genug nutzen, um damit Skills zu bauen, ist das eine naheliegende Optimierung.
Ein ehrlicher Hinweis: Der pauschale 20%-Cashback gilt speziell für Claude, ChatGPT und Gemini. Bei anderen KI-Tools profitierst du weiterhin von 0% FX-Gebühren bei Abrechnung in USD, aber ohne die 20% Cashback. Und Bleaps Sparvaults, die 3,65% AER (Steady, geringstes Risiko) und 3,83% AER (Dynamic, niedriges Risiko) in USD bieten – mit einem Mindestbetrag von nur 1 $ und 0% Abhebungsgebühren – sind ein eigenes Feature, das sich lohnt zu kennen, falls du dein übriges Guthaben arbeiten lassen willst, während du baust.
Häufig gestellte Fragen
Was genau ist ein Claude Skill?
Ein Claude Skill ist eine in sich geschlossene, wiederverwendbare Anweisungseinheit, die Claude bei Bedarf lädt, um eine bestimmte Aufgabe zuverlässig auszuführen. Skills sind Ordner mit Anweisungen, Skripten und Ressourcen, die Claude dynamisch lädt, um die Leistung bei spezialisierten Aufgaben zu verbessern – sie bringen Claude quasi bei, bestimmte Aufgaben auf wiederholbare Weise zu erledigen. Technisch gesehen ist es einfach ein Ordner mit einer SKILL.md-Datei mit YAML-Frontmatter und Markdown-Anweisungen, plus optionalen ergänzenden Verzeichnissen.
Was ist der Unterschied zwischen einer skill.md-Datei und einem Prompt?
Ein Prompt existiert nur für einen Gesprächsschritt und verschwindet danach wieder. Eine SKILL.md-Datei dagegen ist dauerhaft, versioniert, auffindbar und wiederverwendbar. Der entscheidende strukturelle Unterschied: Claude weiß aktiv, dass ein Skill existiert, denn beim Start lädt der Agent Name und Beschreibung jedes installierten Skills vorab in seinen System-Prompt. Claude kann nie auf einen Prompt zugreifen, den man ihm nicht gezeigt hat – auf einen passenden Skill dagegen schon, und zwar automatisch.
Muss ich programmieren können, um Claude Skills zu erstellen?
Nein. Skills sind im Grunde eine Frage des Schreibens und der Konfiguration. Sie sind keine Modelle oder kostenpflichtigen Zusatzfunktionen, sondern Open-Source-Markdown-Anweisungen plus unterstützende Dateien. Wenn du klare Anweisungen in Markdown formulieren kannst und dir gut überlegst, wann eine Aufgabe ausgelöst werden soll, kannst du einen produktionsreifen Skill bauen. Skripte sind optional und nur dann nötig, wenn eine Aufgabe eine deterministische Ausführung erfordert.
Wie entscheidet Claude, wann ein Skill zum Einsatz kommt?
Claude gleicht die aktuelle Anfrage mit dem description-Feld jedes installierten Skills anhand semantischer Ähnlichkeit ab. Da Claude eher dazu neigt, Skills zu selten auszulösen und sie nicht einzusetzen, obwohl sie hilfreich wären, empfiehlt Anthropic, Beschreibungen zu schreiben, die explizit die Szenarien aufzählen, in denen der Skill aktiviert werden soll – auch die impliziten. Eine starke, präzise und leicht offensive Beschreibung ist der wichtigste Faktor für eine zuverlässige Auslösung.
Wie lang sollte eine SKILL.md-Datei sein?
Der Hauptteil sollte fokussiert bleiben. In der Praxis empfiehlt es sich, den SKILL.md-Body auf das Wesentliche zu beschränken und unter 500 Zeilen zu halten – und falls man sich dieser Grenze nähert, den Inhalt auf separate Dateien aufzuteilen. Das immer geladene Frontmatter ist winzig, ungefähr 100 Tokens, während der Body nur geladen wird, wenn der Skill aufgerufen wird. Ein schlanker Body schont also dein Context-Budget und sorgt dafür, dass die wichtigen Anweisungen nicht verwässert werden.
Wie hängen Skills mit MCP und Subagents zusammen?
Sie ergänzen sich als verschiedene Ebenen. MCP ist die Verbindungsschicht, die Claude mit externen Tools und Daten verknüpft; ein Skill ist die Anweisungsschicht, die Claude sagt, wie diese Verbindung zu nutzen ist. Subagents sorgen für Isolation, und du kannst Skills in benutzerdefinierte Subagents einbauen, um Aufgaben isoliert und mit Expertenwissen zu delegieren. Ein gängiges Muster in der Praxis kombiniert alle drei: MCP verbindet die Daten, ein Skill definiert den Ablauf, und ein Subagent führt ihn in einem sauberen Kontext aus.
Kann ich Skills mit meinem ganzen Team teilen?
Zunehmend ja, auch wenn die Tools dafür noch nicht ausgereift sind. In Claude.ai sind Skills derzeit individuell pro Nutzer, aber organisationsweite Verwaltungs- und Freigabefunktionen sind bereits in Vorbereitung. Bis dahin kannst du sie über ein Git-Repository teilen, per Plugins verteilen und mit unternehmensweiten, verwalteten Einstellungen organisationsweit ausrollen. Wer schon jetzt ein gemeinsames Spec-Repository pflegt, ist bestens vorbereitet auf die kommenden Verwaltungsfunktionen.
Wie viel kostet es, Claude für den Bau von Skills zu nutzen?
Die Erstellung von Skills selbst ist Teil der Claude-Pläne. Die Claude-Preise für 2026 reichen von Free (0 $), Pro (20 $/Monat), Max 5x (100 $/Monat), Max 20x (200 $/Monat), Team Standard (25 $/Sitz/Monat), Team Premium (125 $/Sitz/Monat) bis hin zu Enterprise (individuell). Da diese Preise in USD abgerechnet werden, kostet dich das Bezahlen aus der EWR-Zone mit einer Karte, die 2-3% Auslandseinsatzgebühren berechnet, jeden Monat zusätzlich Geld. Mit Bleap zahlst du dagegen ohne Fremdwährungsgebühren und bekommst noch dazu 20% Cashback pauschal auf Claude-Abos – so bleibt mehr von deinem Budget für die eigentliche Nutzung übrig.
Was ist der häufigste Anfängerfehler bei Skills?
Zwei Fehler liegen gleichauf an erster Stelle: eine zu vage formulierte Beschreibung (wodurch der Skill entweder nie auslöst oder bei allem anspringt) und ein überladener Hauptteil. Das Problem mit dem Auslösen löst man mit einer präzisen, szenarienreichen Beschreibung; bei der Ausgabequalität hilft mehr Genauigkeit und Validierung – nicht mehr Text. Und teste immer mit einer richtigen Test-Sammlung, denn du solltest eine Reihe von Testfällen erstellen, die normale Nutzung, Grenzfälle und Anfragen außerhalb des vorgesehenen Bereichs abdecken.
Fazit
Claude Skills verwandeln spontanes Prompting in durchdachte, wiederverwendbare Automatisierung. Im Kern ist das Ganze wirklich simpel: ein Ordner, eine SKILL.md-Datei mit einem klaren Namen und einer präzisen, leicht nachdrücklichen Beschreibung, sowie ein schlanker Block an Anweisungen, den Claude nur lädt, wenn er wirklich relevant ist. Wenn du das beherrschst und noch MCP für die Anbindung, Subagents für die Isolation sowie diszipliniertes Testen für die Zuverlässigkeit dazunimmst, hast du eine Skill-Bibliothek, deren Wert sich für dein ganzes Team immer weiter vermehrt.
Der eigentliche Aufwand ist gar nicht so sehr technisch, sondern vor allem ein Schreibaufwand. Eng abgesteckt, präzise beschrieben, alles versioniert und in drei Kategorien getestet – wenn du das konsequent machst, hört Claude auf, ein allgemeiner Assistent zu sein, dem du jeden Morgen aufs Neue alles erklären musst, und wird stattdessen zu einem spezialisierten Experten, der deine Workflows schon kennt.
Zum Schluss noch ein praktischer Tipp, der nichts mit Code, aber viel mit deinem Budget zu tun hat. Egal für welchen Claude-Plan du dich entscheidest und welche anderen KI-Tools du daneben nutzt: Zahl schlau. Diese Abos werden in USD abgerechnet, und eine normale Karte knabbert bei jeder Verlängerung still und heimlich 2-3% ab. Mit Bleap fallen die Wechselkursgebühren komplett weg, und bei Claude, ChatGPT und Gemini bekommst du bei jeder Zahlung pauschal 20% Cashback zurück – und das alles über eine selbstverwaltete Mastercard ganz ohne eigenes Abo. Baue großartige Skills. Zahl nur nicht drauf, um sie zu nutzen.
Du hast deinen Claude-Workflow optimiert. Jetzt optimier auch, was du dafür bezahlst. Mit Bleap zahlst du 0% Wechselkursgebühren auf USD-Abos und bekommst pauschal 20% Cashback auf Claude, ChatGPT und Gemini – ganz ohne monatliche Kartengebühr und mit voller Kontrolle über dein Geld. Bleap-Konto eröffnen →
Der 20 %-Cashback von Bleap gilt für Claude-, ChatGPT- und Gemini-Abos und wird in USDC ausgezahlt. Bei anderen KI-Tools greift zwar der Vorteil der 0 % FX-Gebühr bei Abrechnung in USD, allerdings nicht der 20 %-Cashback. Die Claude-Preise entsprechen dem Stand von 2026 und werden von Anthropic festgelegt, nicht von Bleap – die aktuellen Tarife findest du in der offiziellen Preisübersicht von Anthropic.
Intelligenter ausgeben, senden, verdienen und handeln

- Artificial Inteligence








