Claude Skills API: Was sich mit GA geändert hat und wie du sie nutzt

Seit dem 20. August 2026 sind die Claude Skills API, Computer Use und die Files API von Anthropic allgemein verfügbar. Beta-Header entfallen, Computer Use kann mehrere Aktionen pro Turn ausführen, und mit Browser Use kommt ein neues Tool hinzu. Ein grundlegendes Thema löst GA allerdings nicht: Skills werden weiterhin nur genutzt, wenn Claude sich dafür entscheidet. Versions-Pinning und ein gutes Aktivierungsdesign bleiben also deine Aufgabe.

Diese Änderungen bringt GA seit dem 20. August

Bestehende Beta-Integrationen funktionieren während der Migration weiter. Darüber hinaus fasst der Launch-Beitrag von Anthropic mehrere konkrete Neuerungen zusammen:

• Keine Beta-Header mehr. Der aktuelle Skills Guide nennt nur noch zwei Voraussetzungen: einen Claude-API-Key und aktivierte Code Execution im Request. Die Beta-Header, die ältere Anleitungen verlangten, sind aus der Dokumentation verschwunden.
• Mehrere Aktionen pro Turn. Das aktualisierte Computer-Use-Tool führt pro Modellaufruf mehrere Aktionen aus — etwa Klicken, Tippen, Tastendrücke und Screenshots — statt nur einer. Laut dem Account @ClaudeDevs erzielten Early-Access-Kunden 20–40 % weniger Round Trips pro Aufgabe.
• Ein Browser-Use-Tool. Es kombiniert Screenshots mit der Seitenstruktur. Dadurch kann der Agent gezielt ein Feld oder einen Button ansteuern, statt sich an Pixelkoordinaten zu orientieren — etwa in Webportalen für Versicherungsanträge.
• Mehr Spielraum mit der Files API. Pro Organisation stehen 1 TB Speicher, 5-mal höhere Rate Limits — laut @ClaudeDevs-Thread 500 RPM — sowie eine automatische Dateiexpiration zur Verfügung.
• Option für regulierte Workloads. Computer Use kann unter dem BAA von Anthropic jetzt für HIPAA-regulierte Workloads eingesetzt werden.
• Verfügbarkeit in Cloud-Plattformen. Skills API und Files API sind auch über Microsoft Foundry verfügbar. Die aktualisierten Computer-Use- und Browser-Use-Tools sollen für Vertex AI folgen; ein Termin wurde nicht genannt.

So greifen die drei APIs ineinander

Das Beispiel eines Schadensbearbeitungs-Agenten von Anthropic zeigt den kompletten Ablauf: Ein Eingabedokument wird über seine Datei-ID geladen (Files API), ein Skill mit dem Einreichungsprozess angewendet (Skills API), das Versicherer-Portal mit Browser Use ausgefüllt (Computer Use) und die Bestätigung anschließend wieder als Datei gespeichert. Uploads erfolgen einmalig; danach referenzierst du sie über file_id, statt sie bei jeder Anfrage erneut zu senden.

Beide mit dem Launch veröffentlichten Zahlen stammen von Anbieterseite. Im Launch-Beitrag berichtet Research Engineer Davide Locatelli, dass der längste Schaden-Workflow von 32 auf 13 Minuten sank und die Abschlussquote 100 % erreichte. Separat testete David Mlčoch, Mitgründer von Asteroid, Healthcare-Computer-Use-Flows im Early Access:

„32–52 % weniger Modellaufrufe, 25–32 % niedrigere Kosten pro Aufgabe, 100 % Abschlussquote bei jedem Workflow, zuvor 77 %“ — @MlcochDavid

Claude Skills über die Messages API aufrufen

Um einen Skill anzuhängen, genügt ein Parameter: ein container-Objekt im Request an die Messages API, das ein skills-Array enthält. Jeder Eintrag hat einen type — anthropic oder custom — eine skill_id und optional eine version.

Die wichtigsten Details dazu aus dem offiziellen Skills Guide:

• Code Execution muss aktiviert sein, und das Modell muss sie unterstützen. Die Beispiele im Guide verwenden claude-opus-5 mit dem Tool-Typ code_execution_20250825 und max_tokens=4096.
• Ein einzelner Request unterstützt maximal 20 Skills.
• Skills laufen in der Code-Execution-Sandbox von Anthropic: ohne Netzwerkzugriff, ohne Installation von Paketen zur Laufzeit und standardmäßig in einem neuen Container pro Request. Übernimmst du eine zurückgegebene container.id über mehrere Turns, kannst du den Container weiterverwenden. Jede Antwort enthält expires_at.
• Du musst Skill-Dateien nicht selbst hosten — Anthropic führt sie im Container aus.

