So erstellen Sie Skills: Wichtige Schritte, Einschränkungen und Beispiele

Erfahren Sie, wie Sie maßgeschneiderte Skills schreiben, die zu besseren und effektiveren Ergebnissen von Claude führen.

Kategorie
Programmierung
Agenten
Produkt
Claude Apps
Datum
19/11/2025
Lesezeit
5
Min.
Teilen
Link kopieren
https://claude.com/blog/how-to-create-skills-key-steps-limitations-and-examples

Skills sind benutzerdefinierte Anweisungen, die die Fähigkeiten von Claude für bestimmte Aufgaben oder Bereiche erweitern.

Wenn Sie einen Skill über eine SKILL.md-Datei erstellen, bringen Sie Claude bei, wie er bestimmte Szenarien effektiver handhabt. Die Stärke von Skills liegt in ihrer Fähigkeit, institutionelles Wissen zu kodieren, die Ergebnisse zu standardisieren und komplexe mehrstufige Workflows zu bewältigen, die anderenfalls wiederholte Erklärungen oder Investitionen in die Entwicklung eines benutzerdefinierten Agenten erfordern würden.

Erfahren Sie, wie Sie Skills erstellen, die Claude von einem Allzweckassistenten zu einem spezialisierten Experten für Ihre spezifischen Workflows machen, entweder mit unserer Skill-Creator-Vorlage oder manuell. (Pro-Tipp: Zur Vereinfachung empfehlen wir, Ihre SKILL.md-Datei mit dieser Vorlage zu erstellen und darauf zuzuschneiden.)

Einen Skill in 5 Schritten entwickeln

Dieser strukturierte Ansatz ermöglicht es, Fähigkeiten zu entwickeln, die zuverlässiger auslösen.

1. Verstehen Sie die Kernanforderungen

Bevor Sie etwas schreiben, sollten Sie klären, welches Problem Ihr Skill löst. Starke Fähigkeiten erfüllen konkrete Anforderungen mit messbaren Ergebnissen. „Finanzdaten aus PDFs extrahieren und als CSV formatieren“ ist besser als „Hilfe bei meinen Finanzdaten“, da es das Eingabeformat, den Vorgang und die erwarteten Ergebnisse angibt.

Fragen Sie sich: Welche spezifische Aufgabe erfüllt dieser Skill? Welche Trigger sollten es auslösen? Wie sieht Erfolg aus? Welche Extremfälle oder Einschränkungen gibt es?

2. Schreiben Sie den Namen

Dein Skill benötigt drei Kernkomponenten: Name (eindeutige Kennung), Beschreibung (wann er aktiviert werden soll) und Anweisungen (wie er ausgeführt wird). Tatsächlich sind der Name und die Beschreibung die einzigen Teile der SKILL.md-Datei, die die Auslösung beeinflussen, mit anderen Worten die Fähigkeit von Claude, einen Skill für spezielles Wissen oder Workflows zu nennen.

Der Name sollte klar und beschreibend sein. Verwenden Sie Kleinbuchstaben mit Bindestrichen (z. B. PDF-Editor, Markenrichtlinien). Fassen Sie sich kurz und seien Sie deutlich.

3. Beschreibungsfeld eingeben

Die Beschreibung bestimmt, wann Ihr Skill aktiviert wird, was ihn zur wichtigsten Komponente macht. Schreiben Sie es aus der Perspektive von Claude und konzentrieren Sie sich auf Trigger, Funktionen und Anwendungsfälle.

Eine überzeugende Beschreibung berücksichtigt mehrere Elemente: spezifische Funktionen, klare Trigger, relevanten Kontext und Grenzen.

Schlechte Beschreibung:

Aussagekräftige Beschreibung:

Die stärkere Version liefert Claude mehrere Datenpunkte: spezifische Verben (extrahieren, erstellen, zusammenführen), konkrete Anwendungsfälle (Formularausfüllen, Stapelvorgänge) und klare Grenzen (nicht zur einfachen Anzeige).

4. Hauptanweisungen verfassen

Ihre Anweisungen sollten strukturiert, scannbar und umsetzbar sein. Verwenden Sie Markdown-Header, Bulletpoints für Optionen und Codeblöcke als Beispiele.

Strukturierung mit einer klaren Hierarchie: Übersicht, Voraussetzungen, Ausführungsschritte, Beispiele, Fehlerbehandlung und Einschränkungen. Unterteilen Sie komplexe Workflows in diskrete Phasen mit klaren Eingaben und Ausgaben.

