ANLEITUNG
Claude Skills erklärt: was sie sind und wie du deinen ersten schreibst
Ein Skill ist ein Ordner mit einer Datei namens SKILL.md, in der du Claude eine Aufgabe einmal genau erklärst. Claude Code lädt ihn, sobald deine Anfrage dazu passt, oder wenn du /name-des-skills tippst. In NativeExpress, meiner App-Vorlage, stecken sieben Skills, von der Einrichtung bis zur Einreichung im App Store. Hier steht, wie Skills funktionieren und wie du deinen eigenen schreibst.
Von Robin FarajStand
Das Wichtigste in Kürze
- Was ein Skill ist
- Ein Ordner mit einer SKILL.md: oben ein Name und eine Beschreibung, darunter die Anleitung. Dazu dürfen Skripte, Vorlagen und weitere Dateien kommen.
- Wie Claude ihn lädt
- Am Anfang kennt Claude nur Name und Beschreibung. Die ganze Anleitung lädt er erst, wenn die Aufgabe dazu passt. Deshalb kostet ein Skill fast nichts, solange du ihn nicht brauchst.
- Wo er liegt
- Im Projekt unter .claude/skills/<name>/SKILL.md, für dich allein in allen Projekten unter ~/.claude/skills/<name>/SKILL.md.
- Ein offener Standard
- Anthropic hat das Format entwickelt und als Agent Skills offen veröffentlicht. Andere Tools wie Codex und Cursor lesen es auch.
Was sind Claude Skills?
Claude Skills sind Anleitungen, die Claude bei Bedarf nachschlägt. Anthropic beschreibt es so: Du legst eine SKILL.md mit Anweisungen an, und Claude nimmt sie in seinen Werkzeugkasten auf. Er benutzt den Skill, wenn er passt, oder du rufst ihn direkt mit /name-des-skills auf.
Das Format heißt Agent Skills und ist ein offener Standard. Ursprünglich hat Anthropic es entwickelt, inzwischen lesen es viele andere KI-Tools. Ein Skill, den du für Claude Code schreibst, funktioniert deshalb im Kern auch in anderen Agents, nur die Extras von Claude Code nicht.
Wie Claude Code Skills lädt
Agent Skills arbeiten in drei Stufen. Beim Start lädt Claude nur Name und Beschreibung jedes Skills, gerade genug, um zu wissen, wann er passen könnte. Passt deine Anfrage zur Beschreibung, liest er die ganze SKILL.md. Erst dann führt er die Anleitung aus und öffnet bei Bedarf die Dateien, die der Skill mitbringt.
Daraus folgt die wichtigste Regel: Die Beschreibung entscheidet, ob ein Skill überhaupt benutzt wird. Schreib hinein, wofür er ist und wann er greifen soll, mit den Wörtern, die du selbst tippen würdest. In Claude Code wird der Text aus Beschreibung und when_to_use nach 1.536 Zeichen abgeschnitten, also gehört das Wichtigste nach vorn.
Einmal geladen, bleibt ein Skill für den Rest der Unterhaltung im Kontext. Claude liest die Datei dann nicht jedes Mal neu.
Wo Claude Skills liegen
Gibt es denselben Namen an mehreren Orten, gewinnt die Firma vor dir und du vor dem Projekt.
| Ort | Gilt für |
|---|---|
| .claude/skills/<name>/SKILL.md | Dieses Projekt, im Git fürs Team |
| ~/.claude/skills/<name>/SKILL.md | Dich, in allen Projekten |
| Plugin | Überall, wo das Plugin aktiv ist |
| Verwaltete Einstellungen | Alle in deiner Firma |
Skills, CLAUDE.md, Slash-Befehle und MCP: der Unterschied
- Skill vs. CLAUDE.md
- Die CLAUDE.md lädt bei jeder Sitzung, ein Skill nur bei Bedarf. In die CLAUDE.md gehören Fakten und Regeln, die immer gelten. In einen Skill gehört ein Ablauf, den Claude nur für bestimmte Aufgaben braucht.
- Skill vs. Slash-Befehl
- Eigene Slash-Befehle sind in Skills aufgegangen. Eine Datei .claude/commands/deploy.md und ein Skill .claude/skills/deploy/SKILL.md erzeugen beide /deploy. Alte Befehle funktionieren weiter, der Skill kann aber Zusatzdateien mitbringen und von selbst laden.
- Skill vs. MCP
- Ein Skill bringt Claude bei, wie er etwas tun soll. Ein MCP-Server gibt ihm Zugriff auf ein Werkzeug, zum Beispiel deine Datenbank. Oft arbeiten beide zusammen: Der Skill beschreibt den Ablauf, der MCP-Server führt ihn aus.
So schreibst du deinen ersten Skill
- 1. Nimm eine Aufgabe, die du immer wieder erklärst
- Anthropic empfiehlt einen Skill genau dann, wenn du dieselbe Anleitung oder Checkliste immer wieder in den Chat kopierst. Zum Beispiel: wie ein neuer Bildschirm in deiner App aufgebaut wird.
- 2. Leg den Ordner an
- Im Projekt unter .claude/skills/neuer-bildschirm/ eine Datei SKILL.md. Der Ordnername wird zum Befehl, in Kleinbuchstaben mit Bindestrichen.
- 3. Schreib Name und Beschreibung
- Oben zwischen zwei Zeilen mit --- stehen name und description. Die Beschreibung sagt, wann der Skill greift. Sie muss ab der ersten Zeile der Datei stehen, sonst lädt der Skill ohne Einstellungen.
- 4. Schreib die Anleitung
- Darunter in normalem Markdown, Schritt für Schritt. Unter 500 Zeilen bleiben, längere Nachschlagewerke in eigene Dateien im Ordner auslagern.
- 5. Teste ihn
- Starte Claude Code und stell eine Anfrage, die zur Beschreibung passt. Lädt er den Skill nicht von selbst, ruf ihn mit /neuer-bildschirm auf oder schreib die Beschreibung wörtlicher.
---
name: neuer-bildschirm
description: Legt einen neuen Bildschirm in der App an. Benutzen, wenn
jemand einen neuen Screen, eine neue Seite oder einen neuen Tab will.
---
# Neuer Bildschirm
1. Lege die Datei unter app/ an. Der Dateiname ist der Pfad
(Expo Router), zum Beispiel app/einstellungen.tsx.
2. Nutze nur Bausteine aus src/components/, keine neuen Farben:
Farben kommen aus dem Theme.
3. Alle Texte in die Übersetzungsdateien, nie direkt in den Code.
4. Prüfe den Bildschirm im hellen und im dunklen Modus.
5. Führe danach yarn check aus. Erst wenn alles grün ist, fertig melden.Die wichtigsten Einstellungen im Kopf der SKILL.md
Alle Felder sind freiwillig, aber description solltest du immer setzen. Diese brauchst du am häufigsten:
- name
- Der Name des Befehls. Fehlt er, nimmt Claude den Ordnernamen.
- description
- Wofür der Skill ist und wann er greifen soll. Das Einzige, was Claude vorher sieht.
- disable-model-invocation: true
- Nur du kannst den Skill starten, Claude nie von selbst. Gut für alles mit Folgen, zum Beispiel eine Veröffentlichung.
- allowed-tools
- Werkzeuge, die Claude während des Skills ohne Rückfrage benutzen darf, zum Beispiel Read und Grep.
- paths
- Der Skill greift von selbst nur bei passenden Dateien, zum Beispiel nur in der App, nicht auf der Website.
Ein echtes Beispiel: die Skills in NativeExpress
In NativeExpress liegen sieben Skills unter .claude/skills/. Der Skill setup bringt die App vom ersten Download bis zum Laufen: Er führt ein Interview zu deiner Idee, schreibt daraus eine Produktbeschreibung und richtet dann Datenbank, Anmeldung und KI-Funktionen Schritt für Schritt ein, jeweils mit einer Prüfung. design baut das Theme aus deinen Markenfarben. conventions erklärt, wo was im Code hingehört.
Die beiden Skills für die Veröffentlichung, store-assets für die Screenshots und submit für die Einreichung bei Apple und Google, sind mit disable-model-invocation abgesichert. Claude startet sie also nie von selbst, nur wenn du sie mit Namen aufrufst. Bei allem, was nach außen geht, will ich das so. Alle sieben sind in meinem englischen Artikel zu Claude Code Skills für Handy-Apps beschrieben.
Wo finde ich fertige Skills?
Für Apps mit Expo gibt es offizielle Skills vom Expo-Team im Repository expo/skills, zum Beispiel für Navigation, SDK-Updates und die Einreichung in den Stores. In Claude Code installierst du sie mit einem Befehl: claude plugin install expo@claude-plugins-official. Das Plugin richtet auch den MCP-Server von Expo mit ein.
Fremde Skills würde ich vor dem Installieren lesen. Ein Skill ist eine Anleitung, die Claude befolgt, und er kann Skripte mitbringen, die ausgeführt werden. Installier nur, was du verstehst oder was von einer Quelle kommt, der du vertraust.
Funktionieren Claude Skills auch in Cursor und Codex?
Das Format ja. Name, Beschreibung und Anleitung sind Teil des offenen Standards, den auch Codex und Cursor lesen, allerdings aus eigenen Ordnern. Die Extras von Claude Code, etwa disable-model-invocation oder das Ausführen in einem Subagent, gelten nur dort. Mehr zum Vergleich der Tools: Cursor vs. Claude Code.
Brauche ich für Skills ein bezahltes Abo?
Für Claude Code ja, denn Claude Code ist im kostenlosen Tarif nicht enthalten. Es steckt in jedem bezahlten Tarif ab Pro. Welcher reicht, steht im Vergleich Claude Abo: Free, Pro und Max.
Der Kurs dazu, auf Deutsch
Wenn du es lieber gezeigt bekommst, als es zu lesen: einmal komplett von der Idee bis zur App auf deinem Handy, als Videokurs auf Deutsch und ohne Vorkenntnisse.
Weitere Anleitungen auf Deutsch
Zum Weiterlesen (englisch)
Wenn du mit einer Vorlage starten willst
NativeExpress kostet einmal 229 Dollar. Du bekommst den kompletten Code und jede künftige Version. Den Support mache ich selbst, per Discord oder E-Mail, gern auch auf Deutsch.