Claude mit Skills erweitern

Gebündelte Skills

Überprüfen Sie Ihre Einrichtung mit /doctor

• Zustand der Installation: doppelte oder übrig gebliebene Installationen, PATH-Probleme, nicht parsebare Einstellungsdateien und ob auf Ihrem Release-Kanal eine neuere Version verfügbar ist
• Erweiterungen: nicht genutzte Skills, MCP-Server und Plugins im Vergleich zu ihren Kontextkosten sowie langsame Hooks
• CLAUDE.md-Dateien: lokale CLAUDE.md-Dateien, die eingecheckte Dateien duplizieren, eingecheckte CLAUDE.md-Inhalte, die Claude aus der Codebasis ableiten könnte, sowie die verbleibenden, stets geladenen Anweisungen, die Claude in Skills und verschachtelte CLAUDE.md-Dateien zu migrieren anbietet, die bei Bedarf geladen werden
• Berechtigungen: ein Angebot, den Auto-Modus zu Ihrem Standard-Berechtigungsmodus zu machen und nur lesende Befehle, die Sie häufig ablehnen, vorab zu genehmigen
• Nutzung: bei einem Pro-, Max-, Ultra-, Team- oder Enterprise-Plan die Änderungen, die /usage empfiehlt, um Ihre Plan-Nutzung zu senken, gemessen über die letzten 7 Tage. Claude schlägt die Änderungen vor, die es selbst vornehmen kann, und meldet den Rest als Hinweis, etwa einen Befehl, den Sie ausführen sollen. Die Nutzungsprüfung erfordert Claude Code v2.1.305 oder später, und /doctor lässt sie aus, solange Remote Control verbunden ist.

Führen Sie Ihre App aus und überprüfen Sie sie

Führen Sie Ihre Prüfungen vor jedem Commit aus

• Speicherort: Der Skill wird aus dem Enterprise-, persönlichen, Projekt- oder zusätzlichen Verzeichnis-Speicherort geladen oder aus einer .claude/commands/-Datei mit diesem Namen. Das Rezept, das /verify in Ihrem Repository-Root aufzeichnet, ist ein Projekt-Skill und zählt daher. Die mitgelieferten Skills /verify und /simplify, Plugin-Skills und Skills aus Ihrem claude.ai-Konto zählen nicht.
• Aufruf: Claude kann den Skill aufrufen. Wenn Sie Claude daran gehindert haben, ihn aufzurufen, zum Beispiel mit disable-model-invocation: true, erhält Claude die Anweisung nicht.
• Git-Anweisungen: Sie haben includeGitInstructions nicht ausgeschaltet. Wenn Sie es ausschalten, wird diese Anweisung zusammen mit den übrigen integrierten Commit- und PR-Anweisungen entfernt.

Arbeiten Sie an Claude API-Projekten

Erste Schritte

Erstellen Sie Ihre erste Skill

mkdir -p ~/.claude/skills/summarize-changes

---
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

## Current changes

!`git diff HEAD`

## Instructions

Summarize the changes above in two or three bullet points, then list any risks you notice such as missing error handling, hardcoded values, or tests that need updating. If the diff is empty, say there are no uncommitted changes.

What did I change?

/summarize-changes

Wählen Sie, wo Skills geladen werden

• Symverlinkte Ordner: Ein <skill-name>-Eintrag am Enterprise-, Personal- oder Projekt-Speicherort kann ein Symlink zu einem Verzeichnis an anderer Stelle auf der Festplatte sein. Claude Code liest SKILL.md aus dem Ziel und lädt den Skill einmal, auch wenn mehrere Speicherorte auf dasselbe Ziel verweisen. Plugin-Skills handhaben Symlinks anders.
• Reservierter Name synced: Benennen Sie einen Skill-Ordner nicht synced, in keiner Schreibweise. Claude Code verwendet ~/.claude/skills/synced/ für Skills, die von claude.ai heruntergeladen werden und überspringt einen Skill, den Sie unter diesem Namen am Enterprise-, Personal- und Projekt-Speicherort erstellen.
• Reservierter Name anthropic-skills: Außerhalb eines Plugins wird ein Skill-Ordner oder eine Befehlsdatei mit dem Namen anthropic-skills oder einem Namen, der mit anthropic-skills: beginnt, nicht geladen. Siehe Namen, die für synchronisierte Skills reserviert sind.
• Zeichen im Namen: Außerhalb eines Plugins wird ein Skill-Ordner nicht geladen, wenn sein Name ein Zeichen wie ein Leerzeichen mit Nullbreite oder < enthält. Siehe Zeichen, die ein Skill-Name nicht enthalten kann.
• Befehlsdateien: Eine Markdown-Datei in .claude/commands/ ist das ältere Format und funktioniert immer noch. Sie unterstützt dieselbe Frontmatter außer name und paths. Um den Namen zu finden, den Sie eingeben, um ihn aufzurufen, siehe Wie ein Skill seinen Befehlsnamen erhält. Bevorzugen Sie einen Skill für neue Arbeiten, da Skills auch unterstützende Dateien unterstützen.
• Skill-Ordner als Plugin: Fügen Sie einem persönlichen oder Projekt-Skill-Ordner eine .claude-plugin/plugin.json hinzu, dann kann Claude Code ihn als Plugin mit dem Namen <name>@skills-dir mit eigenen Agenten, Hooks und MCP-Servern laden. In .claude/skills/ eines Projekts müssen Sie dafür zuerst den Workspace-Trust-Dialog akzeptieren, und an beiden Speicherorten setzt dies voraus, dass Ihr Administrator Plugins aus Skill-Verzeichnissen nicht blockiert hat.