Füge konkrete Beispiele für die korrekte Nutzung hinzu. Geben Sie an, was der Skill nicht leisten kann, um Missbrauch zu verhindern und die Erwartungen zu erfüllen. Ihre SKILL.md-Datei kann auch zusätzliche Referenzdateien und Ressourcen enthalten, um noch mehr Klarheit und Orientierung darüber zu schaffen, was der Agent beim Auslösen des Skills tun muss.

5. Skill hochladen

Je nachdem, auf welcher Claude-Oberfläche du arbeitest, lädst du deinen Skill wie folgt hoch:

Claude.ai (Claude-Apps): Gehen Sie zu den Einstellungen und fügen Sie Ihren benutzerdefinierten Skill hinzu. Für benutzerdefinierte Skills ist ein Pro, Max, Team oder Enterprise Plan mit aktivierter Codeausführung erforderlich. Die hier hochgeladenen Skills sind für jeden Benutzer individuell – sie werden nicht unternehmensweit verwendet und können nicht von Administratoren zentral verwaltet werden.
Claude Code: Erstellen Sie ein Skills/Verzeichnis in Ihrem Plugin oder Projektroot, und fügen Sie Skill-Ordner mit den SKILL.md-Dateien hinzu. Claude erkennt und verwendet sie automatisch, wenn das Plugin installiert wird. Beispielstruktur:

Claude Developer Platform: Skills über die Skills-API hochladen (/v1/skills endpoints). Verwenden Sie eine POST-Anfrage mit den erforderlichen Beta-Headern:

4. Testen und Validieren

Testen Sie Ihre Fähigkeiten vor der Bereitstellung mit realistischen Szenarien. Systematische Tests decken Lücken in den Anweisungen, Unklarheiten in den Beschreibungen und unerwartete Randfälle auf, die nur während der tatsächlichen Nutzung auftauchen.

Erstellen Sie eine Testmatrix für drei Szenarien:

Normaler Betrieb: Testen Sie den Skill mit typischen Anforderungen, die er perfekt bewältigen sollte. Wenn Sie eine Finanzanalyse-Skill entwickelt haben, versuchen Sie, „die neuesten Ergebnisse von Microsoft zu analysieren“ oder „ein Datenpaket für diese 10.000-Einreichung zu erstellen“. Diese Basistests bestätigen, dass Ihre Anweisungen wie beabsichtigt funktionieren.
Extreme: Test mit unvollständigen oder ungewöhnlichen Eingaben. Was passiert, wenn Daten fehlen? Wenn Dateiformate unerwartet sind? Wenn Benutzer mehrdeutige Anweisungen geben? Ihre Fähigkeiten sollten diese reibungslos bewältigen – entweder herabgesetzte, aber nützliche Ergebnisse erzielen oder erklären, was erforderlich ist, um fortzufahren.
Anforderungen außerhalb des Anwendungsbereichs: Testen Sie mit Aufgaben, die verwandt zu sein scheinen, aber Ihre Fähigkeiten nicht beanspruchen sollten. Wenn Sie einen NDA-Review erstellt haben, versuchen Sie, „diesen Arbeitsvertrag zu überprüfen“ oder „diesen Mietvertrag zu analysieren“ zu bitten. Der Skill sollte ruhig bleiben, damit andere Skills oder allgemeine Claude-Funktionen die Anfrage erledigen können.

Führen Sie die folgenden Tests zur noch detaillierteren Validierung durch:

Triggertests: Wird der Skill aktiviert, wenn er erwartet wird? Testen Sie sowohl mit expliziten Anforderungen („ich nutze den Finanzdatenpaket, um dieses Unternehmen zu analysieren“) als auch mit natürlichen Anforderungen („ich möchte die Finanzen dieses Unternehmens besser verstehen“). Bleibt es inaktiv, wenn es irrelevant ist? Ein gut skalierter Skill weiß, wann er nicht aktiviert werden soll. Testen Sie ähnliche, aber unterschiedliche Anforderungen, um die Grenzen zu überprüfen.
Funktionelle Tests: Dazu gehören die Konsistenz der Ergebnisse (führen mehrere Durchläufe mit ähnlichen Eingaben zu vergleichbaren Ergebnissen?), die Benutzerfreundlichkeit (kann jemand, der mit dem Bereich nicht vertraut ist, es erfolgreich verwenden?) und die Genauigkeit der Dokumentation (entsprechen Ihre Beispiele dem tatsächlichen Verhalten?).

5. Iteration basierend auf der Nutzung

