Claude Code Skills: Anlegen, installieren und sicher nutzen

Kopieren Sie dieselbe Checkliste immer wieder in den Chat? Ein Skill erledigt das einmal für immer. Claude Code Skills sind Ordner mit einer Datei SKILL.md, die Anweisungen für wiederkehrende Aufgaben enthält. Claude lädt sie selbst, wenn Ihre Anfrage passt, oder Sie rufen sie mit /name auf. Danach können Sie Skills anlegen, installieren, abgrenzen und prüfen.

Alle Angaben stammen aus der offiziellen Claude-Code- und Plattform-Dokumentation (Quellen unten), Stand Oktober 2026.

Was sind Claude Code Skills und wie lädt Claude sie?

Ein Skill ist eine SKILL.md-Datei mit Anweisungen. Sie lohnt sich, wenn Sie dieselbe Checkliste oder denselben Ablauf immer wieder in den Chat kopieren. Skills folgen dem offenen Standard „Agent Skills“. Claude Code ergänzt ihn um Funktionen wie Aufrufsteuerung und die Ausführung in einem Subagenten.

Entscheidend ist das Ladeprinzip, das die Dokumentation „Progressive Disclosure“ nennt:

• Immer im Kontext: Name und Beschreibung jedes Skills, damit Claude weiß, was verfügbar ist.
• Bei Bedarf: der vollständige Inhalt, sobald Sie /name tippen oder Claude den Skill zur Anfrage passend findet.
• Erst beim Zugriff: mitgelieferte Dateien, etwa Referenzen oder Skripte. Ein Skript wird ausgeführt, und nur seine Ausgabe belegt Kontext, nicht sein Code.

Die Beschreibung kostet rund 100 Token je Skill, der Hauptteil von SKILL.md liegt unter 5.000 Token. Details gehören deshalb in Zusatzdateien statt in SKILL.md. Dann kosten sie fast nichts, bis Claude sie braucht.

Wo liegen Skills und wie installiere ich sie?

Für eigene Skills genügt ein Ordner. Die Dokumentation nennt diese Speicherorte:

• ~/.claude/skills/<name>/SKILL.md: persönlich, für alle Ihre Projekte.
• .claude/skills/<name>/SKILL.md: im Projekt. Committen Sie den Ordner, hat Ihr Team ihn auch.
• <plugin>/skills/<name>/SKILL.md: Skills aus Plugins, aufrufbar als /plugin-name:skill-name.
• Enterprise: Skills im Verzeichnis der verwalteten Einstellungen (managed settings) einer Organisation. Sie gelten für alle Nutzer auf Rechnern, auf denen die Organisation sie ausrollt.

Bei gleichen Namen gilt: Enterprise vor persönlich, persönlich vor Projekt. Plugin-Skills sind namensgetrennt und kollidieren nicht.

„Installieren“ heißt bei fremden Skills meist: Plugin-Marketplace hinzufügen und Plugin wählen. Das offizielle Repository anthropics/skills beschreibt diesen Weg:

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

Alternativ öffnen Sie /plugin und wählen „Browse and install plugins“. Ein Plugin bündelt Skills, Subagenten, Hooks und MCP-Server in einer Einheit. Einen einzelnen Skill brauchen Sie dafür nicht zu verpacken: Ein Ordner mit SKILL.md reicht.

Skill, CLAUDE.md, Slash-Befehl, Subagent oder MCP: Was passt wann?

Die Funktionen lösen verschiedene Probleme und ergänzen sich. Die Tabelle fasst die offizielle Übersicht „Extend Claude Code“ und die Skills-Seite zusammen.

Die Faustregel: Was Claude immer wissen soll, gehört in CLAUDE.md, und das sollte unter 200 Zeilen bleiben. Was nur manchmal gebraucht wird oder ein Ablauf ist, gehört in einen Skill. Wächst CLAUDE.md zur Prozedur, ist das der Zeitpunkt für einen Skill.

