Claude Skills erklärt: was sie wirklich sind, und das Tarif-Kleingedruckte, bei dem sich zwei von Anthropics eigenen Seiten widersprechen

Was eine Skill mechanisch tatsächlich ist

Zieht man das Marketing ab, ist eine Skill ein Verzeichnis mit genau einer erforderlichen Datei. SKILL.md trägt YAML-Frontmatter (mindestens einen name und eine description), gefolgt von Markdown-Anweisungen. Optional gruppieren sich drumherum ein scripts/-Ordner mit ausführbarem Code, ein references/-Ordner mit Dokumentation, die Claude nur bei Bedarf öffnet, und ein assets/-Ordner mit Vorlagen, Schriftarten oder Icons für das, was die Skill erzeugt. Anthropics eigene Plattform-Dokumentation beschreibt den Mechanismus fast wörtlich: Das Modell führt das Äquivalent von bash: cat pdf-processing/SKILL.md aus. Es ist ein Dateisystem-Lesevorgang, keine spezielle API-Primitive.

Was das vom bloßen Einfügen eines langen System-Prompts unterscheidet, ist progressive Offenlegung, und die hat echte, dokumentierte Token-Kosten statt vager Beteuerungen. Anthropics Plattform-Dokumentation unterteilt das in drei Ebenen: Ebene 1, name und description der Skill, lädt automatisch in jede Konversation, zu Kosten von etwa 100 Tokens pro installierter Skill. Ebene 2, der vollständige Textkörper von SKILL.md, lädt nur, wenn Claude urteilt, dass deine Anfrage zur Beschreibung passt, und Anthropic deckelt das auf unter 5.000 Tokens (der separate Leitfaden zum Bauen von Skills formuliert denselben Ratschlag als unter 5.000 Wörter), gerade um diese Kosten zu begrenzen. Ebene 3, gebündelte Referenzdateien oder Skripte, lädt nur, wenn Claude sie tatsächlich öffnet, und der Quellcode eines Skripts selbst gelangt nie in das Kontextfenster, nur das, was es beim Ausführen auf stdout ausgibt. Anthropics eigener 32-seitiger Leitfaden zum Bauen von Skills nutzt eine Küchen-Analogie, die es wert ist, direkt zitiert zu werden: „MCP stellt die Profiküche bereit: Zugang zu Werkzeugen, Zutaten und Ausrüstung. Skills liefern die Rezepte: Schritt-für-Schritt-Anleitungen.“

Wo Skills tatsächlich funktionieren, und welcher Tarif nötig ist

Hier lohnt es sich, präzise zu sein, denn zwei von Anthropics eigenen Seiten beschreiben das unterschiedlich. Anthropics Consumer-Help-Center schreibt: „Skills stehen Nutzern auf Free-, Pro-, Max-, Team- und Enterprise-Tarifen zur Verfügung. Diese Funktion erfordert aktivierte Code-Ausführung.“ Anthropics Entwicklerdokumentation, die dieselbe zugrunde liegende Funktion technischer beschreibt, sagt, benutzerdefinierte Skills seien „auf Pro-, Max-, Team- und Enterprise-Tarifen mit aktivierter Code-Ausführung verfügbar“, und fügt hinzu, dass sie auf claude.ai „nicht organisationsweit geteilt und nicht zentral von Admins verwaltet werden können“. Free taucht im einen Satz auf und fehlt im anderen.

Zusammen gelesen lautet die wahrscheinliche Erklärung: Anthropics vier vorgefertigte Dokument-Skills, PDF-, Word-, Excel- und PowerPoint-Erzeugung, funktionieren automatisch für alle, auch Free-Nutzer, während das Hochladen und Ausführen einer eigenen benutzerdefinierten Skill Pro oder höher mit aktivierter Code-Ausführung braucht. Bist du im Free-Tarif und eine Skill taucht nicht dort auf, wo du sie erwartest, ist das vermutlich der Grund, kein Bug.

Surface              Pre-built doc skills    Custom skills              Sharing model
----------------------------------------------------------------------------------------------
claude.ai              Yes, all plans          Pro/Max/Team/Enterprise    Per-user, no org
                        automatically           + code execution on       admin management
Claude Code             No (own reference       Yes, filesystem-based,    Personal (~/.claude),
                        skill ships instead)    no upload needed          project, or plugin
API                     Yes, via skill_id in    Yes, via /v1/skills       Workspace-wide, all
                        the container param     upload endpoints          members share access
Cowork / cloud          N/A                     Loads skills enabled on   Doesn't read your
sessions                                        your claude.ai account,  local ~/.claude/skills
                                                 synced at session start  unless committed to it