Skills in Monorepos und Unterverzeichnissen laden

• /deploy führt den Root-Skill aus. Claude Code listet auch die verzeichnisqualifizierten Varianten für Claude auf, mit einer Anweisung, denjenigen aufzurufen, dessen Verzeichnis die Dateien enthält, an denen es arbeitet, sodass der verschachtelte Skill immer noch auf Arbeiten in apps/web/ angewendet wird.
• /apps/web:deploy führt den verschachtelten Skill eigenständig aus. Seine Beschreibung benennt das Verzeichnis, auf das es angewendet wird.

Skills aus einem Verzeichnis außerhalb des Projekts laden

Einen gleichnamigen Skill aus einem hinzugefügten Verzeichnis ausführen

• /verify führt den Skill Ihres Projekts aus
• /cli:verify führt den Skill aus ../cli aus

Skills auflösen, die denselben Namen haben

Skills in Cowork- und Cloud-Sitzungen verwenden

• Für Cowork-Sitzungen, Cloud-Sitzungen und Cloud-Threads in einem Projekt aktivieren Sie den Skill für Ihr claude.ai-Konto. In einem Cloud-Thread eines Projekts sind Skills, die in .claude/skills/ eines Repositorys committet sind, nicht verfügbar. Einige Sitzungen in einer selbst gehosteten Umgebung laden die Skills Ihres Kontos nicht.
• Für Cloud-Sitzungen außer Projekt-Threads können Sie den Skill stattdessen in .claude/skills/ des Repositorys committen. Plugins, die in .claude/settings.json des Repositorys deklariert sind, und Plugins, die nur in Ihren Benutzereinstellungen aktiviert sind, werden nicht in Cloud-Sitzungen geladen.

Skills, die von claude.ai synchronisiert werden

Wo synchronisierte Skills geladen werden

• Während Sie oder Claude in der Sitzung arbeiten: Etwa alle 10 Minuten wird eine Prüfung ausgeführt.
• Während die Sitzung inaktiv ist: Etwa alle 40 Minuten wird eine Prüfung ausgeführt. Wenn Sie wieder in der Sitzung tippen, prüft Claude Code innerhalb weniger Minuten, sofern die letzte Prüfung mehr als 10 Minuten zurückliegt.

• Eine Sitzung, die keine Anmeldung verwendet, die von /login gespeichert wurde, wie eine, die sich mit einem API-Schlüssel authentifiziert, oder eine, bei der ANTHROPIC_AUTH_TOKEN, CLAUDE_CODE_OAUTH_TOKEN oder ein apiKeyHelper-Skript die Anmeldedaten bereitstellt
• Eine Sitzung, die keine Feature-Flags abruft, wie eine auf Amazon Bedrock oder eine, bei der Sie CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC setzen
• Eine Sitzung in Bare Mode oder eine, die Sie mit --safe-mode starten
• Eine Sitzung, bei der die verwalteten Einstellungen Ihrer Organisation Skills auf Plugin-Quellen sperren, oder eine, die Sie mit einer --setting-sources-Liste starten, die user auslässt

Wenn ein synchronisierter Skill-Name mit einem anderen Befehl übereinstimmt

• Ein integrierter Befehl oder ein gebündelter Skill, einschließlich eines, der in Ihrer Sitzung nicht verfügbar ist, zum Beispiel nachdem Sie gebündelte Skills ausschalten
• Ein Skill auf einer beliebigen lokalen Ebene oder eine Datei in .claude/commands/
• Ein Plugin-Skill
• Eine MCP-Eingabeaufforderung

Namen, die für synchronisierte Skills reserviert sind

• Ein Skill-Ordner, eine Frontmatter name, eine Datei oder ein Unterordner in .claude/commands/ oder ein gespeicherter Workflow: er wird nicht geladen. Eine Startup-Benachrichtigung benennt das erste Element zum Umbenennen oder Bearbeiten.
• Ein Plugin mit dem Namen anthropic-skills: es wird geladen. Wenn einer seiner Skills und ein synchronisierter Skill beide <name> genannt werden, führt /anthropic-skills:<name> den synchronisierten Skill aus.
• Ein MCP-Server mit dem Namen anthropic-skills: er verbindet sich und seine Tools funktionieren, aber seine Eingabeaufforderungen erscheinen nicht als Befehle. Benennen Sie den Server in Ihrer MCP-Konfiguration um, um sie aufzulisten.

