Zum Hauptinhalt springen

Wie man benutzerdefinierte Skills erstellt

Gestern aktualisiert

Skills sind für Benutzer in den Plänen Pro, Max, Team und Enterprise verfügbar. Diese Funktion erfordert, dass Code-Ausführung aktiviert ist. Skills sind auch in der Beta-Version für Claude Code-Benutzer und für alle API-Benutzer verfügbar, die das Code-Ausführungs-Tool verwenden.

Custom Skills ermöglichen es Ihnen, Claude mit spezialisiertem Wissen und Workflows zu erweitern, die spezifisch für Ihre Organisation oder Ihren persönlichen Arbeitsstil sind. Dieser Artikel erklärt, wie Sie Ihre eigenen Skills erstellen, strukturieren und testen.

Skills können so einfach wie ein paar Zeilen Anweisungen oder so komplex wie Multi-Datei-Pakete mit ausführbarem Code sein. Die besten Skills:

  • Lösen eine spezifische, wiederholbare Aufgabe

  • Haben klare Anweisungen, denen Claude folgen kann

  • Enthalten Beispiele, wenn hilfreich

  • Definieren, wann sie verwendet werden sollten

  • Konzentrieren sich auf einen Workflow, anstatt alles tun zu wollen

Erstellen einer Skill.md-Datei

Jeder Skill besteht aus einem Verzeichnis, das mindestens eine Skill.md-Datei enthält, die das Herzstück des Skill ist. Diese Datei muss mit einem YAML-Frontmatter beginnen, um erforderliche Metadatenfelder für Name und Beschreibung zu enthalten. Sie kann auch zusätzliche Metadaten, Anweisungen für Claude oder Referenzdateien, ausführbare Skripte oder Tools enthalten.

Erforderliche Metadatenfelder

name: Ein benutzerfreundlicher Name für Ihren Skill (maximal 64 Zeichen)

  • Beispiel: Brand Guidelines

description: Eine klare Beschreibung, was der Skill tut und wann er verwendet werden sollte.

  • Dies ist entscheidend – Claude nutzt dies, um zu bestimmen, wann Ihr Skill aufgerufen werden sollte (maximal 200 Zeichen).

  • Beispiel: Wenden Sie die Brand Guidelines von Acme Corp auf Präsentationen und Dokumente an, einschließlich offizieller Farben, Schriftarten und Logo-Verwendung.

Optionale Metadatenfelder

dependencies: Softwarepakete, die für Ihren Skill erforderlich sind.

  • Beispiel: python>=3.8, pandas>=1.5.0

Die Metadaten in der Skill.md-Datei dienen als erste Ebene eines progressiven Offenlegungssystems und bieten gerade genug Informationen, damit Claude weiß, wann der Skill verwendet werden sollte, ohne den gesamten Inhalt laden zu müssen.

Markdown-Text

Der Markdown-Text ist die zweite Detailebene nach den Metadaten, daher kann Claude darauf zugreifen, wenn nötig, nachdem er die Metadaten gelesen hat. Je nach Aufgabe kann Claude auf die Skill.md-Datei zugreifen und den Skill verwenden.

Beispiel Skill.md

Brand Guidelines Skill

## Metadaten
name: Brand Guidelines
description: Wenden Sie die Brand Guidelines von Acme Corp auf alle Präsentationen und Dokumente an

## Übersicht
Dieser Skill bietet die offiziellen Brand Guidelines von Acme Corp zum Erstellen konsistenter, professioneller Materialien. Beim Erstellen von Präsentationen, Dokumenten oder Marketingmaterialien sollten diese Standards angewendet werden, um sicherzustellen, dass alle Ausgaben mit der visuellen Identität von Acme übereinstimmen. Claude sollte diese Richtlinien immer dann referenzieren, wenn externe Materialien oder Dokumente erstellt werden, die Acme Corp vertreten.

## Brand-Farben

Unsere offiziellen Brand-Farben sind:
- Primär: #FF6B35 (Coral)
- Sekundär: #004E89 (Navy Blue)
- Akzent: #F7B801 (Gold)
- Neutral: #2E2E2E (Charcoal)

## Typografie

Überschriften: Montserrat Bold
Fließtext: Open Sans Regular
Größenrichtlinien:
- H1: 32pt
- H2: 24pt
- Text: 11pt

## Logo-Verwendung

Verwenden Sie das Vollfarb-Logo immer auf hellem Hintergrund. Verwenden Sie das weiße Logo auf dunklem Hintergrund. Halten Sie einen Mindestabstand von 0,5 Zoll um das Logo ein.

## Wann anwenden

Wenden Sie diese Richtlinien an, wenn Sie erstellen:
- PowerPoint-Präsentationen
- Word-Dokumente zum externen Teilen
- Marketingmaterialien
- Berichte für Kunden

## Ressourcen

Siehe den Ressourcenordner für Logo-Dateien und Font-Downloads.

Ressourcen hinzufügen