response = client.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    tools=[{"type": "code_execution_20250825"}],
    container={
        "skills": [
            {"type": "anthropic", "skill_id": "xlsx", "version": "20251013"},
            {"type": "custom", "skill_id": "skill_01...", "version": "skver_01..."},
        ]
    },
    messages=[{"role": "user", "content": "Build the Q3 revenue summary"}],
)

Eingabedokumente nehmen den umgekehrten Weg: Lade sie zuerst über die Files API hoch und referenziere sie dann in einem Container-Upload-Block. Der Request folgt dem üblichen Format der Anthropic Messages API. Er funktioniert daher mit einem direkten Key ebenso wie über einen Anthropic-kompatiblen Relay-Service wie der Claude API von AIReiter.

Integrierte Skills verwenden kurze, lesbare IDs wie pptx, xlsx, docx und pdf; die Versionen sind etwa als Datum wie 20251013 oder als latest angegeben. Eigene Skills erhalten skill_01...-IDs, die auf deinen Workspace begrenzt sind.

Eigene Skills veröffentlichen: Diese Regeln führen zur Ablehnung

Ein Custom Skill ist ein Verzeichnis, dessen oberste Datei SKILL.md YAML-Frontmatter mit name und description enthält. Daneben können Scripts und Referenzdateien liegen. So sieht die kleinstmögliche funktionsfähige Datei aus:

---
name: eu-claims-filing
description: Use when filing or amending EU insurance claims. Loads the
  carrier-specific submission procedure, required fields, and rejection
  codes before filling any portal form.
---

# EU claims filing procedure
1. Pull the intake document by file_id ...

Der Upload erfolgt als ZIP-Archiv oder als einzelne Dateien; das Python SDK bietet dafür files_from_dir. Noch bevor ein Skill ausgeführt wird, prüft Anthropic feste Grenzen. Sie alle stehen im Skills Guide:

Die Verwaltung läuft laut demselben Guide über die ant-CLI oder die dahinterliegenden API-Endpunkte. Der Weg von der Datei zur fest gepinnten Version:

ant skills create ./eu-claims-filing   # returns skill_01...
ant skills:versions create skill_01...  # returns skver_01... — pin this in production

Zwei Verhaltensweisen überraschen Teams häufig beim ersten Einsatz: Jede neue Version ist ein vollständiger Snapshot. Du lädst also den gesamten Dateisatz erneut hoch; nicht enthaltene Dateien werden nicht aus der vorherigen Version übernommen. Und: Wenn du einen Skill löschst, verschwinden alle seine Versionen.

Checkliste für den Produktiveinsatz: pinnen, isolieren, cachen

In Produktion werden vor allem veränderliche Versionen, Workspace-weite Berechtigungen und Cache-Misses zum Problem. Der Skills Guide ist bei allen drei Punkten eindeutig.

1. Versionen pinnen. Mit latest oder ohne Versionsangabe verändert jeder Workspace-Nutzer mit Upload-Recht unmittelbar, was dein ausgerollter Agent ausführt. Verwende in Produktion fest gepinnte skver_...-IDs; latest gehört in die aktive Entwicklung.
2. Den Workspace als Mandantengrenze behandeln. Jeder API-Key in einem Workspace kann alle Custom Skills darin lesen, aufrufen und löschen. Die Isolationsgrenze ist der Workspace, nicht Nutzer oder Sitzung. Für Multi-Tenant-Anwendungen empfiehlt sich ein Workspace pro Mandant — inklusive Blick auf das Standardlimit von 100 Workspaces.
3. Die Skill-Liste für den Cache unverändert halten. Schon eine Änderung der Skill-Liste oder ihrer Reihenfolge verändert das System-Prompt-Präfix und invalidiert den Prompt-Cache. Gepinnte Custom-Versionen schützen dieses Präfix zusätzlich: Eine neu hochgeladene latest-Beschreibung würde es sonst ebenfalls umschreiben. Bei tokenbasierter Abrechnung verschwinden Einsparungen durch Cache-Hits unauffällig, wenn die Skill-Liste zwischen Requests driftet.
4. pause_turn behandeln. Lang laufende Skills liefern stop_reason: "pause_turn" zurück. Sende den zurückgegebenen Content in einem späteren Request erneut, um fortzufahren, oder ändere die Unterhaltung, um den Ablauf zu unterbrechen.
5. Die Datenaufbewahrung kennen. Agent Skills sind nicht von Zero-Data-Retention-Vereinbarungen abgedeckt. Für Skill-Definitionen und Ausführungsdaten gilt die reguläre Aufbewahrungsrichtlinie von Anthropic. Ist die Compliance API aktiviert, protokolliert der Activity Feed die Erstellung und Löschung von Skills und Skill-Versionen — allerdings nur ab dem Zeitpunkt der Aktivierung.
6. Die passenden Fehler abfangen. Fange Aufrufe mit anthropic.BadRequestError ab und trenne Skill-bezogene Fehler von anderen Fehlern aufgrund ungültiger Requests.
7. Keine ungenutzten Skills anhängen. Die Dokumentation sagt es ausdrücklich: Nicht verwendete Skills beeinträchtigen die Performance.

