Zum Hauptinhalt springen
Diese Anleitung zeigt dir, wie du Agent Skills in Claude Code erstellst, verwendest und verwaltest. Hintergrundinformationen dazu, wie Skills in Claude-Produkten funktionieren, findest du unter Was sind Skills?. Ein Skill ist eine Markdown-Datei, die Claude beibringt, wie man etwas Bestimmtes macht: Pull Requests nach den Standards deines Teams überprüft, Commit-Nachrichten in deinem bevorzugten Format generiert oder das Datenbankschema deines Unternehmens abfragt. Wenn du Claude etwas fragst, das dem Zweck eines Skills entspricht, wendet Claude ihn automatisch an.

Erstelle deinen ersten Skill

Dieses Beispiel erstellt einen persönlichen Skill, der Claude beibringt, Code mit visuellen Diagrammen und Analogien zu erklären. Im Gegensatz zu Claudes Standarderklärungen stellt dieser Skill sicher, dass jede Erklärung ein ASCII-Diagramm und eine reale Analogie enthält.
1

Überprüfe verfügbare Skills

Bevor du einen Skill erstellst, schau dir an, auf welche Skills Claude bereits Zugriff hat:
What Skills are available?
Claude listet alle derzeit geladenen Skills auf. Du siehst möglicherweise keine oder Skills von Plugins oder deiner Organisation.
2

Erstelle das Skill-Verzeichnis

Erstelle ein Verzeichnis für den Skill in deinem persönlichen Skills-Ordner. Persönliche Skills sind über alle deine Projekte hinweg verfügbar. (Du kannst auch Projekt-Skills in .claude/skills/ erstellen, um sie mit deinem Team zu teilen.)
mkdir -p ~/.claude/skills/explaining-code
3

Schreibe SKILL.md

Jeder Skill benötigt eine SKILL.md-Datei. Die Datei beginnt mit YAML-Metadaten zwischen ----Markierungen und muss einen name und eine description enthalten, gefolgt von Markdown-Anweisungen, die Claude befolgt, wenn der Skill aktiv ist.Die description ist besonders wichtig, da Claude sie verwendet, um zu entscheiden, wann der Skill angewendet werden soll.Erstelle ~/.claude/skills/explaining-code/SKILL.md:
---
name: explaining-code
description: Explains code with visual diagrams and analogies. Use when explaining how code works, teaching about a codebase, or when the user asks "how does this work?"
---

When explaining code, always include:

1. **Start with an analogy**: Compare the code to something from everyday life
2. **Draw a diagram**: Use ASCII art to show the flow, structure, or relationships
3. **Walk through the code**: Explain step-by-step what happens
4. **Highlight a gotcha**: What's a common mistake or misconception?

Keep explanations conversational. For complex concepts, use multiple analogies.
4

Lade den Skill und überprüfe ihn

Skills werden automatisch geladen, wenn sie erstellt oder geändert werden. Überprüfe, ob der Skill in der Liste angezeigt wird:
What Skills are available?
Du solltest explaining-code in der Liste mit seiner Beschreibung sehen.
5

Teste den Skill

Öffne eine beliebige Datei in deinem Projekt und stelle Claude eine Frage, die der Beschreibung des Skills entspricht:
How does this code work?
Claude sollte fragen, ob er den explaining-code Skill verwenden darf, und dann eine Analogie und ein ASCII-Diagramm in seiner Erklärung einbeziehen. Wenn der Skill nicht ausgelöst wird, versuche, die Frage umzuformulieren und mehr Schlüsselwörter aus der Beschreibung einzubeziehen, wie „explain how this works”.
Der Rest dieser Anleitung behandelt, wie Skills funktionieren, Konfigurationsoptionen und Fehlerbehebung.

Wie Skills funktionieren

Skills sind modellgesteuert: Claude entscheidet, welche Skills verwendet werden sollen, basierend auf deiner Anfrage. Du musst einen Skill nicht explizit aufrufen. Claude wendet relevante Skills automatisch an, wenn deine Anfrage ihrer Beschreibung entspricht. Wenn du eine Anfrage sendest, folgt Claude diesen Schritten, um relevante Skills zu finden und zu verwenden:
1