Wie Claude Code die Frontmatter eines synchronisierten Skills handhabt

• Das Frontmatter gilt in jeder Art von Sitzung, daher durchläuft eine allowed-tools-Gewährung den normalen Berechtigungsfluss. Wenn Ihre Organisation allowManagedPermissionRulesOnly setzt, gilt die Gewährung nicht.
• Claude Code bereinigt den Anzeigetext, den der Skill bereitstellt, wie seine Beschreibung. Es entfernt Steuerzeichen, und in Text, der Claude erreicht, wie die Beschreibung, maskiert es auch spitzklammern, damit der Text Claude Code’s interne Formatierung nicht imitieren kann. Diese Bereinigung erfordert Claude Code v2.1.228 oder später.

Wie Claude Code den Body eines synchronisierten Skills handhabt

• In einer Cloud-Sitzung behält der Body das Verhalten, das ein lokaler Skill hat, da die Sitzung in einem isolierten Container läuft.
• In einer Cowork-Sitzung auf Ihrem Desktop behält der Body das Verhalten, das ein lokaler Skill hat, außer dass Claude Code jede !-Befehlszeile durch den disableSkillShellExecution-Platzhalter ersetzt, wie es für jeden Skill tut, den Sie dort bereitstellen.
• In jeder anderen Sitzung auf Ihrer Maschine führt Claude Code keine !-Befehle aus, hängt nicht die Dateien an, die @-Referenzen benennen, wie es für einen lokalen Skill tut, und ersetzt nicht die Platzhalter ${CLAUDE_PROJECT_DIR} und ${CLAUDE_SESSION_ID}, daher erreichen die @-Referenzen und beide Platzhalter Claude als wörtlicher Text. Eine !-Befehlszeile erreicht Claude auch als wörtlicher Text oder als dieser Platzhalter, wenn disableSkillShellExecution aktiviert ist. Diese Handhabung erfordert Claude Code v2.1.228 oder später.

Einen Skill während einer Sitzung bearbeiten

Einen Skill entfernen

• Persönlicher oder Projekt-Skill: Löschen Sie das Verzeichnis des Skills, ~/.claude/skills/<skill-name>/ oder .claude/skills/<skill-name>/. Claude Code entfernt ihn aus /skills in der aktuellen Sitzung; Inhalte, die Claude Code bereits daraus geladen hat, folgen dem Skill-Content-Lebenszyklus.
• Enterprise-Skill: Ein Administrator löscht das Verzeichnis des Skills aus .claude/skills/ im Verzeichnis für verwaltete Einstellungen, zum Beispiel /etc/claude-code/.claude/skills/<skill-name>/ auf Linux.
• Plugin-Skill: Deaktivieren oder deinstallieren Sie das Plugin, das ihn bereitstellt, aus dem /plugin-Menü oder mit /plugin uninstall <plugin-name>@<marketplace-name>. Claude Code entlädt die Skills des Plugins, wenn die Änderung angewendet wird oder wenn Sie neu starten.
• Skill, der von claude.ai synchronisiert wird: Schalten Sie den Skill für Ihr claude.ai-Konto aus, an derselben Stelle, an der Sie ihn aktiviert haben. Claude Code entfernt ihn aus ~/.claude/skills/synced/ beim nächsten Mal, wenn es Ihre Skills synchronisiert. Wenn Sie das Verzeichnis stattdessen von Hand löschen, lädt die nächste Synchronisierung es erneut herunter, während der Skill auf claude.ai aktiviert bleibt.
• Gebündelter Skill: Setzen Sie disableBundledSkills auf true, um gebündelte Skills auszuschalten, oder setzen Sie einen Skill auf "off" in skillOverrides, um ihn auszublenden.

Fähigkeiten konfigurieren

Arten von Fähigkeitsinhalten

---
name: api-conventions
description: API design patterns for this codebase
---

When writing API endpoints:
- Use RESTful naming conventions
- Return consistent error formats
- Include request validation

---
name: deploy
description: Deploy the application to production
context: fork
disable-model-invocation: true
---

Deploy the application:
1. Run the test suite
2. Build the application
3. Push to the deployment target

Frontmatter-Referenz

---
name: my-skill
description: What this skill does
disable-model-invocation: true
allowed-tools: Read Grep
---

Your skill instructions here...

Fähigkeits-Frontmatter außerhalb von Claude Code verwenden

Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, name

Wie eine Fähigkeit ihren Befehlsnamen erhält

Zeichen, die ein Skill-Name nicht enthalten darf

• Ein Leerzeichen mit Nullbreite oder ein Steuerzeichen
• Ein Zeichen aus dem privaten Nutzungsbereich oder ein nicht zugewiesenes Zeichen, z. B. ein Glyph aus einer Icon-Schriftart
• Ein Zeichen, das die Richtung des umgebenden Textes ändert
• Ein Leerraum, der kein einzelnes normales Leerzeichen zwischen Wörtern ist, z. B. ein geschütztes Leerzeichen, zwei Leerzeichen hintereinander oder ein Leerzeichen am Anfang oder Ende
• < oder >

