Claude Code Skills: Wie man sie einrichtet und verwendet

Claude einmal beibringen, jedes Mal verwenden.

Lesezeit: 10 Minuten | Schwierigkeitsgrad: Anfängerfreundlich

Wahrscheinlich haben Sie Claude immer wieder dieselben Anweisungen gegeben: „Verwende unseren Styleguide“, „Führe immer Tests durch, bevor du etwas festschreibst“, „Formatier die Ausgabe so“. Skills beheben dieses Problem. Ein Skill ist ein kleiner Ordner mit Anweisungen, der Claude beibringt, wie er bestimmte Aufgaben oder Arbeitsabläufe handhabt, sodass Sie diese nicht jedes Mal neu erklären müssen. Dieser Leitfaden führt Sie durch die Grundlagen, die Einrichtung und die Verwendung von Skills – basierend auf dem offiziellen Complete Guide to Building Skills for Claude (Vollständiger Leitfaden zum Erstellen von Skills für Claude).

📁 Was sind Claude-Skills?

Ein Skill ist ein Ordner, der Folgendes enthält:

• SKILL.md (erforderlich) – Anweisungen in Markdown mit YAML-Frontmatter, die Claude mitteilen, wann er den Skill einsetzen und was er tun soll.
• scripts/ (optional) – Ausführbarer Code (Python, Bash usw.), den der Skill aufrufen kann.
• references/ (optional) – Zusätzliche Dokumente, die Claude nur bei Bedarf öffnen kann.
• assets/ (optional) – Vorlagen, Schriftarten oder Bilder, die im Workflow verwendet werden.

Skills funktionieren gut, wenn Sie wiederholbare Workflows haben: Spezifikationen in Frontend-Designs umwandeln, Recherchen mit einer konsistenten Methode durchführen oder Dokumente erstellen, die dem Stil Ihres Teams entsprechen. Sie lassen sich auch gut mit MCP (Model Context Protocol) kombinieren: MCP ermöglicht Claude den Zugriff auf Tools und Daten; Skills zeigen Claude, wie er diese am besten nutzt.

Dreistufiges Design: Progressive Offenlegung

Skills verwenden ein einfaches dreistufiges System, damit Claude schnell und fokussiert bleibt:

Auf diese Weise lädt Claude nicht jedes Wort jedes Skills, sondern nur das, was für die aktuelle Aufgabe benötigt wird.

⚙️ So richten Sie einen Skill ein (Struktur und Frontmatter)

Regeln für Ordner und Dateien

• Ordnername: Verwenden Sie nur Kebab-Case. Beispiele: notion-project-setup ✅ – nicht Notion Project Setup ❌ oder notion_project_setup ❌.
• Hauptdatei: Muss genau SKILL.md heißen (Groß-/Kleinschreibung beachten). Nicht skill.md oder SKILL.MD.
• Keine README.md im Skill-Ordner. Alle Anweisungen müssen in SKILL.md oder unter references/ stehen.

YAML-Frontmatter: Der wichtigste Teil

Anhand der Frontmatter entscheidet Claude, ob Ihr Skill geladen wird. Sie befindet sich oben in SKILL.md zwischen den Zeilen ---.

Mindestanforderungen:

 Copy
---
name: your-skill-name
description: Was es tut. Verwenden Sie es, wenn der Benutzer nach [bestimmten Phrasen] fragt.
---

• name — Kebab-Case, keine Leerzeichen oder Großbuchstaben. Sollte mit dem Ordnernamen übereinstimmen.
• description — Muss beides enthalten:
  • Was der Skill tut.
  • Wann er verwendet werden soll (Auslöserphrasen oder Situationen).

Die Beschreibung sollte weniger als 1024 Zeichen umfassen. Verwenden Sie keine XML-Spitzenklammern (< oder >); diese sind aus Sicherheitsgründen nicht zulässig.

Gutes Beispiel für eine Beschreibung:

Analysiert Figma-Designdateien und generiert Übergabedokumentationen für Entwickler. Verwenden Sie diese Funktion, wenn der Benutzer .fig-Dateien hochlädt und nach „Designspezifikationen”, „Komponentendokumentation” oder „Design-to-Code-Übergabe” fragt.

Schlecht: „Hilft bei Projekten.” (Zu vage, keine Auslöser.)

Optionale Frontmatter: license, compatibility, metadata (z. B. author, version, mcp-server). Die vollständige Liste finden Sie im offiziellen Leitfaden.

✍️ Anweisungen schreiben, die funktionieren

Schreiben Sie nach der Frontmatter die eigentlichen Anweisungen in Markdown.

Bewährte Verfahren:

• Seien Sie konkret und umsetzbar. Verwenden Sie lieber „Führen Sie python scripts/validate.py --input {Dateiname} aus“ als „Validieren Sie die Daten, bevor Sie fortfahren“.
• Fügen Sie eine Fehlerbehandlung hinzu. Fügen Sie einen Abschnitt „Häufige Probleme” oder „Fehlerbehebung” hinzu (z. B. „Wenn die Meldung ‚Verbindung abgelehnt' angezeigt wird, überprüfen Sie unter Einstellungen > Erweiterungen, ob der MCP-Server ausgeführt wird”).
• Verweisen Sie klar auf gebündelte Ressourcen. Z. B. „Bevor Sie Abfragen schreiben, konsultieren Sie references/api-patterns.md für Ratenbegrenzung und Paginierung.”
• Verwenden Sie progressive Offenlegung. Halten Sie SKILL.md fokussiert; verschieben Sie langes Referenzmaterial in references/ und verlinken Sie darauf.

Für kritische Überprüfungen sollten Sie ein kleines Skript zur Validierung hinzufügen. Code ist deterministisch, während Anweisungen in natürlicher Sprache unterschiedlich interpretiert werden können. Die offiziellen Office-bezogenen Skills verwenden dieses Muster.

📍 Verwendung von Skills: Wo sie sich befinden und wie sie geladen werden

Wo Skills platziert werden sollten

Wie Claude sie lädt

• Automatisch – Claude liest die description (und andere Frontmatter) und lädt den Skill, wenn die Anfrage des Benutzers übereinstimmt.
• Slash-Befehle – In unterstützten Umgebungen können Sie sie manuell aufrufen, z. B. /your-skill-name.

Aktivieren in Claude.ai

1. Gehen Sie zu Settings → Capabilities.
2. Aktivieren Sie Code execution und File creation, wenn Ihr Skill diese verwendet.
3. Verwenden Sie Upload skill und wählen Sie Ihren Skill-Ordner aus (bei Bedarf als ZIP).
4. Aktivieren Sie den Skill.

Skills folgen dem offenen Standard Agent Skills, sodass derselbe Skill in Claude.ai, Claude Code und der API (sofern unterstützt) verwendet werden kann.

🧪 Testen und Iterieren

Überprüfen Sie Ihren Skill vor und nach dem Hochladen:

Auslösen:

• ✅ Wird bei offensichtlichen Anfragen geladen (z. B. „Hilf mir beim Einrichten eines neuen ProjectHub-Arbeitsbereichs”).
• ✅ Wird bei umschriebenen Anfragen geladen („Ich muss ein Projekt in ProjectHub erstellen”).
• ❌ Wird nicht bei nicht verwandten Themen geladen („Wie ist das Wetter?”).

Ausführung:

• Führen Sie den Workflow aus und überprüfen Sie, ob die Ausgaben und Tool-Aufrufe korrekt sind.
• Wenn Sie MCP verwenden, überprüfen Sie, ob der Skill die richtigen Tools in der richtigen Reihenfolge verwendet.

Verwendung des Skill-Creators:

• In Claude.ai (oder Claude Code, falls verfügbar) können Sie sagen: „Verwende den Skill-Creator, um mir bei der Erstellung eines Skills für [Ihren Anwendungsfall] zu helfen.” Der Skill-Creator hilft bei der Generierung von Frontmatter, schlägt Triggerphrasen vor und überprüft die Struktur. Er führt keine automatisierten Testsuiten aus, ist aber nützlich für das Design und die Verfeinerung.

Wenn der Skill zu selten ausgelöst wird: Fügen Sie der Beschreibung konkretere Auslösephrasen und Schlüsselwörter hinzu. Wenn er zu oft ausgelöst wird: Schränken Sie die Beschreibung ein oder fügen Sie negative Auslöser hinzu (z. B. „NICHT für einfache Datenerkundung verwenden”).

🎯 Wann sollten Sie Skills verwenden und wann „nur Prompt”?

Skills sind besonders nützlich, wenn:

• Sie über wiederholbare Arbeitsabläufe verfügen (Sprint-Planung, Design-Übergabe, Berichterstellung).
• Sie eine gleichbleibende Qualität wünschen (Styleguides, Checklisten, Vorlagen).
• Sie MCP + Skills (Tools + Rezepte) kombinieren: MCP ermöglicht den Zugriff, Skills liefern die Methodik.

Wenn Sie benutzerdefinierte Agenten, Produktionssysteme oder eine Multi-Agenten-Architektur benötigen, sind Skills ein Baustein – aber möglicherweise benötigen Sie auch ein geeignetes Agentendesign und eine Validierung. Wenn Sie prüfen möchten, ob ein agentenbasiertes KI-Konzept für Ihr Produkt realisierbar ist, kann Ihnen unsere Agentic AI Feasibility Assessment dabei helfen, die Idee zu validieren, eine Architektur auszuwählen und die Tool-Integration zu planen, bevor Sie mit der Entwicklung beginnen.

🔜 Fazit und nächste Schritte

Zusammenfassung: Skills sind wiederverwendbare Befehlssätze, die Claude beibringen, wann und wie bestimmte Aufgaben auszuführen sind. Achten Sie auf den richtigen Ordnernamen (Kebab-Case), SKILL.md und Frontmatter (insbesondere name und description) und halten Sie die Hauptanweisungen klar und umsetzbar. Verwenden Sie den Skill-Creator, um Entwürfe zu erstellen und zu verfeinern und sowohl die Auslösung als auch die Ausführung zu testen.

Nächste Schritte:

• Probieren Sie einen kleinen Skill aus (z. B. „Formatieren Sie meine Besprechungsnotizen als Aufzählungspunkte”) und wiederholen Sie den Vorgang.
• Lesen Sie den vollständigen Leitfaden zum Erstellen von Skills für Claude.
• Wenn Sie agentenbasierte Workflows in großem Maßstab erstellen, sollten Sie eine Agentic AI Feasibility Assessment in Betracht ziehen, um Skills und Tools an Ihren Produktzielen auszurichten.

Zuletzt aktualisiert: Februar 2026