Skill-Creator

Was macht Skill-Creator?

Dieses Skill bietet eine Anleitung zur Erstellung effektiver Skills.

Über Skills

Skills sind modulare, in sich geschlossene Pakete, die Claudes Fähigkeiten erweitern, indem sie spezialisiertes Wissen, Workflows und Tools bereitstellen. Stellen Sie sie sich als „Onboarding-Leitfäden“ für bestimmte Domänen oder Aufgaben vor – sie verwandeln Claude von einem Generalisten-Agenten in einen spezialisierten Agenten, der mit prozeduralem Wissen ausgestattet ist, über das kein Modell vollständig verfügen kann.

Was Skills bieten

1. Spezialisierte Workflows - Mehrschrittige Verfahren für bestimmte Domänen
2. Tool-Integrationen - Anweisungen zur Arbeit mit bestimmten Dateiformaten oder APIs
3. Domänenexpertise - Unternehmensspezifisches Wissen, Schemata, Geschäftslogik
4. Gebündelte Ressourcen - Skripte, Referenzen und Assets für komplexe und wiederkehrende Aufgaben

Anatomie eines Skills

Jeder Skill besteht aus einer erforderlichen SKILL.md-Datei und optionalen gebündelten Ressourcen:

skill-name/
├── SKILL.md (erforderlich)
│   ├── YAML-Frontmatter-Metadaten (erforderlich)
│   │   ├── name: (erforderlich)
│   │   └── description: (erforderlich)
│   └── Markdown-Anweisungen (erforderlich)
└── Gebündelte Ressourcen (optional)
    ├── scripts/          - Ausführbarer Code (Python/Bash/etc.)
    ├── references/       - Dokumentation, die nach Bedarf in den Kontext geladen wird
    └── assets/           - Dateien, die in der Ausgabe verwendet werden (Vorlagen, Symbole, Schriftarten, etc.)

SKILL.md (erforderlich)

Metadaten-Qualität: Die Felder name und description im YAML-Frontmatter bestimmen, wann Claude den Skill verwendet. Die Beschreibung sollte präzise sein und angeben, was der Skill tut und wann er eingesetzt werden soll. Verwenden Sie die dritte Person (z.B. „Dieses Skill sollte verwendet werden, wenn...“ statt „Verwenden Sie dieses Skill, wenn...“).

Gebündelte Ressourcen (optional)

Skripte (scripts/)

Ausführbarer Code (Python/Bash/etc.) für Aufgaben, die deterministische Zuverlässigkeit erfordern oder wiederholt neu geschrieben werden.

• Wann einbinden: Wenn derselbe Code wiederholt neu geschrieben wird oder deterministische Zuverlässigkeit erforderlich ist
• Beispiel: scripts/rotate_pdf.py für PDF-Drehaufgaben
• Vorteile: Token-effizient, deterministisch, kann ohne Laden in den Kontext ausgeführt werden
• Hinweis: Skripte müssen möglicherweise von Claude gelesen werden, um Patches oder umgebungsspezifische Anpassungen vorzunehmen

Referenzen (references/)

Dokumentation und Referenzmaterial, das nach Bedarf in den Kontext geladen wird, um Claudes Vorgehen und Denkweise zu informieren.

• Wann einbinden: Für Dokumentation, auf die Claude während der Arbeit zurückgreifen soll
• Beispiele: references/finance.md für Finanzschemata, references/mnda.md für die unternehmenseigene NDA-Vorlage, references/policies.md für Unternehmensrichtlinien, references/api_docs.md für API-Spezifikationen
• Anwendungsfälle: Datenbankschemata, API-Dokumentation, Domänenwissen, Unternehmensrichtlinien, detaillierte Workflow-Anleitungen
• Vorteile: Hält SKILL.md schlank, wird nur geladen, wenn Claude es für nötig hält
• Bewährte Praxis: Bei großen Dateien (>10.000 Wörter) sollten grep-Suchmuster in SKILL.md eingefügt werden
• Duplikate vermeiden: Informationen sollten entweder in SKILL.md oder in Referenzdateien leben, nicht in beiden. Für detaillierte Informationen sind Referenzdateien zu bevorzugen, es sei denn, sie sind wirklich zentral für den Skill – das hält SKILL.md schlank und macht Informationen auffindbar, ohne den Kontextfenster zu belasten. Nur wesentliche Verfahrensanweisungen und Workflow-Anleitungen in SKILL.md belassen; detailliertes Referenzmaterial, Schemata und Beispiele in Referenzdateien auslagern.

Assets (assets/)

Dateien, die nicht in den Kontext geladen, sondern in der von Claude erstellten Ausgabe verwendet werden sollen.

• Wann einbinden: Wenn der Skill Dateien benötigt, die in der endgültigen Ausgabe verwendet werden
• Beispiele: assets/logo.png für Marken-Assets, assets/slides.pptx für PowerPoint-Vorlagen, assets/frontend-template/ für HTML/React-Boilerplate, assets/font.ttf für Typografie
• Anwendungsfälle: Vorlagen, Bilder, Symbole, Boilerplate-Code, Schriftarten, Beispieldokumente, die kopiert oder geändert werden
• Vorteile: Trennt Ausgaberessourcen von der Dokumentation, ermöglicht Claude die Verwendung von Dateien ohne Laden in den Kontext