• Ordner im skills/-Verzeichnis eines Plugins oder in den skills-Pfaden seines Manifests: Sie müssen den Ordner nicht umbenennen. Diese Zeichen werden im Befehlsnamen des Skills zu Bindestrichen, geben Sie den Befehl also mit den Bindestrichen ein.
• Frontmatter name: Das /-Menü zeigt den name-Wert nicht an, und die Eingabe dieses Werts ruft den Skill nicht auf. Bearbeiten Sie die Zeile name:, um die Zeichen zu entfernen.

Verfügbare Zeichenkettensubstitutionen

---
name: render-chart
description: Render a chart from a CSV file
allowed-tools: Bash(${CLAUDE_SKILL_DIR}/scripts/render.sh *)
---

Run `${CLAUDE_SKILL_DIR}/scripts/render.sh <csv-file>` to render the chart.

---
name: session-logger
description: Log activity for this session
---

Log the following to logs/${CLAUDE_SESSION_ID}.log:

$ARGUMENTS

Unterstützende Dateien hinzufügen

my-skill/
├── SKILL.md (required - overview and navigation)
├── reference.md (detailed API docs - loaded when needed)
├── examples.md (usage examples - loaded when needed)
└── scripts/
    └── helper.py (utility script - executed, not loaded)

## Additional resources

- For complete API details, see [reference.md](reference.md)
- For usage examples, see [examples.md](examples.md)

Kontrollieren Sie, wer eine Fähigkeit aufruft

• disable-model-invocation: true: Claude kann den Skill nicht von sich aus aufrufen. Verwenden Sie dies für Workflows mit Nebenwirkungen oder solche, deren Zeitpunkt Sie selbst steuern möchten, wie /commit, /deploy oder /send-slack-message. Sie möchten nicht, dass Claude entscheidet zu deployen, weil Ihr Code fertig aussieht.
• user-invocable: false: Nur Claude kann die Fähigkeit aufrufen. Verwenden Sie dies für Hintergrundwissen, das nicht als Befehl umsetzbar ist. Eine legacy-system-context-Fähigkeit erklärt, wie ein altes System funktioniert. Claude sollte dies kennen, wenn relevant, aber /legacy-system-context ist keine aussagekräftige Aktion für Benutzer.

---
name: deploy
description: Deploy the application to production
disable-model-invocation: true
---

Deploy $ARGUMENTS to production:

1. Run the test suite
2. Build the application
3. Push to the deployment target
4. Verify the deployment succeeded

Wo Sie den Namen des Skills schreiben

Fähigkeitsinhalts-Lebenszyklus

Tools für eine Fähigkeit vorab genehmigen

---
name: commit
description: Stage and commit the current changes
disable-model-invocation: true
allowed-tools: Bash(git add *) Bash(git commit *) Bash(git status *)
---

Wenn verwaltete Einstellungen Hooks auf Plugins beschränken

• Prüfen: Geben Sie /status in einer Claude Code-Sitzung ein. Wenn /status Enterprise managed settings anzeigt, fragen Sie Ihren Administrator, ob strictPluginOnlyCustomization hooks aufführt.
• Beheben: Entfernen Sie hooks aus dem Frontmatter des Skills, da seine Hooks unter dieser Einstellung nicht ausgeführt werden. Um sie beizubehalten, verschieben Sie den Skill in ein Plugin, das Sie aus einem Marketplace installieren.

Wenn nur verwaltete Berechtigungsregeln gelten

Argumente an Fähigkeiten übergeben

---
name: fix-issue
description: Fix a GitHub issue
disable-model-invocation: true
---

Fix GitHub issue $ARGUMENTS following our coding standards.

1. Read the issue description
2. Understand the requirements
3. Implement the fix
4. Write tests
5. Create a commit

---
name: migrate-component
description: Migrate a component from one language to another
---

Migrate the $ARGUMENTS[0] component from $ARGUMENTS[1] to $ARGUMENTS[2].
Preserve all existing behavior and tests.

---
name: migrate-component
description: Migrate a component from one language to another
---

Migrate the $0 component from $1 to $2.
Preserve all existing behavior and tests.

Mehrere Skills in einer Nachricht stapeln

Fortgeschrittene Muster

Dynamischen Kontext einfügen

---
name: pr-summary
description: Summarize changes in a pull request
context: fork
agent: Explore
allowed-tools: Bash(gh *)
---

## Pull request context
- PR diff: !`gh pr diff`
- PR comments: !`gh pr view --comments`
- Changed files: !`gh pr diff --name-only`

## Your task
Summarize this pull request...

## Environment
```!
node --version
git status --short
```

Wie eingefügte Befehle ausgeführt werden

