Claude Code Skills sind Ordner mit einer SKILL.md-Datei, die Claude eine wiederkehrende Aufgabe beibringen, etwa einen PR zu prüfen oder ein Release zu schneiden, und Claude lädt einen nur, wenn deine Anfrage ihn braucht. Damit sind Skills der richtige Ort für Anweisungen, die für manche Aufgaben wichtig sind, aber nicht für jede Session. Der Haken: Ein Skill sind Anweisungen, denen dein Agent folgt, also verdient ein Skill aus dem Internet dieselbe Sorgfalt wie ein Skript aus dem Internet.
Dieser Beitrag behandelt das Skill-Format, wo Skills liegen, wie Claude sie auswählt, wie du einen guten schreibst und wie du geteilte Skills findest und installierst, ohne deinem Agenten etwas Gefährliches in die Hand zu geben.
Was ein Claude Code Skill ist
Ein Skill ist ein Ordner. Die einzige Pflichtdatei ist SKILL.md:
---
name: release-notes
description: Use when the user asks for release notes or a changelog entry for a version.
---
1. Run `git log --oneline <last-tag>..HEAD`.
2. Group the commits into Features, Fixes and Other.
3. Write one plain sentence per change, for users, not developers.
4. Ask before writing to CHANGELOG.md.Das Frontmatter enthält name und description. Der Hauptteil ist die Anweisung, der Claude folgt, sobald der Skill geladen ist. Der Ordner kann auch Skripte und Referenzdateien enthalten, auf die die Anweisungen verweisen. Ein Skill kann also sagen „führe scripts/check.sh aus“ oder „lies reference/api.md für die Endpunktliste“.
Wo Claude Code Skills liegen
| Ort | Wer ihn bekommt | Typischer Einsatz |
|---|---|---|
.claude/skills/<name>/SKILL.md | Alle, die am Repo arbeiten, über Git | Projekt-Workflows: Deploy, Migrationen, Release |
~/.claude/skills/<name>/SKILL.md | Du, in jedem Projekt | Persönliche Gewohnheiten: deine Review-Checkliste, Commit-Stil |
Der Ordnername wird zum Befehl, also lässt sich .claude/skills/release-notes/SKILL.md auch als /release-notes ausführen. Tippe /skills in einer Session, um die Skills aufzulisten, die Claude sieht. Die übrigen Slash-Befehle findest du im Claude Code Befehle Spickzettel.
Wie Claude entscheidet, einen Skill zu verwenden
Zu Beginn einer Session sieht Claude die Beschreibungen der Skills, nicht ihre vollständigen Inhalte. Passt deine Anfrage zu einer Beschreibung, lädt es diesen Skill. Daraus folgen zwei Dinge:
- Die Beschreibung übernimmt das Routing. „Release-Notes-Skill“ ist eine schwache Beschreibung. „Use when the user asks for release notes or a changelog entry for a version“ sagt Claude, wann es danach greifen soll.
- Skills halten deinen Basiskontext klein. Nur die Beschreibungen werden in jeder Session geladen. Wenn du aufgabenspezifische Anweisungen aus
CLAUDE.mdin Skills verschiebst, wird jeder Turn leichter. Mehr dazu im Beitrag Claude Code Kontextfenster.
Skills, CLAUDE.md, Subagents und MCP
Diese vier überschneiden sich, deshalb hilft es zu wissen, welcher passt.
| Werkzeug | Geladen | Am besten für |
|---|---|---|
CLAUDE.md | Jede Session, ganze Datei | Regeln, die immer gelten |
| Skill | Beschreibung immer, Inhalt bei Bedarf | Ein Workflow, den du ab und zu wiederholst |
| Subagent | Bei Delegation, im eigenen Kontext | Schwere Arbeit, deren Details du nicht zurückbrauchst |
| MCP-Server | Tool-Definitionen in jeder Session | Zugriff auf externe Systeme oder Daten |
Wenn du denselben Absatz zweimal pro Woche in Prompts einfügst, sollte es ein Skill sein. Muss der Agent mit einer Datenbank oder einer API sprechen, ist das ein MCP-Server (was ein MCP-Server ist).
So schreibst du einen guten Skill
- Starte mit einer Aufgabe, die du schon wiederholst. Schreibe die Schritte auf, die du heute tippst.
- Schreibe die Beschreibung als Auslöser. Beginne mit „Use when…“ und nenne die Wörter, die ein Nutzer sagen würde.
- Halte den Hauptteil kurz und geordnet. Nummerierte Schritte schlagen Absätze.
- Lege langes Material in Dateien. Eine Referenztabelle oder ein Skript kommt neben
SKILL.md, und der Hauptteil sagt, wann es zu lesen oder auszuführen ist. - Sag, was nicht zu tun ist. „Ask before writing to CHANGELOG.md“ verhindert die Überraschung, die du sonst von Hand korrigieren müsstest.
- Teste ihn in einer frischen Session. Bitte in eigenen Worten um die Aufgabe und prüfe, ob Claude den Skill ohne Hinweis wählt.
Das Risiko bei geteilten Skills
Beim Teilen werden Skills nützlich und riskant. Ein Skill kann deinem Agenten sagen, einen Shell-Befehl auszuführen, eine Datei außerhalb des Projekts zu lesen oder etwas an eine URL zu senden. Läuft dein Agent mit weitreichenden Rechten, läuft ein bösartiger oder nachlässiger Skill mit denselben. Worauf du vor der Installation achten solltest:
- Destruktive oder privilegierte Befehle (
rm -rf,sudo) - Das Lesen von Secrets, etwa
.env-Dateien oder SSH-Schlüssel - Daten, die an einen unbekannten Host gesendet werden
- Download-und-Ausführen-Muster, etwa
curlin eine Shell zu pipen - Verschleierter Code oder versteckte Unicode-Zeichen
- Prompt Injection: Text, der versucht, deine Anweisungen zu überschreiben
Der Beitrag Sicherheit bei KI-Coding-Agenten behandelt Berechtigungen und Sandboxing ausführlicher.
Skills in AgentVera verwalten
Die Skill-Galerie von AgentVera findest du auf der Details-Seite eines Projekts unter Automation → Skills. Sie hat drei Ansichten: Local, Discover und My published.
Local listet die Skills auf deinem Computer für beide Agenten, die Skill-Ordner nutzen:
| Agent | Projektordner | Persönlicher Ordner |
|---|---|---|
| Claude Code | .claude/skills | ~/.claude/skills |
| Codex | .agents/skills | ~/.codex/skills |
Von dort aus kannst du:
- Mit New skill einen anlegen: wähle den Agent (Claude Code oder Codex), den Scope (This project oder All projects), einen Name (Kleinbuchstaben, Ziffern und Bindestriche) und When should it be used?, was zur Beschreibung wird. Create and edit öffnet die neue
SKILL.md. - Einen Skill ausschalten, ohne ihn zu löschen. Der Schalter verschiebt den Ordner an einen Ort, den die CLIs nicht durchsuchen.
SKILL.mdansehen oder bearbeiten, einen Skill für den anderen Agenten oder Scope kopieren oder ihn löschen, wodurch der Ordner in den Papierkorb wandert.
Skills sicher finden und installieren
Discover zeigt die Skills deiner Organisation und die öffentliche Galerie. Suche, wähle eine von 10 Kategorien (Coding, Testing, Code Review, DevOps, Daten, Doku, Design, Sicherheit, Produktivität, Sonstiges), filtere nach Agent und sortiere nach Popular oder New. Dieselbe Galerie gibt es im Web unter app.agentvera.dev/skills.
Die Detailansicht jedes Skills hat die Tabs Files, Security und Versions. Der Security-Tab zeigt den Server scan. Der Scan sucht nach destruktiven oder privilegierten Befehlen, dem Lesen von Secrets, eingebetteten Schlüsseln, nach außen gesendeten Daten, Download-und-Ausführen, verschleiertem Code, Prompt Injection, verstecktem Unicode, rohen IP-Adressen und externen Hosts. Die Ergebnisse reichen von unbedenklich über Info, geringes, mittleres und hohes Risiko bis kritisch.
Die Installation hat zwei Schritte:
- Download and scan. AgentVera lädt die Dateien herunter, prüft ihr SHA-256 und scannt sie auf deinem Computer erneut.
- Install. Skripte werden als normale Dateien geschrieben und nicht ausführbar gemacht.
Agenten sehen den Skill in ihrer nächsten Session. Wird eine neue Version veröffentlicht, erscheint neben dem installierten Skill ein Update-Button. Galerie-Skills werden nur für die Agenten installiert, die sie unterstützen: Claude Code und Codex.
Öffentliche Skills durchlaufen einen Sicherheits-Scan und ein Moderator-Review, aber sieh dir trotzdem die Ergebnisse und die Dateien an. Der Scan erkennt Muster; du weißt, was dein Projekt tun soll und was nicht.
Eigene Skills teilen
Mit einem Pro- oder Team-Plan und einem AgentVera-Konto veröffentlicht Share einen lokalen Skill. Du gibst ihm einen Titel, eine Zusammenfassung von 20 bis 300 Zeichen, bis zu 6 Tags, eine Kategorie und eine Version wie 1.0.0, mit einem Changelog für jede Version. Ein Skill ist auf 50 Textdateien, 256 KB pro Datei und 1 MB insgesamt begrenzt.
- Nur Organisation: sofort für deine Organisation sichtbar, wenn der Scan nichts Hohes oder Kritisches findet; andernfalls wird er abgelehnt.
- Öffentlich: wartet auf die Freigabe durch einen Moderator, und kritische Funde werden nicht akzeptiert. Verfolge ihn unter My published.
Skills und Token-Verbrauch
Jeder Skill fügt seine Beschreibung dem Basiskontext hinzu. Eine Handvoll ist in Ordnung; Dutzende persönlicher Skills summieren sich in jedem Turn. Das Lean-Kontextprofil von AgentVera lädt keine Skills auf Benutzerebene, was einer der Gründe ist, warum seine erste Anfrage kleiner ist (hier gemessen). Halte Projekt-Skills im Repo und räume persönliche auf, die du nicht mehr nutzt.
Fazit
Claude Code Skills machen aus wiederholten Prompts Ordner, die Claude bei Bedarf lädt: eine SKILL.md mit klarer „Use when“-Beschreibung, kurzen geordneten Schritten und den nötigen Skripten, in .claude/skills für das Projekt oder ~/.claude/skills für dich. Geteilte Skills lohnen sich nur, wenn du sie vorher prüfst. AgentVera listet Claude Code und Codex Skills an einem Ort, scannt Galerie-Skills auf dem Server und vor der Installation noch einmal auf deinem Computer und lässt Pro- und Team-Nutzer eigene veröffentlichen. Lade AgentVera herunter, um deine Skills zu verwalten.