Enterprise (org-wide)   Inherits API behavior   Admins can push skills    Org-wide, automatic
                                                 workspace-wide since     updates
                                                 18 Dec 2025

Die Zeile, auf die man sich am besten einstellt, ist das Fehlen der Synchronisierung. Eine über das Settings-Panel von claude.ai hochgeladene Skill ist für API-Aufrufe nicht sichtbar, und eine über den API-Endpunkt /v1/skills hochgeladene Skill taucht auf claude.ai nicht auf. Claude-Code-Skills sind einfache Dateien auf deinem Rechner, unter ~/.claude/skills/ für den persönlichen Gebrauch oder .claude/skills/ in einem Repository für eine geteilte Projekt-Skill, und eine Cowork-Cloud-Sitzung sieht nur die, die in dieses Repository committet wurden, nicht das, was auf deinem Laptop liegt. Baust du eine gute Skill, rechne damit, sie auf jeder Oberfläche, die du tatsächlich nutzt, erneut zu installieren, nicht einmal für alle.

Wie du heute tatsächlich eine installierst und nutzt

• Auf claude.ai: Einstellungen → Fähigkeiten (bei manchen Konten „Features“ genannt) → Skills, dann entweder „Skills durchsuchen“, um Anthropics eigenes Verzeichnis zu öffnen, oder „Skill hochladen“, um einen selbst gebauten oder heruntergeladenen gezippten Ordner hinzuzufügen, und sie aktivieren.
• In Claude Code: Lege ~/.claude/skills/<name>/SKILL.md für eine persönliche Skill an, live erkannt ohne Neustart, oder .claude/skills/<name>/SKILL.md in einem Repository, um sie über Versionskontrolle mit deinem Team zu teilen. Offizielle Anthropic-Skills installierst du über den Plugin-Marktplatz: /plugin marketplace add anthropics/skills, dann /plugin install document-skills@anthropic-agent-skills. Rufe eine Skill explizit mit /skill-name auf, oder lass Claude sie automatisch laden, wenn deine Anfrage zur Beschreibung passt.
• Über die API: Referenziere Anthropics vorgefertigte Skills per skill_id (pdf, docx, pptx, xlsx) im container-Parameter eines Messages-API-Aufrufs zusammen mit dem Code-Ausführungs-Tool, oder lade eine benutzerdefinierte über die /v1/skills-Endpunkte der Console hoch, damit der ganze Workspace sie nutzen kann.
• Eigene bauen: Nutze die Skill skill-creator selbst, Anthropics Meta-Skill zum Bauen von Skills. Beschreibe den Workflow, den du oft wiederholst, in einfacher Sprache, und sie baut daraus ein korrekt formatiertes SKILL.md, schlägt Auslöseformulierungen für die Beschreibung vor und markiert Formulierungen, die zu vage sind, um zuverlässig anzuspringen. Anthropics eigener Leitfaden rahmt das als 15- bis 30-minütigen Prozess, sobald du deine zwei oder drei am häufigsten wiederholten Aufgaben kennst.

Skills vs. MCP vs. Custom GPTs vs. Gemini Gems

Der Vergleich, der wirklich klärt, was eine Skill ist, ist der, den Anthropic zu seinem eigenen MCP (Model Context Protocol) zieht: „MCP verbindet Claude mit externen Diensten und Datenquellen. Skills liefern prozedurales Wissen, Anweisungen, wie bestimmte Aufgaben oder Workflows zu erledigen sind. Du kannst beides zusammen nutzen: MCP-Verbindungen geben Claude Zugang zu Tools, während Skills Claude beibringen, diese Tools effektiv zu nutzen.“ Mechanisch ist MCP ein Protokoll, das neue Tools freilegt, Fähigkeiten, die Claude sonst wirklich nicht ausführen könnte, etwa das Aufrufen einer privaten API. Eine Skill ist Prompt-Inhalt plus optionaler Code, der Claude sagt, wie es Tool-Aufrufe aneinanderreiht, die es bereits ausführen kann. Das ist der ehrliche Kern des skeptischen Arguments, das weiter unten behandelt wird: Eine Skill ohne Skript und ohne MCP-Verbindung dahinter kann nichts tun, was ein ausreichend detaillierter Einmal-Prompt nicht ohnehin schon könnte. Ihr Wert liegt in Verpackung und kontexteffizienter Wiederverwendung, nicht in neuer Fähigkeit.

                 Claude Skills             MCP                      Custom GPTs (OpenAI)   Gemini Gems