• shell: powershell, bei aktiviertem PowerShell-Tool: Die Befehle werden über das PowerShell-Tool ausgeführt.
• shell: bash, wenn bash nicht verfügbar ist: Der Aufruf schlägt fehl, bevor ein Befehl ausgeführt wird. Das passiert unter Windows ohne Git Bash. Claude Code zeigt Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found an.
• Jede andere Kombination: Die Befehle werden über das Bash-Tool ausgeführt, wenn bash verfügbar ist. Andernfalls werden sie über das PowerShell-Tool ausgeführt.

• Arbeitsverzeichnis: Claude Code führt jeden Befehl im aktuellen Arbeitsverzeichnis der Sitzungs-Shell aus. Dieses Verzeichnis ändert sich, wenn Claude cd ausführt. Verwenden Sie ${CLAUDE_SKILL_DIR} oder ${CLAUDE_PROJECT_DIR} in Pfaden, die jedes Mal gleich aufgelöst werden müssen.
• stderr: Bei der Standard-Shell bash führt Claude Code stderr mit stdout zusammen. Alles, was der Befehl nach stderr schreibt, erscheint im eingefügten Text.
• Timeout: Jeder Befehl läuft unter dem standardmäßigen 2-Minuten-Timeout des Bash-Tools. Wenn das Bash-Tool einen Befehl mit Zeitüberschreitung in den Hintergrund verschiebt, wird der Skill trotzdem gerendert. Der eingefügte Text meldet die Verschiebung und nennt die Hintergrundaufgabe sowie die Datei, in der die Ausgabe des Befehls gesammelt wird. Handelt es sich um einen Befehl, den das Bash-Tool nie automatisch in den Hintergrund verschiebt, beendet Claude Code ihn beim Timeout. Dieser Fehler bricht den Aufruf ab.
• Ausgabegröße: Ausgabe jenseits der Inline-Obergrenze des Bash-Tools kommt als Dateipfad plus kurze Vorschau an, nicht als gekürzter Text. Ausgabelimits beschreibt die Obergrenze und wie Sie jede Grenze anpassen.

Wenn ein eingefügter Befehl fehlschlägt

• Standard-Shell bash: die unter Ausgabelimits aufgeführten Befehle
• shell: powershell, wenn das PowerShell-Tool aktiviert ist: eine andere Menge, die grep und git diff enthält, aber nicht find oder diff

Wenn kein Shell-Befehl ausgeführt wurde

Berechtigungsprüfungen bei eingefügten Befehlen

Skills in einem Subagenten ausführen

• Im nicht interaktiven Modus, mit dem Flag -p oder dem Agent SDK
• Wenn Sie CLAUDE_CODE_DISABLE_BACKGROUND_TASKS auf 1 setzen, wodurch auch andere Funktionen für Hintergrundaufgaben deaktiviert werden
• Wenn Sie einen geforkten Skill aufrufen, während ein früherer Aufruf desselben Skills noch läuft
• Wenn eine sitzungsbezogene geplante Aufgabe mit dem Skill als Prompt ausgelöst wird

Beispiel: Recherche-Skill mit dem Explore-Agenten

---
name: deep-research
description: Research a topic thoroughly
context: fork
agent: Explore
---

Research $ARGUMENTS thoroughly:

1. Find relevant files using Glob and Grep
2. Read and analyze the code
3. Summarize findings with specific file references

1. Ein neuer isolierter Kontext wird erstellt
2. Der Subagent erhält den Skill-Inhalt als Prompt (die Anweisungen „Research $ARGUMENTS thoroughly“)
3. Das Feld agent bestimmt die Ausführungsumgebung (Modell, Tools und Berechtigungen)
4. Der Subagent fasst seine Ergebnisse zusammen und gibt sie an Ihre Hauptkonversation zurück, wenn er fertig ist

Claudes Zugriff auf Skills einschränken

# Add to deny rules:
Skill

# Allow only specific skills
Skill(commit)
Skill(review-pr *)

# Deny specific skills
Skill(deploy *)

• Skill(anthropic-skills:pdf) genehmigt den synchronisierten Skill pdf
• Skill(anthropic-skills *) genehmigt jeden synchronisierten Skill
• Skill(anthropic *) deckt anthropic-skills:pdf nicht ab, da ein Präfix außerhalb des Namensraums nicht auf die Namen darin zutrifft

Skill-Sichtbarkeit über Einstellungen überschreiben

{
  "skillOverrides": {
    "legacy-context": "name-only",
    "deploy": "off"
  }
}

Ungenutzte Skills finden

Skill evaluieren und iterieren

• Persönlicher oder Projekt-Skill: Setze ihn auf "off" in skillOverrides.
• Skill, den ein Plugin bereitstellt: skillOverrides gilt nicht für Plugin-Skills. Verwende stattdessen claude plugin eval, das jeden Durchlauf ohne geladenes Plugin wiederholt.

Evals mit skill-creator ausführen

/plugin install skill-creator@claude-plugins-official