Wenn Sie zu viele Informationen haben, um sie in einer einzelnen Skill.md-Datei hinzuzufügen (z. B. Abschnitte, die nur auf bestimmte Szenarien zutreffen), können Sie mehr Inhalte hinzufügen, indem Sie Dateien in Ihrem Skill-Verzeichnis hinzufügen. Fügen Sie beispielsweise eine REFERENCE.md-Datei mit zusätzlichen und Referenzinformationen zu Ihrem Skill-Verzeichnis hinzu. Das Referenzieren in Skill.md hilft Claude zu entscheiden, ob es auf diese Ressource zugreifen muss, wenn der Skill ausgeführt wird.

Skripte hinzufügen

Für fortgeschrittenere Skills können Sie ausführbare Code-Dateien an Skill.md anhängen, damit Claude Code ausführen kann. Beispielsweise verwenden unsere Document Skills die folgenden Programmiersprachen und Pakete:

  • Python (pandas, numpy, matplotlib)

  • JavaScript/Node.js

  • Pakete zur Unterstützung der Dateibearbeitung

  • Visualisierungstools

Hinweis: Claude und Claude Code können Pakete aus Standard-Repositories (Python PyPI, JavaScript npm) installieren, wenn Skills geladen werden. Es ist nicht möglich, zusätzliche Pakete zur Laufzeit mit API Skills zu installieren – alle Abhängigkeiten müssen im Container vorinstalliert sein.

Ihren Skill verpacken

Sobald Ihr Skill-Ordner vollständig ist:

  1. Stellen Sie sicher, dass der Ordnername dem Namen Ihres Skills entspricht.

  2. Erstellen Sie eine ZIP-Datei des Ordners.

  3. Die ZIP-Datei sollte den Skill-Ordner als Root enthalten (nicht als Unterordner).

Korrekte Struktur:

my-Skill.zip

└── my-Skill/

├── Skill.md

└── resources/

Falsche Struktur:

my-Skill.zip

└── (Dateien direkt im ZIP-Root)

Ihren Skill testen

Vor dem Hochladen

1. Überprüfen Sie Ihre Skill.md auf Klarheit

2. Überprüfen Sie, dass die Beschreibung genau widerspiegelt, wann Claude den Skill verwenden sollte

3. Überprüfen Sie, dass alle referenzierten Dateien an den richtigen Orten vorhanden sind

4. Testen Sie mit Beispiel-Prompts, um sicherzustellen, dass Claude ihn angemessen aufruft

Nach dem Hochladen zu Claude

1. Aktivieren Sie den Skill in Einstellungen > Funktionen.

2. Versuchen Sie mehrere verschiedene Prompts, die ihn auslösen sollten

3. Überprüfen Sie Claudes Überlegungen, um zu bestätigen, dass der Skill geladen wird

4. Iterieren Sie die Beschreibung, wenn Claude ihn nicht wie erwartet verwendet

Hinweis für Team und Enterprise-Pläne: Um einen Skill für alle Benutzer in Ihrer Organisation verfügbar zu machen, siehe Bereitstellung und Verwaltung von Skills für Ihre Organisation.

Best Practices

Halten Sie es fokussiert: Erstellen Sie separate Skills für verschiedene Workflows. Mehrere fokussierte Skills funktionieren besser zusammen als ein großer Skill.

Schreiben Sie klare Beschreibungen: Claude nutzt Beschreibungen, um zu entscheiden, wann Ihr Skill aufgerufen werden sollte. Seien Sie spezifisch, wann er anwendbar ist.

Beginnen Sie einfach: Beginnen Sie mit grundlegenden Anweisungen in Markdown, bevor Sie komplexe Skripte hinzufügen. Sie können den Skill später immer noch erweitern.

Verwenden Sie Beispiele: Fügen Sie Beispiel-Eingaben und -Ausgaben in Ihre Skill.md-Datei ein, um Claude zu helfen, zu verstehen, wie Erfolg aussieht.

Testen Sie schrittweise: Testen Sie nach jeder signifikanten Änderung, anstatt einen komplexen Skill auf einmal zu erstellen.

Skills können aufeinander aufbauen: Obwohl Skills nicht explizit auf andere Skills verweisen können, kann Claude automatisch mehrere Skills zusammen verwenden. Diese Zusammensetzbarkeit ist einer der stärksten Aspekte der Skills-Funktion.

Überprüfen Sie die offene Agent Skills-Spezifikation: Befolgen Sie die Richtlinien unter agentskills.io, damit Skills, die Sie erstellen, auf Plattformen funktionieren, die den Standard übernehmen.

Für einen ausführlicheren Leitfaden zur Skill-Erstellung siehe Best Practices zur Skill-Erstellung in unserer Claude-Dokumentation.

Sicherheitsaspekte

  • Seien Sie vorsichtig, wenn Sie Skripte zu Ihrer Skill.md-Datei hinzufügen.

  • Hardcodieren Sie keine sensiblen Informationen (API-Schlüssel, Passwörter).

  • Überprüfen Sie alle Skills, die Sie herunterladen, bevor Sie sie aktivieren.

  • Verwenden Sie angemessene MCP-Verbindungen für den Zugriff auf externe Dienste.

Beispiel-Skills als Referenz

Besuchen Sie unser Repository auf GitHub für Beispiel-Skills, die Sie als Vorlagen verwenden können: https://github.com/anthropics/skills/tree/main/skills.

Hat dies deine Frage beantwortet?