Claude Skills API: Jetzt allgemein verfügbar

Die Claude Skills API ist seit dem 20. August 2026 allgemein verfügbar. Sie können jetzt benutzerdefinierte Skills über https://api.anthropic.com/v1/skills mit Standard-Headern, ohne Beta-Flag, erstellen, versionieren und verwalten und diese in Claudes Code-Sandbox ausführen, ohne selbst etwas hosten zu müssen. Anthropic hat die GA in einem Rutsch zusammen mit der Computernutzung, dem neuen Browser-Tool und der Files API veröffentlicht, im Ankündigung als der Produktions-Stack für den Aufbau von Agenten auf der Claude-Plattform bezeichnet.

Falls Ihnen Skills als Konzept neu sind, erklärt unser Leitfaden zu Claude Skills die Idee von Grund auf. Dieser Artikel behandelt die API-Schicht: die Endpunkte, das Versionierungsmodell, die Request-Struktur, die Skills in einen Messages-Aufruf lädt, und die Knackpunkte (Workspace-Scoping, Snapshot-Versionierung), die die GA nicht beseitigt hat. Da alles reines HTTP ist, kann jeder hier gezeigte Aufruf in Apidog erstellt und regression-getestet werden, während Sie mitlesen.

Button

Eine 30-Sekunden-Auffrischung: Was ist ein Skill?

Ein Skill ist ein Ordner. Auf seiner obersten Ebene befindet sich eine SKILL.md-Datei mit YAML-Frontmatter, das einen name und eine description enthält; um sie herum befinden sich alle Skripte, Vorlagen und Referenzdateien, die die Aufgabe benötigt. Wenn eine Anfrage den Skill enthält, lädt Claude die Anweisungen nur dann, wenn die Aufgabe sie erfordert, und führt gebündelte Skripte in seiner isolierten Code-Umgebung aus.

Das Frontmatter hat echte Validierungsregeln:

name: max. 64 Zeichen, nur Kleinbuchstaben, Zahlen und Bindestriche. Keine XML-Tags, und die reservierten Wörter „anthropic“ und „claude“ werden abgelehnt.
description: nicht leer, max. 1024 Zeichen.
Ein optionaler display_name (bis zu 255 Zeichen) kann benutzerfreundlich sein.
Der gesamte Upload darf unkomprimiert 30 MB nicht überschreiten.

Skills stammen aus zwei Quellen. Von Anthropic verwaltete Skills (`type: "anthropic"`) werden vorgefertigt mit kurzen IDs wie `pptx`, `xlsx`, `docx` und `pdf` geliefert und verwenden datumsbasierte Versionen wie `20251013`. Benutzerdefinierte Skills (`type: "custom"`) gehören Ihnen: Sie werden über die API hochgeladen, sind privat für Ihren Workspace und haben generierte IDs wie `skill_01AbCdEfGhIjKlMnOpQrStUv`.

Was die GA tatsächlich geändert hat

Drei Dinge sind seit dem 20. August 2026 neu oder wurden gefestigt:

Kein Beta-Header. Die Skills API funktioniert mit der Claude API nur mit x-api-key und anthropic-version: 2023-06-01.
Ein einfacherer Upload- und Versionierungsfluss. Anthropic beschreibt die GA als Einführung einer „einfacheren API zum Hochladen und Versionieren“ benutzerdefinierter Skills. Versionen sind erstklassige Ressourcen mit eigenen Endpunkten.
Mehr Plattformen. Die Skills API ist sowohl über Microsoft Foundry als auch über die Claude API verfügbar. Skills werden in Claudes verwalteter Sandbox ausgeführt, sodass auf Ihrer Seite weiterhin keine Infrastruktur erforderlich ist.

Der Rest der GA-Welle ist auch für Skill-Benutzer relevant: Skills generieren häufig Dateien (eine Präsentation, eine ausgefüllte Tabelle), und diese Ausgaben kommen über die neu allgemein verfügbare Files API zurück.

Die Endpunkt-Oberfläche

Alles befindet sich unter /v1/skills:

Operation	Endpunkt
Skill erstellen	`POST /v1/skills`
Skills auflisten	`GET /v1/skills`
Skill abrufen	`GET /v1/skills/{skill_id}`
Skill löschen	`DELETE /v1/skills/{skill_id}`
Neue Version erstellen	`POST /v1/skills/{skill_id}/versions`
Versionen auflisten	`GET /v1/skills/{skill_id}/versions`

Das Erstellen eines Skills lädt seinen vollständigen Dateisatz hoch; das Erstellen einer Version tut dasselbe für eine bestehende Skill-ID. In einem Apidog-Projekt lässt sich dies sauber auf einen Ordner mit sechs gespeicherten Anfragen abbilden, wobei {{skill_id}} und {{skill_version}} als Umgebungsvariablen fungieren, sodass die Beförderung einer neuen Version durch Entwicklungs- und Produktionsumgebungen eine Variablenänderung und keine Request-Bearbeitung ist.

Einen benutzerdefinierten Skill hochladen