-----------------------------------------------------------------------------------------------------------
Grants new        No - packages prompting   Yes - exposes new        No - system prompt +    No - saved
capability?       Claude already has        tools/API access         optional Actions        persona/prompt
Invocation        Automatic, matched to     Always-on connection     Manual - pick the GPT   Manual - switch
                  your request's wording    once configured          from a list             into the Gem
Portable across   Yes in spirit (open       Yes, it's a protocol,    No - ChatGPT only       No - Gemini
tools?            agentskills.io standard), works with any MCP                                ecosystem only
                  but doesn't sync accounts client
Entry cost        Pro+ for custom skills,   Varies by server, often  ChatGPT Plus/Team/       Included with
                  code execution required   free/self-hosted         Enterprise               most Gemini plans
Instruction       ~5,000 words recommended  N/A - it's a tool        Knowledge files, no      Reportedly capped
length limit      per SKILL.md              connection, not a prompt hard length limit stated ~4,000 characters

Zur letzten Zeile bei Gemini Gems ein Vorbehalt: Sie stammt aus Vergleichsartikeln Dritter, nicht aus einem von Google veröffentlichten Datenblatt, behandle die genaue Zahl also als berichtete Näherung, nicht als bestätigtes Limit.

Ist das nur schickes Prompting? Das skeptische Argument

Die inhaltlich fundierteste öffentliche Kritik stammt von Sibylline Softwares „Claude Skills Considered Harmful“, und es lohnt sich, über die Überschrift hinauszulesen, denn der Autor hat einen Teil davon später zurückgenommen. Das Kernargument: Skills binden deine dokumentierten Workflows an Anthropics eigene Laufzeitumgebung, auf eine Weise, die Migration oder Verhaltensprüfung schwerer macht, als es eine einfache Datei tun würde, und, wörtlich zitiert, „du hast keine Einsicht, warum eine Skill ausgelöst wurde oder wie sie das Reasoning des Modells beeinflusst“, mit dem Schluss, Skills seien „eine Mikro-Optimierung, gedacht, um Kunden zu binden, verpackt als Innovation.“ Die vorgeschlagene Alternative war eine einfache, versionskontrollierte Hierarchie von README.md-Dateien, die jedes Modell lesen könnte, von Menschen prüfbar und nicht an die Laufzeitumgebung eines einzelnen Anbieters gebunden.

Der Beitrag trägt einen eigenen Nachtrag, hinzugefügt, nachdem Anthropic das Format geöffnet hat: „Seit dieser Artikel geschrieben wurde, hat Anthropic die Skill-Spezifikation offengelegt, und Codex hat Unterstützung dafür implementiert. Ich halte Skills immer noch für überbewertet, aber sie sind nicht aktiv schädlich.“ Das Vendor-Lock-in-Argument war der tragende Teil der ursprünglichen Kritik, und es wurde erheblich entkräftet, als das SKILL.md-Format zu einem offenen Standard (agentskills.io) wurde, den auch andere Agenten-Tools, nicht nur Claude, zu implementieren begonnen haben. Was den Rückzug überlebt, ist der engere, weiterhin zutreffende Punkt aus dem Abschnitt oben: Eine Skill ohne Code und ohne Tool-Zugriff dahinter ist bedingt geladenes Prompting, keine neue Fähigkeit, und das ist eine Einschränkung, der Anthropics eigene Darstellung implizit eher zustimmt, als sie zu bestreiten.

Echte Skills, die man kennen sollte, namentlich

Anthropic liefert standardmäßig vier vorgefertigte Skills, PDF-, Word-, Excel- und PowerPoint-Erzeugung, das heißt echte Ausgabe im nativen Format statt Markdown, das wie ein Dokument formatiert ist. Darüber hinaus stammen skill-creator (die Meta-Skill zum Bauen von Skills, die es sich lohnt, zuerst zu installieren) und frontend-design (Prompting für Interface-Qualität bei Coding-Aufgaben) von Anthropic selbst. Die API liefert außerdem eine quelloffene Referenz-Skill, die die SDK-Nutzung über acht Sprachen hinweg aktuell hält.