Überwachen Sie, wie Ihr Skill im realen Einsatz abschneidet. Verfeinern Sie die Beschreibungen, wenn die Auslöser inkonsistent sind. Klären Sie die Anweisungen, wenn die Ergebnisse unerwartet variieren. Wie bei Prompts entwickeln sich die besten Fähigkeiten durch die praktische Anwendung.

Allgemeine Best Practices für die Entwicklung von Skills

Diese Prinzipien helfen Ihnen, Fähigkeiten zu entwickeln, die wartbar, wiederverwendbar und wirklich nützlich sind – nicht theoretisch.

Anwendungsfälle erstellen

Schreiben Sie Skills nicht spekulativ. Erstellen Sie sie, wenn Sie echte, wiederholte Aufgaben haben. Die besten Skills lösen Probleme, denen man regelmäßig begegnet.

Bevor Sie einen Skill erstellen, fragen Sie sich: Habe ich diese Aufgabe mindestens fünfmal gelöst? Werde ich es mindestens zehnmal wiederholen? Wenn ja, ist es sinnvoll.

Erfolgskriterien definieren und in den Skill einbeziehen

Sag Claude, wie es aussieht. Wenn Sie Finanzberichte erstellen, geben Sie die erforderlichen Abschnitte, Formatierungsstandards, Validierungsprüfungen und Qualitätsgrenzen an. Nimm diese Kriterien in deine Anweisungen auf, damit Claude sie selbst überprüfen kann.

Skill-Creator-Skill verwenden

Der Skill-Entwickler-Skill führt Sie durch die Erstellung gut strukturierter Skills. Es stellt klare Fragen, schlägt Verbesserungen in der Beschreibung vor und hilft bei der korrekten Formatierung von Anweisungen. Es ist im Skills-Repository auf GitHub und direkt über Claude.ai verfügbar und eignet sich besonders für die ersten Skills.

Kompetenzbeschränkungen und Überlegungen

Wenn Sie verstehen, wie Skills funktionieren – und ihre Grenzen – können Sie effektivere Skills entwickeln und angemessene Erwartungen festlegen.

Skill-Auslösung

Claude bewertet die Fähigkeiten, um die Relevanz zu ermitteln, und bewertet die Anforderungen der Mitarbeiter. Das ist kein Keyword-Matching – Claude versteht semantische Beziehungen. Vage Beschreibungen verringern jedoch die Genauigkeit der Auslöser.

Mehrere Skills können gleichzeitig aktiviert werden, wenn sie verschiedene Aspekte einer komplexen Aufgabe bearbeiten. Zu allgemeine Beschreibungen führen zu unangemessenen Aktivierungen, während fehlende Anwendungsfälle zu fehlgeschlagenen Aktivierungen führen.

Angemessene Dateigrößen

Vermeiden Sie es, das Kontextfenster mit unnötigen Inhalten zu überladen. Überlegen Sie, ob jede Information jedes Mal geladen werden muss oder nur bedingt.

Verwenden Sie einen Menüansatz: Wenn Ihr Skill mehrere Prozesse oder Optionen abdeckt, sollte SKILL.md beschreiben, was verfügbar ist, und die relativen Pfade verwenden, um für jede einzelne Datei zu verweisen. Claude liest dann nur die Datei, die für die Aufgabe des Benutzers relevant ist, und überlässt die anderen Dateien für das Gespräch unberührt.

Diese separaten Dateien müssen keine sich gegenseitig ausschließenden Pfade darstellen. Das Schlüsselprinzip ist, den Inhalt in vernünftige Teile aufzuteilen und es Claude zu überlassen, die für die jeweilige Aufgabe benötigt werden, auszuwählen.

‍Beispiele für reale Fähigkeiten

Skill-Beispiel Nr. 1: Skill zur Erstellung von Dokumenten

Was es macht: Bietet einen klaren Entscheidungsbaum, der Claude basierend auf dem Aufgabentyp den richtigen Workflow zuleitet, verwendet progressive Offenlegung, um die Hauptdatei schlank zu halten, während detaillierte Implementierungsdateien nur bei Bedarf verwiesen werden, und enthält konkrete gute/schlechte Beispiele, die genau zeigen, wie komplexe Muster wie verfolgte Änderungen implementiert werden.

Skill-Beispiel Nr. 2: Markenrichtlinien

Was es macht: Liefert präzise, umsetzbare Informationen, die Claude nicht an sich benötigt (exakte Hex-Codes, Schriftnamen, Größengrenzen) mit einer klaren Beschreibung, die Claude sagt, was es tun soll und wann es ausgelöst werden soll.