• Marketplace "claude-plugins-official" not found: Füge den Marketplace mit /plugin marketplace add anthropics/claude-plugins-official hinzu und versuche dann die Installation erneut.
• Plugin "<name>" not found in marketplace "claude-plugins-official": Ihre lokale Kopie des Marketplace-Katalogs ist möglicherweise veraltet. Aktualisieren Sie sie mit /plugin marketplace update claude-plugins-official und versuchen Sie die Installation dann erneut. Wenn der erneute Versuch dieselbe Meldung ausgibt, lesen Sie Plugin nicht im Marketplace gefunden.

• Testfälle: speichert Prompts, Eingabedateien und erwartetes Verhalten in evals/evals.json im Skill-Verzeichnis
• Isolierte Ausführungen: spawnt einen Subagent pro Testfall, sodass jede Ausführung mit einem sauberen Kontext beginnt, und zeichnet Token-Anzahl und Dauer auf
• Bewertung: überprüft jede Assertion gegen die Ausgabe und schreibt Bestanden oder Nicht bestanden mit Beweis in grading.json
• Benchmark: aggregiert Erfolgsquote, Zeit und Tokens für mit-Skill versus ohne-Skill in benchmark.json, sodass du die Verbesserung der Erfolgsquote gegen den Token- und Zeit-Overhead vergleichen kannst
• Versionsvergleich: führt einen blinden A/B zwischen zwei Versionen des Skills durch, sodass du bestätigen kannst, dass eine Bearbeitung eine Verbesserung ist, bevor du sie commitest
• Beschreibungsoptimierung: generiert sollte-auslösen und sollte-nicht-auslösen Prompts, misst die Trefferquote und schlägt Beschreibungsbearbeitungen vor, wenn der Skill bei falschen Anfragen aktiviert wird
• Review-Viewer: öffnet einen HTML-Bericht, in dem du jede Ausgabe inspizieren und qualitatives Feedback aufzeichnen kannst, das die nächste Iteration liest

Fähigkeiten teilen

• Projektfähigkeiten: Commit .claude/skills/ zur Versionskontrolle
• Plugins: Erstellen Sie ein skills/-Verzeichnis in Ihrem Plugin
• Verwaltet: Bereitstellung organisationsweit über verwaltete Einstellungen

Visuelle Ausgabe generieren

mkdir -p ~/.claude/skills/codebase-visualizer/scripts

---
name: codebase-visualizer
description: Generate an interactive collapsible tree visualization of your codebase. Use when exploring a new repo, understanding project structure, or identifying large files.
allowed-tools: Bash(python3 *)
---

# Codebase Visualizer

Generate an interactive HTML tree view that shows your project's file structure with collapsible directories.

## Usage

Run the visualization script from your project root:

```bash
python3 ${CLAUDE_SKILL_DIR}/scripts/visualize.py .
```

This creates `codebase-map.html` in the current directory and opens it in your default browser.

## What the visualization shows

- **Collapsible directories**: Click folders to expand/collapse
- **File sizes**: Displayed next to each file
- **Colors**: Different colors for different file types
- **Directory totals**: Shows aggregate size of each folder

• Eine Zusammenfassungs-Seitenleiste mit Dateianzahl, Verzeichnisanzahl, Gesamtgröße und Anzahl der Dateitypen
• Ein Balkendiagramm, das die Codebase nach Dateityp aufschlüsselt (Top 8 nach Größe)
• Ein zusammenklappbarer Baum, in dem Sie Verzeichnisse erweitern und reduzieren können, mit farbcodierten Dateityp-Indikatoren

#!/usr/bin/env python3
"""Generate an interactive collapsible tree visualization of a codebase."""

import json
import sys
import webbrowser
from html import escape
from pathlib import Path
from collections import Counter

IGNORE = {'.git', 'node_modules', '__pycache__', '.venv', 'venv', 'dist', 'build'}

def scan(path: Path, stats: dict) -> dict:
    result = {"name": path.name, "children": [], "size": 0}
    try:
        for item in sorted(path.iterdir()):
            if item.name in IGNORE or item.name.startswith('.'):
                continue
            if item.is_file():
                size = item.stat().st_size
                ext = item.suffix.lower() or '(no ext)'
                result["children"].append({"name": item.name, "size": size, "ext": ext})
                result["size"] += size
                stats["files"] += 1
                stats["extensions"][ext] += 1
                stats["ext_sizes"][ext] += size
            elif item.is_dir():
                stats["dirs"] += 1
                child = scan(item, stats)
                if child["children"]:
                    result["children"].append(child)
                    result["size"] += child["size"]
    except PermissionError:
        pass
    return result