Ein minimaler benutzerdefinierter Skill besteht aus zwei Dingen: dem Ordner und dem Upload-Aufruf. Nehmen wir an, Sie haben einen Brand-Report-Skill in Ihrem Repo:

brand-report/
  SKILL.md
  templates/report.html
  scripts/build_report.py

Mit SKILL.md beginnend wie folgt:

---
name: brand-report
description: Generates the weekly brand performance report as a formatted HTML document from a CSV of metrics. Use when asked for a brand report, weekly summary deck, or performance writeup.
---

Laden Sie ihn hoch, indem Sie die Dateien als Multipart-Formulardaten posten:

curl -X POST https://api.anthropic.com/v1/skills \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -F 'files[]=@brand-report/SKILL.md;filename=brand-report/SKILL.md' \
  -F 'files[]=@brand-report/templates/report.html;filename=brand-report/templates/report.html' \
  -F 'files[]=@brand-report/scripts/build_report.py;filename=brand-report/scripts/build_report.py'

Die Antwort gibt die generierte skill_id und die skver_*-ID der ersten Version zurück. Speichern Sie beide; die Skill-ID wird in Ihren Messages-Anfragen verwendet, und die Versions-ID ist Ihr Rollback-Anker. Überprüfen Sie die genauen Multipart-Feldnamen anhand der Skills API-Referenz für Ihre SDK-Version, da typisierte SDK-Helfer diesen Aufruf in den meisten Sprachen umschließen.

Beachten Sie die Beschreibung: Sie liest sich wie eine Routing-Regel. Claude entscheidet, ob ein Skill geladen werden soll, indem es dieses Feld liest. Daher übertrifft eine Beschreibung, die die Trigger-Phrasen Ihrer Benutzer auflistet, ein einzeiliges Label jedes Mal.

Einen Skill in einer Messages-Anfrage verwenden

Skills werden nicht von selbst an eine Anfrage angehängt. Sie nutzen das Code-Ausführungstool, das über den container-Parameter deklariert wird:

response = client.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    container={
        "skills": [
            {"type": "anthropic", "skill_id": "pptx", "version": "latest"},
            {"type": "custom", "skill_id": "skill_01AbCdEfGhIjKlMnOpQrStUv", "version": "latest"}
        ]
    },
    messages=[{"role": "user", "content": "Build the Q3 revenue deck from the attached numbers"}],
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)

Die Regeln, die diesen Block steuern:

Das Code-Ausführungstool muss in tools aktiviert sein, da Skills innerhalb dieser Sandbox ausgeführt werden. Die Modellunterstützung folgt der Kompatibilitätsliste des Code-Ausführungstools.
Bis zu 20 Skills pro Anfrage. Claude liest die Beschreibung jedes Skills und lädt Anweisungen nur für die, die die Aufgabe benötigt.
Die Versionsfixierung liegt in Ihrer Hand. "latest" verweist auf die neueste Version; eine fixierte skver_*-ID (oder Datumsversion für Anthropic-Skills) friert das Verhalten ein. In Produktion fixieren, in Entwicklung flexibel halten.

Wenn ein Skill ein Dokument erstellt, enthält die Antwort eine file_id, die Sie über den GET /v1/files/{file_id}/content-Endpunkt der Files API herunterladen können. Dieser Zwei-API-Handshake (Skills zum Generieren, Files zum Abrufen) ist der Kern des Produktions-Workflows.

Versionierung: Snapshots, keine Diffs

Das Versionierungsmodell ist der Teil, den die meisten Teams beim ersten Versuch falsch machen. Eine neue Version ist ein vollständiger Snapshot, kein Delta. Wenn Sie POST /v1/skills/{skill_id}/versions aufrufen, laden Sie den gesamten Dateisatz des Skills erneut hoch; Dateien, die Sie weglassen, werden nicht von der vorherigen Version übernommen. Der name in der SKILL.md der neuen Version muss ebenfalls mit dem bestehenden Namen des Skills übereinstimmen.

Behandeln Sie Skill-Ordner wie Build-Artefakte: Halten Sie die Quelle der Wahrheit in Ihrem Repository, verpacken Sie den gesamten Ordner in CI und pushen Sie ihn als neue Version. Ein Rollback ist dann trivial, da alte Versionen weiterhin über ihre skver_*-IDs adressierbar sind und ein Produktionsvorfall durch erneutes Festlegen einer Zeichenkette behoben wird.

Workspace-Scoping: die Multi-Tenant-Falle

Benutzerdefinierte Skills sind in Ihrem gesamten Workspace zugänglich. Sie sind nicht auf einen Endbenutzer, eine Konversation oder eine Sitzung beschränkt, und jeder API-Schlüssel im Workspace teilt sie. Wenn Sie ein Multi-Tenant-Produkt betreiben, bei dem Mieter ihre eigenen Skills hochladen, ist ein einzelner Workspace eine tickende Zeitbombe für Datenlecks.