MCP und Skills konkurrieren nicht. MCP liefert die Werkzeuge, ein Skill erklärt, wie Sie sie sinnvoll einsetzen, zum Beispiel mit Schema und Abfragemustern. Soll etwas garantiert jedes Mal passieren, sind Hooks das Mittel. Eine Regel in einem Skill ist eine Bitte, keine Garantie.

Wie lege ich einen eigenen Skill in 5 Minuten an?

1. Legen Sie den Ordner an: mkdir -p ~/.claude/skills/commit-nachricht.
2. Erstellen Sie darin die Datei SKILL.md. Die Metadaten stehen zwischen zwei ----Zeilen ganz am Dateianfang.
3. Schreiben Sie in description, was der Skill tut und wann er greifen soll, am besten in der dritten Person. Optional ergänzt when_to_use weitere Auslöser wie typische Formulierungen. Der Text wird an die Beschreibung angehängt.
4. Formulieren Sie darunter die Anweisungen und lagern Sie Referenzen in eigene Dateien aus.
5. Testen Sie mit /commit-nachricht oder mit einer passenden Frage.

---
name: commit-nachricht
description: Schreibt eine Commit-Nachricht aus den vorgemerkten Änderungen. Zu verwenden, wenn nach einer Commit-Nachricht gefragt wird.
---

## Vorgemerkte Änderungen

!`git diff --staged`

## Anweisungen

Fasse die Änderungen oben in einer Betreffzeile und zwei bis drei Stichpunkten zusammen.
Nenne Risiken wie fehlende Fehlerbehandlung. Ist der Diff leer, sage das.

Die Zeile mit dem Ausrufezeichen führt den Befehl aus, bevor Claude den Text sieht. Seine Ausgabe ersetzt den Platzhalter. Beim Namen sind höchstens 64 Zeichen erlaubt, nur Kleinbuchstaben, Zahlen und Bindestriche. Die Beschreibung ist auf 1.024 Zeichen begrenzt, SKILL.md sollte unter 500 Zeilen bleiben. Claude Code beobachtet die Skill-Verzeichnisse, Änderungen gelten innerhalb der Sitzung. Eine ausführliche Anleitung finden Sie in unserer Anleitung zu Skills.

Welche Claude Code Skills lohnen sich, und wo finde ich sie auf GitHub?

Die offizielle Quelle ist das Repository github.com/anthropics/skills. Es enthält Beispiele aus vier Bereichen: Kreatives und Design, Entwicklung und Technik (etwa Web-App-Tests und MCP-Server-Erzeugung), Unternehmen und Kommunikation sowie Dokumenten-Skills für docx, pdf, pptx und xlsx. Ein Ordner template/ liefert eine Vorlage.

Zwei Hinweise aus dem Repository: Viele Skills stehen unter Apache 2.0, die vier Dokumenten-Skills sind jedoch nur einsehbar, nicht quelloffen. Und die Skills sind laut Anbieter „zu Demonstrations- und Lehrzwecken“ gedacht. Testen Sie sie gründlich, bevor Sie sich bei kritischen Aufgaben darauf verlassen.

Eine allgemeine Bestenliste „best claude code skills“ gibt es nicht. Sinnvoll ist, was Ihre wiederkehrenden Aufgaben abdeckt: Review-Checklisten, Release-Abläufe, Schema- und API-Wissen. Eine Sammlung aus der Praxis bietet die Skills-Datenbank unserer Community. Als Zusatzpaket mit Skills und Prüfregeln für Claude Code gibt es außerdem Code Guardian.

Wie sicher sind fremde Skills?

Ein Skill ist Software, die Claude anweisen darf. Anthropic empfiehlt, Skills nur aus vertrauenswürdigen Quellen zu nutzen, also selbst geschriebene oder von Anthropic. Ein bösartiger Skill kann Claude dazu bringen, Werkzeuge oder Code anders einzusetzen, als sein Zweck vorgibt. Mögliche Folgen sind Datenabfluss oder unbefugter Zugriff.