Progressives Offenlegungs-Designprinzip

Skills verwenden ein dreistufiges Ladesystem zur effizienten Kontextverwaltung:

1. Metadaten (name + description) - Immer im Kontext (~100 Wörter)
2. SKILL.md-Rumpf - Wenn der Skill ausgelöst wird (<5.000 Wörter)
3. Gebündelte Ressourcen - Nach Bedarf von Claude (Unbegrenzt*)

*Unbegrenzt, da Skripte ausgeführt werden können, ohne in das Kontextfenster eingelesen zu werden.

Skill-Erstellungsprozess

Um einen Skill zu erstellen, befolgen Sie den „Skill-Erstellungsprozess“ in der angegebenen Reihenfolge. Überspringen Sie Schritte nur, wenn es einen klaren Grund gibt, warum sie nicht anwendbar sind.

Schritt 1: Den Skill mit konkreten Beispielen verstehen

Diesen Schritt nur überspringen, wenn die Nutzungsmuster des Skills bereits klar verstanden sind. Er bleibt auch bei der Arbeit mit einem bestehenden Skill wertvoll.

Um einen effektiven Skill zu erstellen, müssen konkrete Beispiele für die Verwendung des Skills klar verstanden werden. Dieses Verständnis kann entweder aus direkten Benutzerbeispielen oder aus generierten Beispielen stammen, die durch Benutzerfeedback validiert werden.

Beim Erstellen eines Bildbearbeitungs-Skills sind beispielsweise relevante Fragen:

• „Welche Funktionalität soll der Bildbearbeitungs-Skill unterstützen? Bearbeiten, Drehen, etwas anderes?“
• „Können Sie einige Beispiele nennen, wie dieser Skill verwendet würde?“
• „Ich kann mir vorstellen, dass Benutzer Dinge wie 'Entferne den Rote-Augen-Effekt aus diesem Bild' oder 'Drehe dieses Bild' fragen. Gibt es andere Arten, wie Sie sich die Verwendung dieses Skills vorstellen?“
• „Was würde ein Benutzer sagen, das diesen Skill auslösen sollte?“

Um Benutzer nicht zu überfordern, sollten Sie vermeiden, zu viele Fragen in einer einzigen Nachricht zu stellen. Beginnen Sie mit den wichtigsten Fragen und fragen Sie bei Bedarf nach, um die Effektivität zu verbessern.

Schließen Sie diesen Schritt ab, wenn ein klares Verständnis der Funktionalität besteht, die der Skill unterstützen soll.

Schritt 2: Planung der wiederverwendbaren Skill-Inhalte

Um konkrete Beispiele in einen effektiven Skill zu verwandeln, analysieren Sie jedes Beispiel wie folgt:

1. Überlegen, wie das Beispiel von Grund auf ausgeführt werden kann
2. Identifizieren, welche Skripte, Referenzen und Assets bei der wiederholten Ausführung dieser Workflows hilfreich wären

Beispiel: Beim Erstellen eines pdf-editor-Skills zur Bearbeitung von Anfragen wie „Hilf mir, dieses PDF zu drehen“ zeigt die Analyse:

1. Das Drehen eines PDFs erfordert jedes Mal das erneute Schreiben desselben Codes
2. Ein Skript scripts/rotate_pdf.py wäre hilfreich, um es im Skill zu speichern

Beispiel: Beim Entwerfen eines frontend-webapp-builder-Skills für Anfragen wie „Erstelle mir eine Todo-App“ oder „Erstelle mir ein Dashboard zum Verfolgen meiner Schritte“ zeigt die Analyse:

1. Das Schreiben einer Frontend-Web-App erfordert jedes Mal dasselbe HTML/React-Boilerplate
2. Eine Vorlage assets/hello-world/ mit den Boilerplate-HTML/React-Projektdateien wäre hilfreich, um sie im Skill zu speichern

Beispiel: Beim Erstellen eines big-query-Skills zur Bearbeitung von Anfragen wie „Wie viele Benutzer haben sich heute angemeldet?“ zeigt die Analyse:

1. Das Abfragen von BigQuery erfordert jedes Mal das erneute Entdecken der Tabellenschemata und Beziehungen
2. Eine Referenzdatei references/schema.md mit den Tabellenschemata wäre hilfreich, um sie im Skill zu speichern

Um die Skill-Inhalte festzulegen, analysieren Sie jedes konkrete Beispiel, um eine Liste der wiederzuverwendenden Ressourcen zu erstellen: Skripte, Referenzen und Assets.

Schritt 3: Den Skill initialisieren

Nun ist es an der Zeit, den Skill tatsächlich zu erstellen.

Diesen Schritt nur überspringen, wenn der zu entwickelnde Skill bereits existiert und eine Iteration oder Paketierung erforderlich ist. In diesem Fall fahren Sie mit dem nächsten Schritt fort.