def generate_html(data: dict, stats: dict, output: Path) -> None:
    ext_sizes = stats["ext_sizes"]
    total_size = sum(ext_sizes.values()) or 1
    sorted_exts = sorted(ext_sizes.items(), key=lambda x: -x[1])[:8]
    colors = {
        '.js': '#f7df1e', '.ts': '#3178c6', '.py': '#3776ab', '.go': '#00add8',
        '.rs': '#dea584', '.rb': '#cc342d', '.css': '#264de4', '.html': '#e34c26',
        '.json': '#6b7280', '.md': '#083fa1', '.yaml': '#cb171e', '.yml': '#cb171e',
        '.mdx': '#083fa1', '.tsx': '#3178c6', '.jsx': '#61dafb', '.sh': '#4eaa25',
    }
    lang_bars = "".join(
        f'<div class="bar-row"><span class="bar-label">{ext}</span>'
        f'<div class="bar" style="width:{(size/total_size)*100}%;background:{colors.get(ext,"#6b7280")}"></div>'
        f'<span class="bar-pct">{(size/total_size)*100:.1f}%</span></div>'
        for ext, size in sorted_exts
    )
    def fmt(b):
        if b < 1024: return f"{b} B"
        if b < 1048576: return f"{b/1024:.1f} KB"
        return f"{b/1048576:.1f} MB"

    html = f'''<!DOCTYPE html>
<html><head>
  <meta charset="utf-8"><title>Codebase Explorer</title>
  <style>
    body {{ font: 14px/1.5 system-ui, sans-serif; margin: 0; background: #1a1a2e; color: #eee; }}
    .container {{ display: flex; height: 100vh; }}
    .sidebar {{ width: 280px; background: #252542; padding: 20px; border-right: 1px solid #3d3d5c; overflow-y: auto; flex-shrink: 0; }}
    .main {{ flex: 1; padding: 20px; overflow-y: auto; }}
    h1 {{ margin: 0 0 10px 0; font-size: 18px; }}
    h2 {{ margin: 20px 0 10px 0; font-size: 14px; color: #888; text-transform: uppercase; }}
    .stat {{ display: flex; justify-content: space-between; padding: 8px 0; border-bottom: 1px solid #3d3d5c; }}
    .stat-value {{ font-weight: bold; }}
    .bar-row {{ display: flex; align-items: center; margin: 6px 0; }}
    .bar-label {{ width: 55px; font-size: 12px; color: #aaa; }}
    .bar {{ height: 18px; border-radius: 3px; }}
    .bar-pct {{ margin-left: 8px; font-size: 12px; color: #666; }}
    .tree {{ list-style: none; padding-left: 20px; }}
    details {{ cursor: pointer; }}
    summary {{ padding: 4px 8px; border-radius: 4px; }}
    summary:hover {{ background: #2d2d44; }}
    .folder {{ color: #ffd700; }}
    .file {{ display: flex; align-items: center; padding: 4px 8px; border-radius: 4px; }}
    .file:hover {{ background: #2d2d44; }}
    .size {{ color: #888; margin-left: auto; font-size: 12px; }}
    .dot {{ width: 8px; height: 8px; border-radius: 50%; margin-right: 8px; }}
  </style>
</head><body>
  <div class="container">
    <div class="sidebar">
      <h1>📊 Summary</h1>
      <div class="stat"><span>Files</span><span class="stat-value">{stats["files"]:,}</span></div>
      <div class="stat"><span>Directories</span><span class="stat-value">{stats["dirs"]:,}</span></div>
      <div class="stat"><span>Total size</span><span class="stat-value">{fmt(data["size"])}</span></div>
      <div class="stat"><span>File types</span><span class="stat-value">{len(stats["extensions"])}</span></div>
      <h2>By file type</h2>
      {lang_bars}
    </div>
    <div class="main">
      <h1>📁 {escape(data["name"])}</h1>
      <ul class="tree" id="root"></ul>
    </div>
  </div>
  <script>
    const data = {json.dumps(data)};
    const colors = {json.dumps(colors)};
    function fmt(b) {{ if (b < 1024) return b + ' B'; if (b < 1048576) return (b/1024).toFixed(1) + ' KB'; return (b/1048576).toFixed(1) + ' MB'; }}
    function esc(s) {{ return s.replace(/[&<>"']/g, c => ({{"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;"}}[c])); }}
    function render(node, parent) {{
      if (node.children) {{
        const det = document.createElement('details');
        det.open = parent === document.getElementById('root');
        det.innerHTML = `<summary><span class="folder">📁 ${{esc(node.name)}}</span><span class="size">${{fmt(node.size)}}</span></summary>`;
        const ul = document.createElement('ul'); ul.className = 'tree';
        node.children.sort((a,b) => (b.children?1:0)-(a.children?1:0) || a.name.localeCompare(b.name));
        node.children.forEach(c => render(c, ul));
        det.appendChild(ul);
        const li = document.createElement('li'); li.appendChild(det); parent.appendChild(li);
      }} else {{
        const li = document.createElement('li'); li.className = 'file';
        li.innerHTML = `<span class="dot" style="background:${{colors[node.ext]||'#6b7280'}}"></span>${{esc(node.name)}}<span class="size">${{fmt(node.size)}}</span>`;
        parent.appendChild(li);
      }}
    }}
    data.children.forEach(c => render(c, document.getElementById('root')));
  </script>
</body></html>'''
    output.write_text(html)

