Zum Hauptinhalt springen

So erstellen Sie benutzerdefinierte Skills

Skills sind für Benutzer in den Plänen Free, Pro, Max, Team und Enterprise verfügbar. Diese Funktion erfordert aktivierte Code-Ausführung. 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.

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

Skills können so einfach wie einige Anweisungszeilen oder so komplex wie mehrdatei-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 Sie eine skill.md-Datei

Jeder Skill besteht aus einem Verzeichnis, das mindestens eine skill.md-Datei enthält, die der Kern des Skills 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 kritisch – Claude nutzt dies, um zu bestimmen, wann Ihr Skill aufgerufen werden sollte (maximal 200 Zeichen).

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

Optionale Metadatenfelder

dependencies: Softwarepakete, die von Ihrem Skill benötigt werden.

  • 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 Ihrer Aufgabe kann Claude auf die skill.md-Datei zugreifen und den Skill verwenden.

Beispiel skill.md

Brand Guidelines Skill

## Metadata
name: Brand Guidelines
description: Apply Acme Corp brand guidelines to all presentations and documents

## Overview
This skill provides Acme Corp's official brand guidelines for creating consistent, professional materials. When creating presentations, documents, or marketing materials, apply these standards to ensure all outputs match Acme's visual identity. Claude should reference these guidelines whenever creating external-facing materials or documents that represent Acme Corp.

## Brand Colors

Our official brand colors are:
- Primary: #FF6B35 (Coral)
- Secondary: #004E89 (Navy Blue)
- Accent: #F7B801 (Gold)
- Neutral: #2E2E2E (Charcoal)

## Typography

Headers: Montserrat Bold
Body text: Open Sans Regular
Size guidelines:
- H1: 32pt
- H2: 24pt
- Body: 11pt

## Logo Usage

Always use the full-color logo on light backgrounds. Use the white logo on dark backgrounds. Maintain minimum spacing of 0.5 inches around the logo.

## When to Apply

Apply these guidelines whenever creating:
- PowerPoint presentations
- Word documents for external sharing
- Marketing materials
- Reports for clients

## Resources

See the resources folder for logo files and 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 diese Ressource beim Ausführen des Skills benötigt.

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.


Verpacken Sie Ihren Skill

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)


Testen Sie Ihren Skill

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 Speicherorten 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 Customize > Skills.

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 Beispieleingaben 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 Teile 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 Skill-Authoring Best Practices 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?