Erkennung

Beim Start lädt Claude nur den Namen und die Beschreibung jedes verfügbaren Skills. Dies hält den Start schnell, während Claude genug Kontext hat, um zu wissen, wann jeder Skill relevant sein könnte.
2

Aktivierung

Wenn deine Anfrage der Beschreibung eines Skills entspricht, fragt Claude, ob er den Skill verwenden darf. Du siehst eine Bestätigungsaufforderung, bevor die vollständige SKILL.md in den Kontext geladen wird. Da Claude diese Beschreibungen liest, um relevante Skills zu finden, schreibe Beschreibungen, die Schlüsselwörter enthalten, die Benutzer natürlicherweise sagen würden.
3

Ausführung

Claude befolgt die Anweisungen des Skills und lädt referenzierte Dateien oder führt gebündelte Skripte nach Bedarf aus.

Wo Skills gespeichert werden

Der Speicherort eines Skills bestimmt, wer ihn verwenden kann:
StandortPfadGilt für
EnterpriseSiehe verwaltete EinstellungenAlle Benutzer in deiner Organisation
Persönlich~/.claude/skills/Du, über alle Projekte hinweg
Projekt.claude/skills/Jeder, der in diesem Repository arbeitet
PluginGebündelt mit PluginsJeder mit dem installierten Plugin
Wenn zwei Skills denselben Namen haben, gewinnt die höhere Zeile: verwaltet überschreibt persönlich, persönlich überschreibt Projekt, und Projekt überschreibt Plugin.

Wann Skills versus andere Optionen verwendet werden

Claude Code bietet mehrere Möglichkeiten, das Verhalten anzupassen. Der Hauptunterschied: Skills werden automatisch von Claude ausgelöst basierend auf deiner Anfrage, während Schrägstrich-Befehle erfordern, dass du /command explizit eingibst.
Verwende diesWenn du möchtest…Wenn es ausgeführt wird
SkillsClaude spezialisiertes Wissen geben (z. B. „überprüfe PRs nach unseren Standards”)Claude wählt, wenn relevant
Schrägstrich-BefehleWiederverwendbare Prompts erstellen (z. B. /deploy staging)Du gibst /command ein, um es auszuführen
CLAUDE.mdProjektweite Anweisungen festlegen (z. B. „verwende TypeScript strict mode”)Wird in jedes Gespräch geladen
SubagentenAufgaben an einen separaten Kontext mit seinen eigenen Tools delegierenClaude delegiert oder du rufst explizit auf
HooksSkripte bei Ereignissen ausführen (z. B. Lint beim Speichern von Dateien)Wird bei bestimmten Tool-Ereignissen ausgelöst
MCP-ServerVerbinde Claude mit externen Tools und DatenquellenClaude ruft MCP-Tools nach Bedarf auf
Skills versus Subagenten: Skills fügen Wissen zum aktuellen Gespräch hinzu. Subagenten laufen in einem separaten Kontext mit ihren eigenen Tools. Verwende Skills für Anleitung und Standards; verwende Subagenten, wenn du Isolation oder unterschiedlichen Tool-Zugriff benötigst. Skills versus MCP: Skills sagen Claude, wie Tools verwendet werden; MCP stellt die Tools bereit. Zum Beispiel verbindet ein MCP-Server Claude mit deiner Datenbank, während ein Skill Claude dein Datenmodell und Abfragemuster beibringt.
Für einen tieferen Einblick in die Architektur und reale Anwendungen von Agent Skills lies Equipping agents for the real world with Agent Skills.

Konfiguriere Skills

Dieser Abschnitt behandelt die Skill-Dateistruktur, unterstützende Dateien, Tool-Einschränkungen und Verteilungsoptionen.

Schreibe SKILL.md

