Wird geladen
Wird geladen

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.

Seite-an-Seite-Vergleich von Tools und Skills: Tools verbinden sich mit Daten, führen Aktionen aus und führen Code aus — was Claude tun kann; Skills bringen eine Vorgehensweise nur mit Anweisungen bei, es wird kein Code ausgeführt — 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:

python
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 requests

Fü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:

python
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.create ohne Beta-Header auf. Skills sind in der Claude API allgemein verfügbar, sodass der Beta-Header skills-2025-10-02 nicht mehr erforderlich ist; Anfragen, die ihn weiterhin senden, funktionieren unverändert weiter.
  • container.skills ist 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.

Terminal-Ausgabe des generierten täglichen Statusberichts mit den Abschnitten Erledigt und Blocker sowie einer vom Skill formatierten Zusammenfassung

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.

Eine Projektmanagement-App mit einer Seite „Tägliche Berichte“, bei der das Aktivitätsprotokoll jedes Projekts über einen Ein-Klick-Button „Bericht erstellen“ verfügt, der vom Skill angetrieben wird

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 mit container.skills bei jedem messages.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.