Prüfen Sie vor dem Einsatz:

• Alle Dateien lesen: SKILL.md, Skripte und Ressourcen. Achten Sie auf unerwartete Netzwerkzugriffe oder Dateizugriffe.
• Externen Abrufen misstrauen: Geladene Inhalte können Anweisungen enthalten, und Abhängigkeiten können sich später ändern.
• allowed-tools prüfen: Die Freigaben eines Projekt-Skills gelten auch in nicht vertrauten Ordnern.
• Plugins gesondert beachten: Sie können Hooks und MCP-Server enthalten, die mit Ihren Benutzerrechten Code ausführen. /plugin zeigt vor der Installation, was ein Plugin mitbringt.
• Auto-Updates bedenken: Das geprüfte Plugin kann sich im Hintergrund ändern.

Zwei Einstellungen helfen dabei. Die Option disableSkillShellExecution ersetzt eingebettete Shell-Befehle in Skills durch einen Platzhalter. Sie ist vor allem in den verwalteten Einstellungen einer Organisation sinnvoll. Mit skillOverrides in den Einstellungen setzen Sie einen fremden Skill auf „on“, „name-only“, „user-invocable-only“ oder „off“, ohne seine Datei zu ändern.

Häufige Fragen

Kann ich einen Skill nur von Hand aufrufen?

Ja. Mit disable-model-invocation: true lädt Claude den Skill nicht selbst, und seine Beschreibung bleibt aus dem Kontext. Sie starten ihn dann mit /name. Die Dokumentation empfiehlt das für Skills mit Nebenwirkungen, etwa Deployments.

Brauche ich ein Plugin, um Skills zu nutzen?

Nein. Ein Skill in ~/.claude/skills/ funktioniert allein. Ein Plugin lohnt sich, wenn Sie mehrere Skills, Subagenten, Hooks oder MCP-Server als eine Einheit verteilen wollen, etwa über mehrere Repositories.

Wie viel Kontext kosten viele Skills?

Dauerhaft nur Name und Beschreibung, rund 100 Token je Skill. Vage oder überlappende Beschreibungen können dazu führen, dass Claude den falschen Skill lädt. Formulieren Sie daher konkret, was der Skill tut und wann er gilt.

Gibt es Längengrenzen?

SKILL.md sollte unter 500 Zeilen bleiben. Der Name ist auf 64 Zeichen begrenzt, die Beschreibung auf 1.024. Claude Code kürzt zudem Beschreibung und when_to_use zusammen bei 1.536 Zeichen im Skill-Verzeichnis.

Muss ich Claude Code nach Änderungen neu starten?

In der Regel nicht. Claude Code übernimmt neue, geänderte oder entfernte Skills innerhalb der Sitzung. Legen Sie mitten in einer Sitzung ein ganz neues skills/-Verzeichnis an, führen Sie /reload-skills aus.

Wie teile ich Skills im Team?

Legen Sie sie unter .claude/skills/ im Projekt ab und committen Sie sie. Für mehrere Repositories bietet sich ein Plugin an. Skills von claude.ai und aus der API synchronisieren sich nicht mit Claude Code. Hilfe beim Einrichten im Team finden Sie unter KI-Entwicklung.

Quellen

• Claude Code Dokumentation: Extending Claude Code with Skills
• Claude Code Dokumentation: Extend Claude Code (Vergleich der Funktionen)
• Claude Code Dokumentation: Plugins overview
• Claude Code Dokumentation: Plugin security and trust
• Anthropic: Agent Skills Overview
• Anthropic: Skill authoring best practices
• GitHub: anthropics/skills (offizielles Repository)

Stand: Oktober 2026. Allgemeine Information; Funktionen von Claude Code ändern sich häufig.