Skills vs. Tools

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 befindet sich eine SKILL. md Datei — ein gepackter Satz von Anweisungen, den Sie einmal hochladen und dann an jeden messages. create Aufruf anhängen. Sie lehren Claude, wie Sie etwas tun: Ihr Status-Report-Format, Ihre Review-Checkliste, Ihre Release Notes. Claude liest den Skill, folgt dem Verfahren und produziert Output in Ihrer Form.

Es lohnt sich, den Unterschied klar zu machen, denn die beiden lösen unterschiedliche Probleme:

Tools verbinden Claude mit Daten und Aktionen. „Schau dir diesen Code-Abschnitt an", „sende diese E-Mail" — Claude ruft das Tool auf, und etwas anderes wird ausgeführt.
Skills lehren Claude ein Verfahren. „Generiere den täglichen Status-Report nach dieser Vorlage" — es ist ein Playbook, das Claude liest und befolgt, was manchmal bedeutet, dass es gebündelte Skripte selbst ausführt.

Eine einfache Merkregel: Tools handeln vom Was Claude tun kann, während Skills vom Wie handeln, wie Sie es getan haben möchten.

Nebeneinander-Vergleich von Tools und Skills: Tools verbinden sich mit Daten, führen Aktionen aus und führen Code aus — was Claude tun kann; Skills lehren ein Verfahren mit nur Anweisungen, kein Code wird ausgeführt — wie Sie es getan haben möchten

Noch eine Sache, die es zu wissen lohnt: Skills werden beim Start nicht vollständig in den Kontext geladen. Zunächst werden nur Name und Beschreibung geladen. Wenn Ihr Agent entscheidet, dass ein Skill relevant ist, wird der vollständige Skill dann in den Kontext geladen. Das hält Ihren Kontext schlank, auch wenn viele Skills verfügbar sind.

Einen Skill hochladen

Skills werden einmal in Ihren Workspace hochgeladen und dann nach ID referenziert. Sie können direkt auf der Claude Platform hochladen oder es programmgesteuert tun:

skill = client. beta. skills. create( display_title="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 Status-Report-Generator. Alle Regeln für das, was einen guten Status-Report ausmacht — Abschnitte, Ton, wie man zusammenfasst, wie man Blocker handhabt — leben in einem Skill, der im Voraus gepackt wird. Das Aktivitätsprotokoll selbst ist nur ein String, der zur Anfragzeit übergeben wird.

Einen Skill an eine Anfrage anhängen

Skills werden über die Container-Konfiguration an eine Anfrage angehängt — ein skills Array im Container, wobei jeder Eintrag eine skill_id und version benennt. Hier ist der vollständige Aufruf für den Status-Report-Generator:

response = client. beta. messages. create( model="claude-sonnet-4-5", max_tokens=4096, betas=["skills-2025-10-02", "code-execution-2025-08-25"], 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 zu beachten lohnt:

Wir rufen client. beta. messages. create auf, nicht den Standard, und übergeben die Skills-Funktion über den Beta-Header. Zum Zeitpunkt dieses Videos sind Skills noch eine Beta-Funktion.
container. skills ist, wo der Skill angehängt wird. Es ist eine Liste, sodass Sie mehrere Skills auf einen Aufruf schichten können.
Code-Ausführung ist hier auch aktiviert. Skills funktionieren oft gut mit Code-Ausführung, da Skill-Verfahren echte Arbeit leisten können — wie das Ausführen von Skripten in einem Terminal.

Es ausführen

Die Ausgabe ist ein Status-Report, der genau so formatiert ist, wie der Skill es sagt. Abschnitte, Ton, Blocker-Handhabung — alles kommt aus der SKILL. md Datei, die Sie hochgeladen haben. Der Benutzer-Prompt ist eine Zeile; das Verfahren lebt im Skill.

Terminal-Ausgabe des generierten täglichen Status-Reports mit Done- und Blockers-Abschnitten und einer vom Skill formatierten Zusammenfassung

In einer Produktions-App ist dies, wie ein Team die Ausgabe über ein ganzes Feature standardisiert. Mit diesem täglichen Status-Report-Endpunkt erhält jeder PM die gleiche Struktur, den gleichen Ton, die gleichen Abschnitte, in der gleichen Reihenfolge — ohne dass jemand eine Vorlage in einen Prompt kopiert und einfügt.

Eine Projektmanagement-App mit einer Seite „Daily reports", auf der jedes Aktivitätsprotokoll des Projekts eine Ein-Klick-Schaltfläche „Generate report" hat, die vom Skill unterstützt wird

Zusammenfassung

**Skills verpacken Ihre Verfahren. ** Eine SKILL. md Datei (plus alle Skripte und Ressourcen) lehrt Claude, wie Sie etwas getan haben möchten.
**Tools vs. Skills:** Tools handeln vom Was Claude tun kann; Skills handeln vom Wie Sie es getan haben möchten.
**Skills laden progressiv. ** Nur Name und Beschreibung werden beim Start geladen; der vollständige Skill wird in den Kontext geladen, wenn der Agent entscheidet, ihn zu verwenden.
Einmal hochladen mit client. beta. skills. create, dann anhängen mit container. skills auf jeden messages. create Aufruf — eine Liste, sodass Sie mehrere Skills schichten können.
Mit Code-Ausführung koppeln, wenn das Verfahren des Skills echte Arbeit leisten muss.
Greifen Sie zu einem Skill, wenn das Wie genauso wichtig ist wie das Was.