if __name__ == '__main__':
    target = Path(sys.argv[1] if len(sys.argv) > 1 else '.').resolve()
    stats = {"files": 0, "dirs": 0, "extensions": Counter(), "ext_sizes": Counter()}
    data = scan(target, stats)
    out = Path('codebase-map.html')
    generate_html(data, stats, out)
    print(f'Generated {out.absolute()}')
    webbrowser.open(f'file://{out.absolute()}')

Fehlerbehebung

Skill wird nicht ausgelöst

1. Überprüfen Sie, dass die Beschreibung Schlüsselwörter enthält, die Benutzer natürlicherweise sagen würden
2. Stellen Sie sicher, dass der Skill in What skills are available? angezeigt wird
3. Versuchen Sie, Ihre Anfrage umzuformulieren, um sie besser an die Beschreibung anzupassen
4. Rufen Sie ihn direkt mit /skill-name auf, wenn der Skill vom Benutzer aufgerufen werden kann
5. Wenn auch /skill-name nicht erkannt wird, prüfen Sie, ob Claude Code den Namen des Skills abgelehnt hat
6. Wenn der Skill paths festlegt, prüfen Sie, ob sich die Dateien, die Claude liest, bearbeitet oder schreibt, im aktuellen Arbeitsverzeichnis von Claude befinden. Für Dateien außerhalb davon wird der Skill nicht aktiviert, etwa für Dateien in einem benachbarten Git-Worktree, selbst wenn Sie diesen mit /add-dir hinzugefügt haben. Damit der Skill für diese Dateien aktiviert wird, starten Sie Claude Code in diesem Worktree oder verschieben Sie die Sitzung mit /cd dorthin.

Skill wird zu oft ausgelöst

1. Machen Sie die Beschreibung spezifischer
2. Fügen Sie disable-model-invocation: true hinzu, wenn Sie nur manuelle Aufrufe möchten

Claude folgt einem Skill nicht mehr

• Claude hat eine Regel übersprungen, die jedes Mal gelten muss: Verschieben Sie die Regel in einen Hook. Claude Code führt einen Hook jedes Mal aus, wenn sein Ereignis auftritt, z. B. vor jeder Dateibearbeitung, unabhängig davon, ob Claude dem Skill folgt oder nicht. Um die Regel mit dem Skill zu behalten, definieren Sie den Hook in der hooks Frontmatter des Skills. Dieser Hook gilt ab dem Zeitpunkt, an dem der Skill aufgerufen wird, bis die Sitzung endet.
• Claude hat Anleitung übersprungen, die es mit Urteilsvermögen anwenden sollte: Formulieren Sie die Anleitung so, dass sie für die gesamte Aufgabe gilt, z. B. „Tests nach jeder Bearbeitung ausführen“ anstelle von „Tests ausführen“. Claude Code fügt den Inhalt des Skills zum Gespräch hinzu, wenn der Skill aufgerufen wird, und liest die Datei später nicht erneut.
• Das Gespräch wurde komprimiert: Rufen Sie den Skill erneut auf, um seinen vollständigen Inhalt wiederherzustellen. Nach Komprimierung kann Claude Code nur den Anfang eines aufgerufenen Skills behalten, daher platzieren Sie die wichtigsten Anweisungen oben in SKILL.md.

Skill-Beschreibungen werden gekürzt

Spitze Klammern in einer Skill-Beschreibung werden als < und > angezeigt

• Eckige Klammern: Ersetzen Sie <branch> durch [branch], was so angezeigt wird, wie es eingegeben wurde
• argument-hint: Verschieben Sie den Platzhalter in eine neue Zeile argument-hint: <branch>. Er wird nach dem Befehlsnamen angezeigt. Wenn Sie den Skill auch auf claude.ai oder in die Skills API hochladen, prüfen Sie zuerst, ob argument-hint dort akzeptiert wird.

Persönliche Skills sind verschwunden

Verwandte Ressourcen

• Debuggen Sie Ihre Konfiguration: Diagnostizieren Sie, warum ein Skill nicht angezeigt oder ausgelöst wird
• Evaluating skill output quality: das Eval-Dateiformat und Iterations-Workflow auf agentskills.io
• Skill authoring best practices: Schreibanleitung, die über Claude-Produkte hinweg gilt
• Subagenten: Delegieren Sie Aufgaben an spezialisierte Agenten
• Plugins: Packen und verteilen Sie Skills mit anderen Erweiterungen
• Hooks: Automatisieren Sie Workflows um Tool-Ereignisse
• Memory: Verwalten Sie CLAUDE.md-Dateien für persistenten Kontext
• Befehle: Referenz für integrierte Befehle und gebündelte Skills
• Berechtigungen: Steuern Sie Tool- und Skill-Zugriff
• Claude Tag Skills: Projekt-Skills, die in ein Repository übernommen wurden, werden auch geladen, wenn dieses Repository in einem Claude Tag-Kanal verwendet wird