Die Community-Ebene ist größer und spezifischer, als die Marketing-Seiten vermuten lassen. ComposioHQs awesome-claude-skills-Repository, oben mit heute 74.500 Stars und 8.600 Forks abgebildet, ein echtes, überprüfbares Signal dafür, wie viel Entwickleraufmerksamkeit dieses Ökosystem hat, listet namentlich benannte, zugeordnete Skills, darunter einen Changelog Generator, der Git-Commits in nutzerlesbare Release Notes verwandelt, einen MCP Builder, der MCP-Server in Python oder TypeScript aus einer Beschreibung in einfacher Sprache aufbaut, eine 59-Skills-Bibliothek namens Brand Build Skills, die einen kompletten Website-Lebenszyklus von SEO bis Deployment abdeckt, und Sentry Automation, eine von einem Partner gebaute Skill, die Sentry-Issues, -Events, -Projekte, -Releases und -Alerts direkt aus Claude heraus verwaltet. Eine verwandte, aber separate Partner-Skill, Sentry Code Review, gelistet in Sentrys eigenem Plugin-Verzeichnis statt in diesem Repository, nutzt Sentrys MCP-Server, um Bugs in GitHub-Pull-Requests anhand echter Produktions-Fehlerdaten automatisch zu analysieren und zu beheben.

Eine selektivere Quelle ist Entwickler Suraj Khaitans „I Tried 100 Claude Skills“, der jede getestete Skill anhand eines Fünf-Achsen-Rasters bewertete, wobei eine Achse die Sicherheitshaltung war: ob eine Skill überraschende Netzwerkaufrufe macht oder undurchsichtige Binärdateien mitbringt. Seine selbst berichtete Ausschlussquote, aus seiner persönlichen Stichprobe von etwa 100, keine branchenweite Zahl, lag bei rund 70%, die auf mehr als zwei Achsen unter 3 von 5 punkteten. Seine Top-Empfehlungen: PDF („die Skill, die mich überzeugt hat“, dank eines gebündelten Parsers, der halluzinierte Formularfelder vermeidet), DOCX/PPTX/XLSX, skill-creator, die er empfiehlt, „vor jeder anderen“ Skill zu installieren, mcp-builder und webapp-testing, eine Playwright-gesteuerte Browser-Automatisierungs-Skill für den End-to-End-Smoketest einer Webapp.

Was kaputtgeht, und die Sicherheitswarnung, die alle wiederholen

Anthropics eigene Plattform-Dokumentation benennt das Risiko unverblümt, nicht als Floskel: „Nutze Skills nur aus vertrauenswürdigen Quellen: solchen, die du selbst erstellt hast oder von Anthropic bezogen hast … eine bösartige Skill kann Claude anweisen, Tools aufzurufen oder Code auf eine Weise auszuführen, die nicht zum angegebenen Zweck der Skill passt.“ Sie markiert Skills, die externe URLs abrufen, ausdrücklich als höheres Risiko, da abgerufener Inhalt eingeschleuste Anweisungen tragen kann, und warnt, dass eine legitime Skill später riskant werden kann, wenn sich eine externe Abhängigkeit, auf die sie sich stützt, unter ihr ändert. Khaitans unabhängiges Testen bestätigt von außen dieselbe Schlussfolgerung: Er empfiehlt, jedes gebündelte Skript vor der Installation zu prüfen, Abhängigkeiten festzupinnen, die Ausführung zu sandboxen und „Partner-Abzeichen als Marketing zu behandeln, nicht als Zusicherung“, kein Ersatz dafür, den Code tatsächlich zu lesen.

Enterprise-Konten bekommen eine teilweise Abmilderung: Anthropic bietet ein Content-Scanning für Skills an, aber nur für Uploads über claude.ai und Cowork, nicht für Skills, die über die API oder Console hochgeladen werden. Eine workspace-weite benutzerdefinierte Skill, die über die API ausgerollt wird, durchläuft diesen Scanner überhaupt nicht.

• Die Kontextkosten summieren sich mit der Menge. Anthropics eigener Leitfaden warnt, dass sich jenseits von etwa 20 bis 50 gleichzeitig aktivierten Skills in der Praxis eine verschlechterte Antwortqualität zeigt, und empfiehlt, Skills, die du gerade nicht brauchst, zu deaktivieren, statt alles eingeschaltet zu lassen.
• Zu seltenes und zu häufiges Auslösen sind benannte Fehlermodi mit vorgeschriebenen Lösungen. Eine Skill, die nie feuert, braucht eine schärfere description mit mehr der Formulierungen, die Nutzer tatsächlich eintippen; eine Skill, die zu oft feuert, braucht explizite negative Auslöser („Nutze das NICHT für …“), die im selben Feld ergänzt werden.
• Der Skill-Inhalt aktualisiert sich nicht mitten in der Sitzung. Bearbeitest du eine Skill-Datei, nachdem Claude Code sie bereits in der aktuellen Konversation geladen hat, musst du sie explizit erneut aufrufen, damit die Änderung wirksam wird.
• Exakte Dateinamen und reservierte Namen sind wichtig. SKILL.md muss großschreibungsempfindlich genau so geschrieben werden, sonst bekommst du laut Anthropics eigenem Troubleshooting-Leitfaden „Could not find SKILL.md in uploaded folder.“ Skill-Namen müssen Kebab-Case sein, ohne Leerzeichen oder Großbuchstaben, und jeder Name, der „claude“ oder „anthropic“ enthält, wird als reserviert grundsätzlich abgelehnt.