Die SKILL.md-Datei ist die einzige erforderliche Datei in einem Skill. Sie hat zwei Teile: YAML-Metadaten (der Abschnitt zwischen ----Markierungen) oben und Markdown-Anweisungen, die Claude beibringen, wie der Skill verwendet wird:
---
name: your-skill-name
description: Brief description of what this Skill does and when to use it
---

# Your Skill Name

## Instructions
Provide clear, step-by-step guidance for Claude.

## Examples
Show concrete examples of using this Skill.

Verfügbare Metadatenfelder

Du kannst die folgenden Felder in der YAML-Präambel verwenden:
FeldErforderlichBeschreibung
nameJaSkill-Name. Muss nur Kleinbuchstaben, Zahlen und Bindestriche verwenden (max. 64 Zeichen). Sollte dem Verzeichnisnamen entsprechen.
descriptionJaWas der Skill macht und wann er verwendet werden soll (max. 1024 Zeichen). Claude verwendet dies, um zu entscheiden, wann der Skill angewendet werden soll.
allowed-toolsNeinTools, die Claude ohne Genehmigung verwenden kann, wenn dieser Skill aktiv ist. Unterstützt kommagetrennte Werte oder YAML-ähnliche Listen. Siehe Beschränke Tool-Zugriff.
modelNeinModell, das verwendet werden soll, wenn dieser Skill aktiv ist (z. B. claude-sonnet-4-20250514). Standardmäßig das Modell des Gesprächs.
contextNeinAuf fork setzen, um den Skill in einem abgespaltenen Sub-Agent-Kontext mit seiner eigenen Gesprächshistorie auszuführen.
agentNeinGeben Sie an, welcher Agent-Typ verwendet werden soll, wenn context: fork gesetzt ist (z. B. Explore, Plan, general-purpose oder ein benutzerdefinierter Agent-Name aus .claude/agents/). Standardmäßig general-purpose, wenn nicht angegeben. Nur anwendbar, wenn mit context: fork kombiniert.
hooksNeinDefiniere Hooks, die auf den Lebenszyklus dieses Skills beschränkt sind. Unterstützt PreToolUse, PostToolUse und Stop Ereignisse.
user-invocableNeinSteuert, ob der Skill im Schrägstrich-Befehlsmenü angezeigt wird. Beeinflusst nicht das Skill-Tool oder die automatische Erkennung. Standardmäßig true. Siehe Steuere Skill-Sichtbarkeit.
Siehe den Best-Practices-Leitfaden für vollständige Authoring-Anleitung einschließlich Validierungsregeln.

Aktualisiere oder lösche einen Skill

Um einen Skill zu aktualisieren, bearbeite seine SKILL.md-Datei direkt. Um einen Skill zu entfernen, lösche sein Verzeichnis. Änderungen werden sofort wirksam.

Füge unterstützende Dateien mit progressiver Offenlegung hinzu

Skills teilen Claudes Kontextfenster mit Gesprächshistorie, anderen Skills und deiner Anfrage. Um den Kontext fokussiert zu halten, verwende progressive Offenlegung: Lege wesentliche Informationen in SKILL.md und detailliertes Referenzmaterial in separaten Dateien ab, die Claude nur bei Bedarf liest. Dieser Ansatz ermöglicht es dir, umfassende Dokumentation, Beispiele und Skripte zu bündeln, ohne den Kontext im Voraus zu verbrauchen. Claude lädt zusätzliche Dateien nur, wenn die Aufgabe sie erfordert.
Halte SKILL.md unter 500 Zeilen für optimale Leistung. Wenn dein Inhalt dies überschreitet, teile detailliertes Referenzmaterial in separate Dateien auf.

Beispiel: Multi-Datei-Skill-Struktur