Was es stark macht: Kreative Fähigkeiten mit klaren Grenzen, integrierter Urheberrechtsschutz, technisches Gerüst für Nicht-Musiker, Qualitätsstandards.

Skill-Beispiel Nr. 3: Frontend-Design-Skill

Was es stark macht: Kreative Fähigkeiten mit klaren Grenzen, integrierter Urheberrechtsschutz, technisches Gerüst für Nicht-Musiker, Qualitätsstandards.

Häufige Fragen

Wie schreibe ich Beschreibungen, die tatsächlich auslösen?

Konzentrieren Sie sich auf Funktionen und Szenarien, nicht auf allgemeine Keywords. Füge Aktionsverben, bestimmte Dateitypen und klare Anwendungsfälle hinzu. Statt „Dokumentenverarbeitung“ zu entwickeln, „extrahieren Sie Tabellen aus PDFs und konvertieren sie in das CSV-Format für die Datenanalyse-Workflows.“

Wie entscheidet Claude, welche Skills verwendet werden?

Claude bewertet Ihre Anfrage anhand von Skill-Beschreibungen unter Verwendung von semantischem Verständnis. Es geht nicht um den Keyword-Matching, sondern um die Kontextrelevanz. Es können mehrere Skills aktiviert werden, wenn sie verschiedene Aspekte Ihrer Anfrage erfüllen.

Wie hoch ist die Granularität meiner Beschreibungen?

Ziele sind Qualifikationen für einen bestimmten Zweck. Die „SEO-Optimierung für Blog-Posts“ ist fokussiert genug auf spezifische Anweisungen und gleichzeitig breit genug für die Wiederverwendung. Zu pauschal: „Content-Marketing-Helfer.“ Zu eng: „Meta-Beschreibungen hinzufügen.“

Wie teile ich Skills in meinem Unternehmen?

Unabhängig von der Größe Ihres Teams empfehlen wir, ein gemeinsames Dokumenten-Repository mit Skill-Spezifikationen zu erstellen.

Verwenden Sie für kleinere Teams ein Vorlagenformat mit Namen, Beschreibung, Anweisungen und Versionsinformationen.

Für mittlere bis große Teams sollte ein Skills-Governance-Prozess eingerichtet werden:

Skill-Owner für jeden Bereich benennen (Finanzen, Recht, Marketing)
Verwaltung eines zentralen Wiki oder eines gemeinsamen Laufwerks als Skill-Bibliothek
Füge Anwendungsbeispiele und häufige Fehlerbehebungen für jeden Skill hinzu
Ihre Skills und Änderungen in einem Änderungsprotokoll dokumentieren
Planung vierteljährlicher Überprüfungen, um veraltete Skills zu aktualisieren oder zu entfernen

Best Practices für Teamgrößen aller Art:

Dokumentieren Sie den Geschäftszweck für jede Skill
Zuweisung von Verantwortlichen für Wartung und Updates
Erstellen Sie Onboarding-Materialien, die neuen Teammitgliedern zeigen, wie sie gemeinsame Skills implementieren
Verfolgen Sie, welche Fähigkeiten den größten Nutzen bieten, um die Wartungsarbeiten zu priorisieren
Verwenden Sie konsistente Namenskonventionen, um Skills einfach zu finden

Unternehmenskunden können mit dem Customer Success Team von Anthropic zusätzliche Bereitstellungsoptionen und Governance-Frameworks erkunden.

Wie entwickle ich Debugging-Skills?

Testauslösung und -ausführung getrennt. Wenn die Skills nicht aktiviert werden, erweitern Sie Ihre Beschreibung und fügen Sie Anwendungsfälle hinzu. Wenn die Ergebnisse inkonsistent sind, sollten Sie die Anweisungen präzisieren und Validierungsschritte hinzufügen. Erstellen Sie eine Testfallbibliothek, die die normale Nutzung, Edge-Fälle und Anforderungen außerhalb des Anwendungsbereichs abdeckt.

Wie teile ich Skills in meinem Unternehmen?

‍In Claude.ai sind die Skills derzeit individuell für jeden Benutzer, obwohl es bald Funktionen für die unternehmensweite Verwaltung und gemeinsame Nutzung gibt. Unabhängig von der Größe Ihres Teams empfehlen wir, ein gemeinsames Dokumenten-Repository mit Skill-Spezifikationen zu erstellen. Dadurch wird Ihr Unternehmen auf kommende Funktionen vorbereitet und gleichzeitig Good Governance-Practices etabliert.