Wann sich Skills nicht lohnen

• Wenn die Aufgabe wirklich einmalig ist. Einen Prompt in eine Skill zu verpacken, zahlt sich erst aus, wenn du sonst dieselben Anweisungen über mehrere Konversationen hinweg erneut eintippen würdest.
• Wenn du eigentlich neue Fähigkeiten brauchst, kein besser organisiertes Prompting. Das ist die Aufgabe eines MCP-Servers, nicht einer Skill. Eine Skill zu installieren gibt Claude keinen Zugriff auf ein System, das es nicht ohnehin schon erreichen konnte.
• Wenn du im Free-Tarif bist und eine benutzerdefinierte Skill willst. Laut der oben beschriebenen Tarif-Diskrepanz ist die sicherere Annahme, dass benutzerdefinierte Uploads Pro oder höher mit aktivierter Code-Ausführung brauchen, auch wenn eine Anthropic-Seite etwas anderes nahelegt.
• Wenn du das gebündelte Skript der Skill vor der Installation nicht lesen kannst oder willst. Anthropics eigene Sicherheitshinweise und jeder unabhängige Tester, der Community-Skills tatsächlich geprüft hat, sind sich in genau diesem Punkt ausnahmslos einig.

Häufig gestellte Fragen

Was sind Claude Skills?

Eine Skill ist ein Ordner mit einer erforderlichen SKILL.md-Anweisungsdatei plus optionalen Skripten, Referenzdokumenten und Vorlagen. Claude lädt Name und Beschreibung der Skill automatisch in jede Konversation und lädt die vollständigen Anweisungen nur, wenn eine Anfrage passt – ein Mechanismus namens progressive Offenlegung.

Kosten Claude Skills extra, und welchen Tarif brauche ich?

Anthropics vorgefertigte Dokument-Skills (PDF, Word, Excel, PowerPoint) funktionieren auf jedem Tarif, auch Free. Benutzerdefinierte Skills, die du baust oder herunterlädst, brauchen laut Anthropics Entwicklerdokumentation Pro, Max, Team oder Enterprise mit aktivierter Code-Ausführung, auch wenn die Formulierung des Consumer-Help-Centers an dieser Stelle weniger präzise ist.

Was ist der Unterschied zwischen einer Skill und einem MCP-Server?

MCP verbindet Claude mit externen Tools und Daten, die es sonst nicht erreichen könnte, also mit wirklich neuer Fähigkeit. Eine Skill verpackt Anweisungen, wie Fähigkeiten zu nutzen sind, die Claude bereits hat, und verleiht von sich aus keine neue Fähigkeit, es sei denn, sie bündelt ein Skript oder eine MCP-Verbindung.

Sind Claude Skills von GitHub sicher zu installieren?

Nur aus Quellen, denen du genug vertraust, um sie geprüft zu haben. Anthropics eigene Dokumentation warnt, dass eine bösartige Skill Claude anweisen kann, Code auszuführen, der nicht zu ihrem angegebenen Zweck passt, besonders bei Skills, die externe URLs abrufen. Unabhängige Tester, die Dutzende Community-Skills ausprobiert haben, empfehlen, jedes gebündelte Skript vor der Installation zu lesen, denn eine GitHub-Star-Zahl oder ein Partner-Abzeichen sind keine Sicherheitsgarantie.

Wie viele Claude Skills kann ich gleichzeitig installiert haben?

Anthropics eigener Leitfaden nennt etwa 20 bis 50 gleichzeitig aktivierte Skills als weiche Obergrenze, bevor die Antwortqualität durch die Kontextlast leidet. Deaktiviere Skills, die du nicht aktiv nutzt, statt alles eingeschaltet zu lassen.

Funktionieren Claude Skills in ChatGPT oder Gemini?

Nein, Skills sind ein Claude-spezifisches Produkt, aber das zugrunde liegende SKILL.md-Format ist ein offener Standard (agentskills.io), den auch andere Agenten-Tools, einschließlich einiger Produkte außerhalb von Anthropic, unabhängig zu übernehmen begonnen haben.