Claude entdeckt unterstützende Dateien durch Links in deiner SKILL.md. Das folgende Beispiel zeigt einen Skill mit detaillierter Dokumentation in separaten Dateien und Utility-Skripten, die Claude ausführen kann, ohne sie zu lesen:
my-skill/
├── SKILL.md (erforderlich - Übersicht und Navigation)
├── reference.md (detaillierte API-Dokumentation - wird bei Bedarf geladen)
├── examples.md (Verwendungsbeispiele - werden bei Bedarf geladen)
└── scripts/
    └── helper.py (Utility-Skript - wird ausgeführt, nicht geladen)
Die SKILL.md-Datei referenziert diese unterstützenden Dateien, damit Claude weiß, dass sie existieren:
## Übersicht

[Wesentliche Anweisungen hier]

## Zusätzliche Ressourcen

- Für vollständige API-Details siehe [reference.md](reference.md)
- Für Verwendungsbeispiele siehe [examples.md](examples.md)

## Utility-Skripte

Um Eingabedateien zu validieren, führe das Helper-Skript aus. Es überprüft erforderliche Felder und gibt alle Validierungsfehler zurück:
```bash
python scripts/helper.py input.txt
```
Halte Referenzen eine Ebene tief. Verlinke direkt von SKILL.md zu Referenzdateien. Tief verschachtelte Referenzen (Datei A verlinkt zu Datei B, die zu Datei C verlinkt) können dazu führen, dass Claude Dateien teilweise liest.
Bündele Utility-Skripte für ausführungsfreie Kontextausführung. Skripte in deinem Skill-Verzeichnis können ausgeführt werden, ohne ihren Inhalt in den Kontext zu laden. Claude führt das Skript aus und nur die Ausgabe verbraucht Token. Dies ist nützlich für:
  • Komplexe Validierungslogik, die in Prosa ausführlich wäre
  • Datenverarbeitung, die als getesteter Code zuverlässiger ist als generierter Code
  • Operationen, die von Konsistenz über Verwendungen hinweg profitieren
In SKILL.md sage Claude, dass er das Skript ausführen soll, anstatt es zu lesen:
Führe das Validierungsskript aus, um das Formular zu überprüfen:
python scripts/validate_form.py input.pdf
Für vollständige Anleitung zur Strukturierung von Skills siehe den Best-Practices-Leitfaden.

Beschränke Tool-Zugriff mit allowed-tools

Verwende das allowed-tools Frontmatter-Feld, um zu begrenzen, welche Tools Claude verwenden kann, wenn ein Skill aktiv ist. Du kannst Tools als kommagetrennte Zeichenkette oder YAML-Liste angeben:
---
name: reading-files-safely
description: Read files without making changes. Use when you need read-only file access.
allowed-tools: Read, Grep, Glob
---
Oder verwende YAML-ähnliche Listen für bessere Lesbarkeit:
---
name: reading-files-safely
description: Read files without making changes. Use when you need read-only file access.
allowed-tools:
  - Read
  - Grep
  - Glob
---
Wenn dieser Skill aktiv ist, kann Claude nur die angegebenen Tools (Read, Grep, Glob) verwenden, ohne Genehmigung zu benötigen. Dies ist nützlich für:
  • Schreibgeschützte Skills, die keine Dateien ändern sollten
  • Skills mit begrenztem Umfang: zum Beispiel nur Datenanalyse, kein Dateischreiben
  • Sicherheitsempfindliche Workflows, bei denen du Fähigkeiten einschränken möchtest
Wenn allowed-tools weggelassen wird, beschränkt der Skill Tools nicht. Claude verwendet sein Standardberechtigungsmodell und kann dich auffordern, Tool-Verwendung zu genehmigen.
allowed-tools wird nur für Skills in Claude Code unterstützt.

Führe Skills in einem abgespaltenen Kontext aus

Verwende context: fork, um einen Skill in einem isolierten Sub-Agent-Kontext mit seiner eigenen Gesprächshistorie auszuführen. Dies ist nützlich für Skills, die komplexe mehrstufige Operationen durchführen, ohne das Hauptgespräch zu beeinträchtigen:
---
name: code-analysis
description: Analyze code quality and generate detailed reports
context: fork
---

Definiere Hooks für Skills

