Skills
Skills sind Ordner mit Anweisungen, Skripten und Ressourcen, die Claude
dynamisch lädt, um die Leistung bei spezialisierten Aufgaben zu verbessern. Im
Kern jedes Skills steht eine SKILL.md-Datei — ein gepackter Satz von Anweisungen, den du einmal
hochlädst und dann an jeden messages.create-Aufruf anhängst. Du bringst
Claude bei, wie du etwas machst: dein Statusbericht-Format, deine Review-
Checkliste, deine Release-Notes. Claude liest das Skill, folgt der
Vorgehensweise und erzeugt die Ausgabe in deiner Form.
Skills vs. Tools
Es lohnt sich, den Unterschied klarzustellen, denn beide lösen unterschiedliche Probleme:
- Tools verbinden Claude mit Daten und Aktionen. „Schlag diesen Codeabschnitt nach“, „sende diese E-Mail“ — Claude ruft das Tool auf, und etwas anderes wird ausgeführt.
- Skills bringen Claude eine Vorgehensweise bei. „Erstelle den täglichen Statusbericht nach dieser Vorlage“ — es ist ein Playbook, das Claude liest und befolgt, was manchmal bedeutet, dass es selbst gebündelte Skripte ausführt.
Eine einfache Merkregel: Bei Tools geht es darum, was Claude tun kann, während es bei Skills darum geht, wie du es erledigt haben möchtest.

Noch etwas Wissenswertes: Skills werden beim Start nicht vollständig in den Kontext geladen. Zunächst werden nur Name und Beschreibung geladen. Wenn dein Agent entscheidet, dass ein Skill relevant ist, lädt er anschließend das vollständige Skill in den Kontext. Das hält deinen Kontext schlank, selbst wenn viele Skills verfügbar sind.
Ein Skill hochladen
Skills werden einmal in deinen Workspace hochgeladen und dann per ID referenziert. Du kannst sie direkt auf der Claude Platform hochladen oder programmatisch vorgehen:
import anthropic
from anthropic.lib import files_from_dir
client = anthropic.Anthropic()
skill = client.skills.create(
display_name="Status Report Generator",
files=files_from_dir("status-report-skill"), # folder containing SKILL.md
)
print(skill.id) # reference this ID in future requestsFür dieses Beispiel möchte ich einen Statusbericht-Generator. Alle Regeln dafür, was einen guten Statusbericht ausmacht — Abschnitte, Tonfall, wie man zusammenfasst, wie man mit Blockern umgeht — stecken in einem Skill, das vorab gepackt wurde. Das Aktivitätsprotokoll selbst ist nur eine Zeichenkette, die zur Anfragezeit übergeben wird.
Ein Skill an eine Anfrage anhängen
Skills werden über die Container-Konfiguration an eine Anfrage angehängt — ein skills-Array innerhalb des Containers, wobei jeder Eintrag eine skill_id und version benennt. Hier ist der vollständige Aufruf für den Statusbericht-Generator:
response = client.messages.create(
model="claude-opus-5",
max_tokens=4096,
container={
"skills": [
{
"type": "custom",
"skill_id": skill.id,
"version": "latest",
}
]
},
tools=[
{
"type": "code_execution_20250825",
"name": "code_execution",
}
],
messages=[
{
"role": "user",
"content": f"Generate the daily status report from this activity log:\n\n{activity_log}",
}
],
)Ein paar Dinge, die es hervorzuheben lohnt:
- Wir rufen das Standard-
client.messages.createohne Beta-Header auf. Skills sind in der Claude API allgemein verfügbar, sodass der Beta-Headerskills-2025-10-02nicht mehr erforderlich ist; Anfragen, die ihn weiterhin senden, funktionieren unverändert weiter. container.skillsist die Stelle, an der das Skill angehängt wird. Es ist eine Liste, sodass du mehrere Skills auf einen Aufruf schichten kannst.- Code-Ausführung ist hier ebenfalls aktiviert. Sie ist erforderlich: In der API laufen Skills innerhalb des Containers des Code-Ausführungstools, wodurch Skill-Vorgehensweisen echte Arbeit verrichten können — etwa das Ausführen von Skripten in einem Terminal.
Es ausführen
Die Ausgabe ist ein Statusbericht, der genau so formatiert ist, wie das Skill es vorgibt. Abschnitte, Tonfall, Umgang mit Blockern — all das stammt aus der SKILL.md-Datei, die du hochgeladen hast. Der User-Prompt ist eine einzige Zeile; die Vorgehensweise steckt im Skill.

In einer Produktionsanwendung standardisiert ein Team auf diese Weise die Ausgabe über ein gesamtes Feature hinweg. Mit diesem Endpunkt für tägliche Statusberichte erhält jeder PM dieselbe Struktur, denselben Tonfall, dieselben Abschnitte in derselben Reihenfolge — ohne dass jemand eine Vorlage in einen Prompt kopieren und einfügen muss.

Zusammenfassung
- Skills verpacken deine Vorgehensweisen. Eine
SKILL.md-Datei (plus etwaige Skripte und Ressourcen) bringt Claude bei, wie du möchtest, dass etwas erledigt wird. - Tools vs. Skills: Bei Tools geht es darum, was Claude tun kann; bei Skills geht es darum, wie du es erledigt haben möchtest.
- Skills laden progressiv. Beim Start werden nur Name und Beschreibung geladen; das vollständige Skill wird in den Kontext geladen, wenn der Agent entscheidet, es zu verwenden.
- Einmal hochladen mit
client.skills.create, dann anhängen mitcontainer.skillsbei jedemmessages.create-Aufruf — eine Liste, sodass du mehrere Skills schichten kannst. - Kombiniere es mit Code-Ausführung, wenn die Vorgehensweise des Skills echte Arbeit verrichten muss.
- Greife zu einem Skill, wenn das Wie genauso wichtig ist wie das Was.