Beim Erstellen eines neuen Skills von Grund auf sollte immer das Skript init_skill.py ausgeführt werden. Das Skript generiert bequem ein neues Vorlagen-Skill-Verzeichnis, das automatisch alles enthält, was ein Skill benötigt, und den Erstellungsprozess viel effizienter und zuverlässiger macht.

Verwendung:

scripts/init_skill.py <skill-name> --path <output-verzeichnis>

Das Skript:

• Erstellt das Skill-Verzeichnis im angegebenen Pfad
• Generiert eine SKILL.md-Vorlage mit korrektem Frontmatter und TODO-Platzhaltern
• Erstellt Beispiel-Ressourcenverzeichnisse: scripts/, references/ und assets/
• Fügt in jedem Verzeichnis Beispieldateien hinzu, die angepasst oder gelöscht werden können

Nach der Initialisierung passen Sie die generierte SKILL.md und die Beispieldateien nach Bedarf an oder löschen Sie sie.

Schritt 4: Den Skill bearbeiten

Beim Bearbeiten des (neu generierten oder bestehenden) Skills ist zu bedenken, dass der Skill für eine andere Instanz von Claude erstellt wird. Konzentrieren Sie sich darauf, Informationen aufzunehmen, die für Claude nützlich und nicht offensichtlich sind. Überlegen Sie, welches prozedurale Wissen, welche domänenspezifischen Details oder wiederverwendbaren Assets einer anderen Claude-Instanz helfen würden, diese Aufgaben effektiver auszuführen.

Beginnen Sie mit den wiederverwendbaren Skill-Inhalten

Um mit der Implementierung zu beginnen, starten Sie mit den oben identifizierten wiederverwendbaren Ressourcen: scripts/, references/ und assets/-Dateien. Beachten Sie, dass dieser Schritt Benutzereingaben erfordern kann. Beispielsweise muss der Benutzer bei der Implementierung eines brand-guidelines-Skills möglicherweise Marken-Assets oder Vorlagen bereitstellen, die in assets/ gespeichert werden, oder Dokumentation, die in references/ gespeichert wird.

Löschen Sie außerdem alle Beispieldateien und -verzeichnisse, die für den Skill nicht benötigt werden. Das Initialisierungsskript erstellt Beispieldateien in scripts/, references/ und assets/, um die Struktur zu demonstrieren, aber die meisten Skills werden nicht alle davon benötigen.

SKILL.md aktualisieren

Schreibstil: Schreiben Sie den gesamten Skill im imperativen/infinitiven Stil (verb-erste Anweisungen), nicht in der zweiten Person. Verwenden Sie eine objektive, anleitende Sprache (z.B. „Um X zu erreichen, machen Sie Y“ anstelle von „Sie sollten X tun“ oder „Wenn Sie X tun müssen“). Dies gewährleistet Konsistenz und Klarheit für die KI-Nutzung.

Um SKILL.md zu vervollständigen, beantworten Sie die folgenden Fragen:

1. Was ist der Zweck des Skills, in wenigen Sätzen?
2. Wann sollte der Skill verwendet werden?
3. Wie sollte Claude den Skill in der Praxis anwenden? Alle oben entwickelten wiederverwendbaren Skill-Inhalte sollten referenziert werden, damit Claude weiß, wie er sie verwendet.

Schritt 5: Einen Skill paketieren

Sobald der Skill fertig ist, sollte er in eine verteilbare ZIP-Datei verpackt werden, die dem Benutzer zur Verfügung gestellt wird. Der Paketierungsprozess validiert den Skill automatisch, um sicherzustellen, dass er alle Anforderungen erfüllt:

scripts/package_skill.py <pfad/zu/skill-ordner>

Optionale Angabe des Ausgabeverzeichnisses:

scripts/package_skill.py <pfad/zu/skill-ordner> ./dist

Das Paketierungsskript führt Folgendes aus:

1. Validieren des Skills automatisch, wobei Folgendes geprüft wird:

   • YAML-Frontmatter-Format und erforderliche Felder
   • Skill-Namenskonventionen und Verzeichnisstruktur
   • Vollständigkeit und Qualität der Beschreibung
   • Dateiorganisation und Ressourcenverweise

2. Paketieren des Skills bei erfolgreicher Validierung, wodurch eine ZIP-Datei erstellt wird, die nach dem Skill benannt ist (z.B. my-skill.zip), die alle Dateien enthält und die korrekte Verzeichnisstruktur für die Verteilung beibehält.

Wenn die Validierung fehlschlägt, meldet das Skript die Fehler und beendet sich, ohne ein Paket zu erstellen. Beheben Sie die Validierungsfehler und führen Sie den Paketierungsbefehl erneut aus.

Schritt 6: Iterieren

Nach dem Testen des Skills können Benutzer Verbesserungen wünschen. Dies geschieht oft unmittelbar nach der Verwendung des Skills, mit frischem Kontext darüber, wie der Skill abgeschnitten hat.

Iterations-Workflow:

1. Den Skill für reale Aufgaben verwenden
2. Schwierigkeiten oder Ineffizienzen erkennen
3. Identifizieren, wie SKILL.md oder gebündelte Ressourcen aktualisiert werden sollten
4. Änderungen implementieren und erneut testen