Skills können Hooks definieren, die während des Lebenszyklus des Skills ausgeführt werden. Verwende das hooks-Feld, um PreToolUse, PostToolUse oder Stop Handler anzugeben:
---
name: secure-operations
description: Perform operations with additional security checks
hooks:
  PreToolUse:
    - matcher: "Bash"
      hooks:
        - type: command
          command: "./scripts/security-check.sh $TOOL_INPUT"
          once: true
---
Die once: true Option führt den Hook nur einmal pro Sitzung aus. Nach der ersten erfolgreichen Ausführung wird der Hook entfernt. Hooks, die in einem Skill definiert sind, sind auf die Ausführung dieses Skills beschränkt und werden automatisch bereinigt, wenn der Skill beendet wird. Siehe Hooks für das vollständige Hook-Konfigurationsformat.

Steuere Skill-Sichtbarkeit

Skills können auf drei Arten aufgerufen werden:
  1. Manuelle Invokation: Du gibst /skill-name in die Eingabeaufforderung ein
  2. Programmatische Invokation: Claude ruft es über das Skill-Tool auf
  3. Automatische Erkennung: Claude liest die Beschreibung des Skills und lädt ihn, wenn er für das Gespräch relevant ist
Das user-invocable Feld steuert nur die manuelle Invokation. Wenn auf false gesetzt, ist der Skill im Schrägstrich-Befehlsmenü verborgen, aber Claude kann ihn immer noch programmatisch aufrufen oder automatisch erkennen. Um die programmatische Invokation über das Skill-Tool zu blockieren, verwende stattdessen disable-model-invocation: true.

Wann jede Einstellung verwendet wird

EinstellungSchrägstrich-MenüSkill-ToolAuto-ErkennungAnwendungsfall
user-invocable: true (Standard)SichtbarErlaubtJaSkills, die Benutzer direkt aufrufen möchten
user-invocable: falseVerborgenErlaubtJaSkills, die Claude verwenden kann, aber Benutzer nicht manuell aufrufen sollten
disable-model-invocation: trueSichtbarBlockiertJaSkills, die Benutzer aufrufen möchten, aber Claude nicht programmatisch

Beispiel: Nur-Modell-Skill

Setze user-invocable: false, um einen Skill aus dem Schrägstrich-Menü zu verbergen, während du Claude weiterhin erlaubst, ihn programmatisch aufzurufen:
---
name: internal-review-standards
description: Apply internal code review standards when reviewing pull requests
user-invocable: false
---
Mit dieser Einstellung sehen Benutzer den Skill nicht im /-Menü, aber Claude kann ihn immer noch über das Skill-Tool aufrufen oder automatisch basierend auf dem Kontext erkennen.

Skills und Subagenten

Es gibt zwei Möglichkeiten, wie Skills und Subagenten zusammenarbeiten können:

Gib einem Subagenten Zugriff auf Skills

Subagenten erben Skills aus dem Hauptgespräch nicht automatisch. Um einem benutzerdefinierten Subagenten Zugriff auf bestimmte Skills zu geben, liste sie im skills-Feld des Subagenten auf:
# .claude/agents/code-reviewer.md
---
name: code-reviewer
description: Review code for quality and best practices
skills: pr-review, security-check
---
Die aufgelisteten Skills werden in den Kontext des Subagenten geladen, wenn er startet. Wenn das skills-Feld weggelassen wird, werden keine Skills für diesen Subagenten vorgeladen.
Integrierte Agenten (Explore, Plan, general-purpose) haben keinen Zugriff auf deine Skills. Nur benutzerdefinierte Subagenten, die du in .claude/agents/ mit einem expliziten skills-Feld definierst, können Skills verwenden.

Führe einen Skill in einem Subagenten-Kontext aus

Verwende context: fork und agent, um einen Skill in einem abgespaltenen Subagenten mit seinem eigenen separaten Kontext auszuführen. Siehe Führe Skills in einem abgespaltenen Kontext aus für Details.