Das Aktivierungsproblem, das keine API-Änderung löst

GA verbessert die Infrastruktur rund um Skills, nicht aber die Entscheidung von Claude, wann es sie einsetzen soll. Ein wiederkehrender Punkt in den folgenden Nutzer-Diskussionen: Skills funktionieren als ausgelöste Verfahren, nicht als zweiter System Prompt.

„Mein Problem mit Claude Skills ist, dass sie keine Skills sind. Nichts zwingt Claude, sie tatsächlich zu nutzen. Claude macht, was es will ... Das sind nur MD-Dateien.“ — @Yampeleg, vor GA geschrieben; der Aufrufmechanismus ist unverändert

Der r/ClaudeAI-Thread zur Frage, ob Skills tatsächlich funktionieren, bringt die praktischen Lösungsansätze auf den Punkt:

„userstyle wird bei jedem Turn vorangestellt, Skills werden aber nur ausgelöst, wenn Claude anhand der Beschreibung entscheidet, sie aufzurufen.“ — u/samxu01

„Skills brauchen eine einfache, klare Metadaten-Beschreibung, die sich außerdem auf eine Aktion konzentriert, die Claude ausführt.“ — u/Chadum

Aus diesen Diskussionen ergeben sich vier Regeln:

• Formuliere die Beschreibung um Auslösephrasen und die gewünschte Aktion, nicht um eine Persona.
• Schreibe Abläufe, Prüfungen, Regeln und Tool-Auswahl in den Body. Der Test von u/MartinMystikJonas: „Wenn deine Skills Schritte definieren, die der Agent ausführen soll, Dinge, die er prüfen soll, Regeln, denen er folgen soll, und Tools, die er verwenden soll, dann ist das nützlich.“
• Verankere Dinge, die Claude nativ nicht gut beherrscht, wie u/Actual_Committee4670 empfiehlt.
• Lege Anforderungen, die immer gelten müssen, in den System Prompt oder in CLAUDE.md — sie werden laut u/samxu01 oben bei jedem Turn vorangestellt. Hooks bleiben dagegen für Lifecycle-Momente, etwa vor einem Commit.

Kurz beantwortet

Brauche ich für die Skills API weiterhin Beta-Header?

Nein. Seit GA am 20. August 2026 genügen ein Claude-API-Key und aktivierte Code Execution. In der aktuellen Dokumentation ist kein Beta-Header mehr erforderlich.

Verbrauchen Skills mein Kontextfenster?

Zunächst nur ihre Metadaten. Laut Skills Guide erhält Claude vorab das Frontmatter jedes Skills, kopiert die Dateien in den Container und lädt die vollständigen Anweisungen erst, wenn die Aufgabe sie erfordert. Deshalb warnt die Dokumentation davor, ungenutzte Skills anzuhängen.

Was unterscheidet einen Skill von MCP?

Ein Skill ist ein Paket aus Anweisungen und Scripts, das ohne Netzwerkzugriff in Claudes Sandbox läuft. MCP verbindet Claude dagegen mit externen Live-Systemen — so grenzt Anthropic beides in seiner Skills-Übersicht voneinander ab. Ein Schaden-Workflow kann beides nutzen: einen MCP-Server für die Policendatenbank und einen Skill für den Einreichungsprozess.

Kann dieselbe SKILL.md in Claude.ai, Claude Code und der API laufen?

Das Format SKILL.md ist gemeinsam, die Bereitstellung unterscheidet sich aber je nach Oberfläche: über den Workspace hochgeladene Skills in der API, .claude/skills-Verzeichnisse in Claude Code und planbezogene Uploads in der Claude.ai-App.

Funktioniert die Skills API mit Zero Data Retention?

Nein. Agent Skills sind von Zero-Data-Retention-Vereinbarungen ausgenommen; für Skill-Definitionen und Ausführungsdaten gilt die reguläre Aufbewahrungsrichtlinie.

Welcher Mechanismus passt zu welcher Anforderung?

Entscheidend ist der Zeitpunkt des Aufrufs:

Der 20. August hat den Skill-Mechanismus produktionsreif gemacht. Die Einträge in dieser Tabelle sind dadurch aber nicht austauschbar geworden.

Weiterführend: Claude API: Preise nach Modell und Token und einen Claude Skill in Claude Code aufzeichnen.