Die Lösung ist dieselbe wie für die Files API: Erstellen Sie einen separaten Workspace pro Mandanten. Der Workspace ist die Isolationsgrenze, und jede Organisation erhält bis zu 100 Workspaces, bevor sie sich an ein Account-Team wenden muss. Schlüssel, Dateien und Skills erben alle diese Grenze, sodass eine einzige Entscheidung alle drei isoliert.

Langlaufende Skills: pause_turn und Container-Wiederverwendung

Skill-Ausführungen können einen einzelnen Modell-Durchlauf überdauern. Zwei Mechanismen handhaben dies:

pause_turn: wenn eine Antwort mit stop_reason: "pause_turn" stoppt, fügen Sie den Assistenteninhalt Ihrer Nachrichtenhistorie hinzu und rufen Sie erneut auf, wobei Sie dieselbe container.id übergeben. Die Sandbox setzt dort fort, wo sie aufgehört hat.
Container-Wiederverwendung: Das container-Objekt akzeptiert eine id aus einer früheren Antwort, wodurch installierte Dateien und der Zustand über eine mehrteilige Konversation hinweg erhalten bleiben. Das bedeutet, dass ein Skill in Runde eins eine Tabelle erstellen und in Runde drei überarbeiten kann, ohne sie von Grund auf neu zu generieren.

Beide Muster sind zustandsbehaftete HTTP-Sequenzen, was sie manuell schwer zu testen macht, aber angenehm als Apidog-Szenario zu testen ist: Anfrage eins prüft stop_reason, ein Skript überträgt container.id in eine Variable, Anfrage zwei verwendet sie wieder, und der letzte Schritt prüft, ob die generierte file_id sauber heruntergeladen wird. Die Apidog CLI führt dasselbe Szenario in CI aus, sodass ein Skill-Versions-Bump Ihre Pipeline nicht stillschweigend unterbrechen kann. Wenn Sie sehen möchten, wie sich Skills im Ökosystem eines anderen Anbieters verhalten, haben wir Postmans Claude-Skill in einer früheren Überprüfung auseinandergenommen.

Wo es läuft

Bei der GA ist die Skills API auf der Claude API und über Microsoft Foundry verfügbar. Skills werden unabhängig davon in Anthropic’s Sandbox ausgeführt, sodass „Deployment“ ein Upload ist und es auf Ihrer Seite kein Container-Image, kein Runtime-Patching und keinen Skalierungsregler gibt. Beachten Sie die Modellabhängigkeit und nicht die Plattformabhängigkeit: Die Anfrage muss ein Modell verwenden, das das Code-Ausführungstool unterstützt, wie claude-opus-5 in den obigen Beispielen. Unser Claude Opus 5 API-Leitfaden behandelt die Grundlagen der Anfragen für dieses Modell, falls Sie neu einsteigen.

FAQ

Benötige ich noch den Beta-Header für Skills? Nein. Seit dem 20. August 2026 funktionieren /v1/skills und der Parameter container.skills mit Standard-Headern auf der Claude API. Entfernen Sie alle fixierten Beta-Flags, wenn Sie Ihr SDK aktualisieren.

Kann ein Skill externe APIs aufrufen, während er läuft? Skills werden innerhalb von Claudes Code-Sandbox mit den Netzwerkbeschränkungen des Code-Ausführungstools ausgeführt. Bündeln Sie das, was der Skill benötigt, in seinem Ordner, anstatt einen offenen Egress anzunehmen, und halten Sie die API-Aufruflogik in Ihrer Anwendungsschicht, wo Sie sie ordnungsgemäß testen können.

Wie viele Skills kann eine Anfrage laden? Bis zu 20. Claude liest das description-Frontmatter jedes Skills, um zu entscheiden, welche die Aufgabe benötigt, daher sind Beschreibungen entscheidend: Schreiben Sie sie wie Routing-Regeln, nicht wie Marketingtexte.

Was ist der Unterschied zwischen diesen und Claude Code Skills? Gleiches Konzept, unterschiedliche Laufzeitumgebung. Claude Code entdeckt Skill-Ordner auf Ihrem Dateisystem; die Skills API hostet sie serverseitig, versioniert, für Messages API-Aufrufe. Das Ordnerformat mit SKILL.md-Frontmatter ist geteilt, sodass ein Skill, den Sie für Claude Code geschrieben haben, normalerweise mit geringem Aufwand portiert werden kann.

Zusammenfassung

Die GA macht Skills von einem Experiment zu einer operativen Oberfläche: sechs Endpunkte, Snapshot-Versionierung, Workspace-Isolation und eine saubere Übergabe an die Files API für Ausgaben. Teams, die am schnellsten Wert generieren, behandeln Skills wie jedes andere deploybare Artefakt, was CI-Packaging, fest verankerte Versionen in der Produktion und automatisierte Tests rund um den Container-Lebenszyklus bedeutet. Modellieren Sie die sechs Endpunkte in Apidog, integrieren Sie den Versions-Bump in ein Testszenario, und Sie werden wissen, dass eine schlechte Skill-Version Ihren Deck-Generator beschädigt hat, bevor Ihre Benutzer es merken. Laden Sie Apidog kostenlos herunter und bauen Sie die Testumgebung an einem Nachmittag auf.