Verteile Skills

Du kannst Skills auf mehrere Arten teilen:
  • Projekt-Skills: Committe .claude/skills/ zur Versionskontrolle. Jeder, der das Repository klont, erhält die Skills.
  • Plugins: Um Skills über mehrere Repositories zu teilen, erstelle ein skills/-Verzeichnis in deinem Plugin mit Skill-Ordnern, die SKILL.md-Dateien enthalten. Verteile über einen Plugin-Marketplace.
  • Verwaltet: Administratoren können Skills organisationsweit über verwaltete Einstellungen bereitstellen. Siehe Wo Skills gespeichert werden für verwaltete Skill-Pfade.

Beispiele

Diese Beispiele zeigen häufige Skill-Muster, von minimalen Single-File-Skills bis zu Multi-File-Skills mit unterstützender Dokumentation und Skripten.

Einfacher Skill (einzelne Datei)

Ein minimaler Skill benötigt nur eine SKILL.md-Datei mit Frontmatter und Anweisungen. Dieses Beispiel hilft Claude, Commit-Nachrichten zu generieren, indem es bereitgestellte Änderungen untersucht:
commit-helper/
└── SKILL.md
---
name: generating-commit-messages
description: Generates clear commit messages from git diffs. Use when writing commit messages or reviewing staged changes.
---

# Generating Commit Messages

## Instructions

1. Run `git diff --staged` to see changes
2. I'll suggest a commit message with:
   - Summary under 50 characters
   - Detailed description
   - Affected components

## Best practices

- Use present tense
- Explain what and why, not how

Verwende mehrere Dateien

Für komplexe Skills verwende progressive Offenlegung, um die Hauptdatei SKILL.md fokussiert zu halten, während du detaillierte Dokumentation in unterstützenden Dateien bereitstellst. Dieser PDF-Verarbeitungs-Skill enthält Referenzdokumentation, Utility-Skripte und verwendet allowed-tools, um Claude auf bestimmte Tools zu beschränken:
pdf-processing/
├── SKILL.md              # Übersicht und Schnellstart
├── FORMS.md              # Formularfeld-Zuordnungen und Füllungsanweisungen
├── REFERENCE.md          # API-Details für pypdf und pdfplumber
└── scripts/
    ├── fill_form.py      # Utility zum Ausfüllen von Formularfeldern
    └── validate.py       # Überprüft PDFs auf erforderliche Felder
SKILL.md:
---
name: pdf-processing
description: Extract text, fill forms, merge PDFs. Use when working with PDF files, forms, or document extraction. Requires pypdf and pdfplumber packages.
allowed-tools: Read, Bash(python:*)
---

# PDF Processing

## Quick start

Extract text:
```python
import pdfplumber
with pdfplumber.open("doc.pdf") as pdf:
    text = pdf.pages[0].extract_text()
```

For form filling, see [FORMS.md](FORMS.md).
For detailed API reference, see [REFERENCE.md](REFERENCE.md).

## Requirements

Packages must be installed in your environment:
```bash
pip install pypdf pdfplumber
```
Wenn dein Skill externe Pakete benötigt, liste sie in der Beschreibung auf. Pakete müssen in deiner Umgebung installiert sein, bevor Claude sie verwenden kann.

Fehlerbehebung

Zeige und teste Skills

Um zu sehen, auf welche Skills Claude Zugriff hat, stelle Claude eine Frage wie „What Skills are available?” Claude lädt alle verfügbaren Skill-Namen und Beschreibungen in das Kontextfenster, wenn ein Gespräch startet, damit es die Skills auflisten kann, auf die es derzeit Zugriff hat. Um einen bestimmten Skill zu testen, bitte Claude, eine Aufgabe auszuführen, die der Beschreibung des Skills entspricht. Zum Beispiel, wenn dein Skill die Beschreibung „Reviews pull requests for code quality” hat, bitte Claude, „Review the changes in my current branch” zu machen. Claude verwendet den Skill automatisch, wenn die Anfrage seiner Beschreibung entspricht.

Skill wird nicht ausgelöst

Das Beschreibungsfeld ist, wie Claude entscheidet, ob dein Skill verwendet werden soll. Vage Beschreibungen wie „Helps with documents” geben Claude nicht genug Informationen, um deinen Skill mit relevanten Anfragen abzugleichen. Eine gute Beschreibung beantwortet zwei Fragen:
  1. Was macht dieser Skill? Liste die spezifischen Fähigkeiten auf.
  2. Wann sollte Claude ihn verwenden? Beziehe Trigger-Begriffe ein, die Benutzer erwähnen würden.
description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
Diese Beschreibung funktioniert, weil sie spezifische Aktionen benennt (extract, fill, merge) und Schlüsselwörter enthält, die Benutzer sagen würden (PDF, forms, document extraction).

Skill wird nicht geladen

Überprüfe den Dateipfad. Skills müssen sich im richtigen Verzeichnis mit dem genauen Dateinamen SKILL.md (Groß-/Kleinschreibung beachtet) befinden:
TypPfad
Persönlich~/.claude/skills/my-skill/SKILL.md
Projekt.claude/skills/my-skill/SKILL.md
EnterpriseSiehe Wo Skills gespeichert werden für plattformspezifische Pfade
Pluginskills/my-skill/SKILL.md im Plugin-Verzeichnis
Überprüfe die YAML-Syntax. Ungültiges YAML in der Präambel verhindert, dass der Skill geladen wird. Die Präambel muss mit --- auf Zeile 1 beginnen (keine Leerzeilen davor), mit --- vor dem Markdown-Inhalt enden und Leerzeichen zur Einrückung verwenden (keine Tabulatoren). Führe den Debug-Modus aus. Verwende claude --debug, um Skill-Ladefehler zu sehen.

Skill hat Fehler

Überprüfe, dass Abhängigkeiten installiert sind. Wenn dein Skill externe Pakete verwendet, müssen sie in deiner Umgebung installiert sein, bevor Claude sie verwenden kann. Überprüfe Skript-Berechtigungen. Skripte benötigen Ausführungsberechtigungen: chmod +x scripts/*.py Überprüfe Dateipfade. Verwende Schrägstriche (Unix-Stil) in allen Pfaden. Verwende scripts/helper.py, nicht scripts\helper.py.

Mehrere Skills in Konflikt

Wenn Claude den falschen Skill verwendet oder zwischen ähnlichen Skills verwirrt zu sein scheint, sind die Beschreibungen wahrscheinlich zu ähnlich. Mache jede Beschreibung unterschiedlich, indem du spezifische Trigger-Begriffe verwendest. Zum Beispiel, anstatt zwei Skills mit „data analysis” in beiden Beschreibungen zu haben, unterscheide sie: eine für „sales data in Excel files and CRM exports” und eine andere für „log files and system metrics”. Je spezifischer deine Trigger-Begriffe sind, desto einfacher ist es für Claude, den richtigen Skill mit deiner Anfrage abzugleichen.

Plugin-Skills werden nicht angezeigt

Symptom: Du hast ein Plugin von einem Marketplace installiert, aber seine Skills werden nicht angezeigt, wenn du Claude fragst „What Skills are available?” Lösung: Leere den Plugin-Cache und installiere neu:
rm -rf ~/.claude/plugins/cache
Starte dann Claude Code neu und installiere das Plugin neu:
/plugin install plugin-name@marketplace-name
Dies zwingt Claude Code, das Plugin neu herunterzuladen und die Skills des Plugins neu zu registrieren. Wenn Skills immer noch nicht angezeigt werden, überprüfe, dass die Verzeichnisstruktur des Plugins korrekt ist. Skills müssen sich in einem skills/-Verzeichnis an der Plugin-Wurzel befinden:
my-plugin/
├── .claude-plugin/
│   └── plugin.json
└── skills/
    └── my-skill/
        └── SKILL.md

Nächste Schritte