Nova Skill Creator — Skill Engineer Protocol v2.2
Version 2.4.1 · Muster: Sequenzieller Workflow · Typ: Code-Gerüstbau & Vorlagen
„Skill Engineer Protocol v2.2" ist der Name des Prozesses, dem dieser Skill folgt, nicht die Versionsnummer.
Zweck
Dieser Meta-Skill verwandelt jede anforderungsbezogene Fähigkeit (neu schreiben / aktualisieren / bearbeiten / überprüfen) in einen standardisierten Engineering-Prozess und produziert eine professionelle Fähigkeit, die sofort bereitgestellt werden kann. Jede Ausgabefähigkeit ist ein eigenständiger „virtueller Mitarbeiter": entweder 1 SKILL.md-Datei oder 1 vollständiger Ordner, abhängig von der Komplexität und der Zielumgebung.
Wenn dieser Skill aktiviert wird, beginnen Sie die Antwort mit genau diesem Satz: „Skill Engineer Protocol v2.2 aktiviert. Starte den Standardprozess..."
Antworten Sie nach diesem Satz in der Sprache, in der der Benutzer schreibt.
⚠️ Inhalt beim Umschreiben bewahren (OBERSTE REGEL)
„Vollständig umschreiben" bedeutet umstrukturieren, NICHT komprimieren/zusammenfassen. Wenn dieser Skill mit einem anderen LLM (insbesondere einem schwächeren Modell) angewendet wird, ist der häufigste Fehler, dass technische Beschreibungen komprimiert, Tabellenspalten abgeschnitten und konkrete Schemata/Werte weggelassen werden – die Ausgabe sieht ordentlicher aus, hat aber ursprünglichen Inhalt verloren.
Verbindliche Unterscheidung:
| Umstrukturieren (RICHTIG) | Komprimieren (FALSCH) |
|---|---|
| Layout ändern, doppelte Abschnitte zusammenführen, Formulierung korrigieren | Tabellen, Zeilen, Spalten, Beispiele weglassen |
| Jeden Wert/jedes Schema/jede ID/jede Regel genau beibehalten | Ein Schema in „ungefähr" paraphrasieren |
| Anzahl der Ausgabeelemente >= Anzahl der Eingabeelemente | 10 Fallstricke auf 4 reduzieren |
| Klarheit erhöhen | Details reduzieren „um es kürzer zu machen" |
3-Schritte-Anti-Komprimierungsprozess – VERPFLICHTEND vor/nach jedem Umschreiben oder Aktualisieren:
- Zuerst inventarisieren (Inhaltsinventar): Listen Sie jedes ursprüngliche Element auf, das NICHT verloren gehen darf – jede Tabelle (mit ihrer Zeilen-/Spaltenanzahl), jede Schema-Regel, jeder konkrete Wert (ID, Version, Option), jeder Fallstrick, jeder Testfall. Schreiben Sie es als Checkliste auf.
- Eingeschränktes Umschreiben: Während des Umschreibens muss jedes Element in der Liste vollständig in der Ausgabe erscheinen. Sie dürfen die Präsentation verbessern; Sie dürfen NICHT die Anzahl der Elemente oder die Details eines Elements reduzieren.
- Anschließend prüfen (Diff-Prüfung): Vergleichen Sie die Ausgabe mit dem Inventar. Wenn ein Element fehlt oder eine Tabelle weniger Zeilen/Spalten als das Original hat → NICHT FERTIG; stellen Sie es wieder her, bevor Sie antworten.
Selbstbindende Anweisung für das ausführende LLM: „Bewahren Sie jede Tabelle, jedes Schema, jeden konkreten Wert und jeden Fallstrick wörtlich. Fassen Sie nicht zusammen, lassen Sie keine technischen Details weg. Wenn es kürzer sein muss, TEILEN Sie es in references/ auf; löschen Sie NIEMALS Inhalt."
Ein Skill ist ein Ordner – wählen Sie die Struktur nach Komplexität
Claude, Claude Code und andere Agenten unterstützen Fähigkeiten als Ordner mit SKILL.md + gebündelten Ressourcen, mit Progressiver Offenlegung (Ressourcen werden bei Bedarf geladen), offline ausführbaren Skripten und dynamisch geladenen references/. Sie müssen nicht alles in eine Datei packen.
| Komplexität | Empfohlene Struktur |
|---|---|
| Einfache, kurze Fähigkeit | Nur 1 SKILL.md-Datei (trotzdem gültig) |
| Fähigkeit mit sich wiederholender/deterministischer Logik | Ordner + scripts/ |
| Multidomänen-Fähigkeit / lange Dokumentation | Ordner + references/, nach Variante aufgeteilt |
| Fähigkeit, die gebündelte Dateien ausgibt (Vorlagen/Icons/Schriftarten) | Ordner + assets/ |
Prinzip: Wählen Sie die kleinste Struktur, die ausreicht. Einfach → 1 Datei; komplex → in einen Ordner aufteilen, um SKILL.md schlank zu halten. Wenn der Inhalt zu lang ist → in references/ AUFTEILEN, NICHT wegkomprimieren.
Anatomie eines Skills
skill-name-kebab-case/
├── SKILL.md (erforderlich)
│ ├── YAML-Frontmatter (5 Felder für Konten/freie LLMs · NUR Name + Beschreibung für Standard-Agent-Fähigkeiten – siehe ‚Varianten nach ZIELUMGEBUNG‘)
│ └── Markdown-Anweisungen
└── Gebündelte Ressourcen (optional)
├── scripts/ - Ausführbarer Code für deterministische/wiederkehrende Aufgaben
├── references/ - Dokumente, die bei Bedarf in den Kontext geladen werden
└── assets/ - Dateien, die in der Ausgabe verwendet werden (Vorlage, Symbol, Schriftart)
Progressive Offenlegung (3 Ladeebenen)
| Ebene | Inhalt | Wann in den Kontext gelangt |
|---|---|---|
| 1 | Metadaten (name + description) | Immer (~100 Wörter) |
| 2 | SKILL.md-Rumpf | Wenn der Skill aktiviert wird (idealerweise unter 500 Zeilen) |
| 3 | Gebündelte Ressourcen | Bei Bedarf (references/ laden dynamisch; scripts/ werden ausgeführt, ohne ihren Inhalt in den Kontext zu laden) |
Regel: Halten Sie den SKILL.md-Rumpf unter 500 Zeilen. Wenn Sie sich der Grenze nähern → in references/ aufteilen und einen klaren Verweis in SKILL.md hinterlassen, der angibt, wo gelesen werden soll. Eine lange Referenz (>300 Zeilen) sollte ein Inhaltsverzeichnis haben. Aufteilen ist ANDERS als Komprimieren – Aufteilen bewahrt den Inhalt intakt in einer anderen Datei, Komprimieren verliert Inhalt.
EINE NEUE FÄHIGKEIT SCHREIBEN – Prozess (8 Schritte)
| # | Schritt | Beschreibung |
|---|---|---|
| 1 | Nach fehlenden Informationen fragen | Ziel, Fallstricke, Sprache, Ausgabe, Zielumgebung. Wenn die Konversation bereits den Workflow enthält → zuerst aus dem Verlauf extrahieren, nur nach Fehlendem fragen |
| 2 | 1 Muster + 1 Fähigkeitstyp auswählen | Genau 1 von jedem (siehe Listen unten) |
| 3 | Zuerst die BESCHREIBUNG schreiben | Der wichtigste Schritt – befolgen Sie das Beschreibungsprotokoll unten |
| 4 | Die Struktur wählen + den Inhalt entwerfen | Einzeldatei oder Ordner? Was bleibt inline, was kommt in references/, welche Logik wird scripts/? |
| 5 | SKILL.md schreiben | YAML + Workflow + Regeln/Schema + Fallstricke; Rumpf unter 500 Zeilen, lange Teile in Referenzen auslagern |
| 6 | Skripte/Referenzen schreiben (falls erforderlich) | Deterministische/wiederkehrende Logik → scripts/; lange Dokumentation → references/ mit Verweisen |
| 7 | Aktivierung testen | 3 positive + 3 negative Fälle |
| 8 | Mit dem Ausgabeformat antworten | Siehe Abschnitt Ausgabeformat unten |
NUR FREIGEBEN, wenn alle 14/14 Checklistenpunkte bestanden sind.
AKTUALISIEREN / BEARBEITEN – Prozess (8 Schritte)
- Lesen Sie die gesamte aktuelle SKILL.md (und ihre gebündelten Dateien).
- Zuerst inventarisieren – Listen Sie jede Tabelle/jedes Schema/jeden Wert/jeden Fallstrick/jeden Testfall auf, der NICHT verloren gehen darf (Oberste Regel, Schritt 1).
- Notieren Sie Fallstricke vom Benutzer und aus früheren Durchläufen.
- Bewerten Sie anhand der 14-Punkte-Checkliste.
- Identifizieren Sie die Fehlerart: Zu wenig Auslösung / Zu viel Auslösung / Ausführungsfehler / Inhaltsverlust (Komprimierung/Abschneidung).
- Alles unter der Bewahrungsbeschränkung umschreiben – umstrukturieren, NICHT komprimieren. NIEMALS stückweise patchen.
- Anschließend prüfen – die Ausgabe mit dem Inventar abgleichen, fehlende Elemente wiederherstellen.
- 3 positive + 3 negative Fälle erneut testen,
versionerhöhen.
Eiserne Regel: Vollständig umschreiben = Umstrukturieren, das den gesamten Inhalt behält. Keine Flickarbeit. Keine Komprimierung von Details. Behalten Sie den alten name beim Aktualisieren bei.
YAML-Frontmatter (VERPFLICHTEND)
---
name: skill-name-kebab-case
version: x.x.x
description: >-
[Beschreibung optimiert für Aktivierung, unter 1024 Zeichen, einfaches ASCII ohne Diakritika, ohne spitze Klammern]
pattern: [1 der 5 Muster]
type: [1 der 9 Fähigkeitstypen]
---
Varianten nach ZIELUMGEBUNG (vor dem Schreiben des Frontmatters fragen)
Der 5-Felder-Block oben ist die Vorlage für claude.ai-Konten / Grok / freie LLMs. Einige Ziele akzeptieren genau 2 Felder – die 5-Felder-Version dort einzureichen, schlägt sofort bei der Validierung fehl, bevor die Überprüfung überhaupt beginnt. Schritt 1 (Sammeln) MUSS nach dem Ziel fragen oder es ableiten; wenn unklar, standardmäßig die 2-Felder-Version verwenden, da die 2-Felder-Version auf jedem Ziel funktioniert, die 5-Felder-Version jedoch nicht.
| Ziel | Frontmatter | Wo Version / Muster / Typ hinkommen |
|---|---|---|
| claude.ai-Konto, Grok, andere LLMs | 5 Felder wie in der Vorlage oben, description gefaltet >- | im YAML |
Standard-Agent-Fähigkeiten (Claude Code .claude/skills, Codex .agents/skills) und Skill-Registries mit strenger Validierung | NUR name + description, jeweils in EINER Zeile – kein >-, keine eingerückten Zeilen, kein drittes Feld | eine Blockquote-Zeile direkt unter der H1: > **Version x.y.z** · Muster: … · Typ: …; die echte Version lebt in der Registry/Manifest-Datei des Zielsystems (falls vorhanden) |
Vorlage für Agent-Fähigkeiten-Ziele:
---
name: skill-name-kebab-case
description: "[Beschreibung optimiert für Aktivierung, EINE Zeile, >= 40 Zeichen, einfaches ASCII ohne Diakritika, ohne spitze Klammern]"
---
Eine einzeilige description immer in doppelte Anführungszeichen setzen. Claude Code und Codex lesen das Frontmatter mit einem echten YAML-Parser. Bei einem nackten Wert gibt es zwei Arten von Fehlern. (1) Parse-Fehler – der Skill wird mit leeren Metadaten und ohne Warnung geladen: ein : in der Mitte (z. B. Vi du: … oder Beispiel: …), ein : am Ende, beginnend mit [ { > | ' " * ! % @ , oder einem Backtick, oder beginnend mit - ? : (das Zeichen gefolgt von einem Leerzeichen). (2) Stille Bedeutungsänderung – es wird geparst, ist aber falsch: beginnend mit # macht die Beschreibung leer, # in der Mitte schneidet den Rest ab, beginnend mit & verwandelt es in einen Anchor. Doppelte Anführungszeichen vermeiden beides; innerhalb der doppelten Anführungszeichen kein " oder \ verwenden.
Registries mit strenger Validierung blockieren oft auch: absolute Pfade mit einem Windows-Laufwerksbuchstaben (Laufwerk + Doppelpunkt + Schrägstrich – schreiben Sie <root>/… anstelle der fest codierten Angabe eines Laufwerks), Zeichenfolgen, die wie Anmeldeinformationen aussehen, defekte Markdown-Links innerhalb des Pakets und jedes .py-Skript, das stdout/stderr nicht zu UTF-8 zwingt. Unabhängige Überprüfungen lehnen auch oft Syntax ab, die nur in der claude.ai-Sandbox funktioniert (/mnt/skills/…, /mnt/user-data/outputs/, present_files, extract-text) – schreiben Sie host-neutrale Anweisungen.
5 Muster (genau 1 auswählen)
Sequenzieller Workflow | Multi-MCP-Koordination | Iterative Verfeinerung | Kontextbewusste Werkzeugauswahl | Domänenspezifische Intelligenz
9 Fähigkeitstypen (genau 1 auswählen)
Bibliotheks- & API-Referenz | Produktüberprüfung | Code-Gerüstbau & Vorlagen | Geschäftsprozessautomatisierung | Datenabruf & -analyse | Codequalität & Überprüfung | CI/CD & Bereitstellung | Runbooks | Infrastrukturoperationen
Beschreibungs-Schreibprotokoll (VERPFLICHTEND)
Ziel: Aktivierungsrate 72–90 %.
| Anforderung | Detail |
|---|---|
| Auslösephrasen | Mindestens 5 Phrasen (in jeder Sprache, die Ihre Benutzer schreiben, falls nötig romanisiert, z. B. Englisch + Vietnamesisch) |
| Stil | Situativ: „Verwenden, wenn der Benutzer ... möchte", „IMMER wenn ..." |
| Reale Beispiele | Mindestens ein paar Beispielaufforderungen, die Benutzer tatsächlich eingeben |
| Länge | Unter 1024 Zeichen |
| Keine Diakritika | Nur YAML-Felder: einfaches ASCII – jeden akzentuierten Buchstaben und jedes Tonzeichen entfernen (z. B. Vietnamesisch ă â ê ô ơ ư đ). Für Sprachen, die nicht in lateinischer Schrift geschrieben werden, romanisierte oder englische Auslösephrasen verwenden |
| Keine spitzen Klammern | Niemals öffnende/schließende spitze Klammern verwenden |
| Negativer Blocker | Mit einem Blocksatz enden: „Nicht verwenden, wenn ..." |
Beispiel einer Standardbeschreibung (einfaches ASCII):
Verwenden, wenn der Benutzer Inhalte zu einem KI-Wiki in Notion hinzufügen, KI-Wissen speichern,
Artikellinks, Notizen, Tools, Aufforderungen klassifizieren möchte. IMMER wenn der Benutzer einen Link,
eine Notiz, einen Toolnamen oder eine KI-Aufforderung zum Aufbewahren einfügt. Beispiele -
diesen Link im Wiki speichern, dieses Tool zu Notion hinzufügen, diese Aufforderung aufbewahren,
diesen Artikel speichern. Nicht verwenden, wenn der Benutzer nur eine Wissensfrage stellt oder
neue Inhalte anfordert, ohne die Absicht zu speichern.
14-Punkte-Checkliste (TOR – 14/14 erforderlich)
| # | Kriterium | Bestanden, wenn |
|---|---|---|
| 1 | name ist korrektes Kebab-Case und enthält nicht „claude"/"anthropic" | ☐ |
| 2 | YAML hat name + version + description (+ pattern + type) | ☐ |
| 3 | description erfüllt vollständig das Beschreibungs-Schreibprotokoll | ☐ |
| 4 | Keine spitzen Klammern in der Beschreibung | ☐ |
| 5 | SKILL.md-Rumpf unter 500 Zeilen (lange Teile in Referenzen ausgelagert) | ☐ |
| 6 | Genau 1 Muster + 1 Fähigkeitstyp ausgewählt | ☐ |
| 7 | Vermittelt keine Grundlagen, die die KI bereits kennt | ☐ |
| 8 | Hat echte Fallstricke (mindestens 5) | ☐ |
| 9 | Struktur passt zum Bedarf: lange Dokumentation in references/ mit klaren Verweisen aufgeteilt | ☐ |
| 10 | Wiederkehrende/deterministische Logik als scripts/ verpackt, anstatt von Hand beschrieben | ☐ |
| 11 | Beschreibung optimiert für Aktivierung + hat einen negativen Blocker | ☐ |
| 12 | 3 positive + 3 negative Fälle getestet | ☐ |
| 13 | Vollständig umgeschrieben (kein Patchen), wenn es sich um ein Upgrade handelt | ☐ |
| 14 | Diff-Prüfung durchgeführt: jede ursprüngliche Tabelle/jedes Schema/jeder Wert/jeder Fallstrick/jeder Testfall ist noch vollständig, nichts komprimiert oder abgeschnitten | ☐ |
Antworten Sie dem Benutzer nur, wenn alle 14/14 bestanden sind.
6 Goldene Prinzipien
- Nichts lehren, was die KI bereits weiß – sich nur auf den spezifischen Kontext + Fallstricke konzentrieren.
- Fallstricke sind das wertvollste Gut – jeden wiederholten Fehler notieren.
- Ständig aktualisieren – jeder Fehler = ein neuer Fallstrick → sofort aktualisieren.
- Kleinste Struktur, die ausreicht – einfach = 1 Datei, komplex = in einen Ordner aufteilen und Progressive Offenlegung verwenden.
- Vollständig umschreiben = umstrukturieren, nicht komprimieren – technischen Inhalt vollständig bewahren; wenn zu lang, in Referenzen aufteilen, nicht wegkomprimieren.
- Nie stückweise patchen.
Ausgabeformat bei der Antwort an den Benutzer (VERPFLICHTEND, in dieser Reihenfolge)
- Skill-Zusammenfassung – Zweck, Muster, Typ, Struktur (Einzeldatei oder Ordner).
- Vollständiger SKILL.md-Inhalt – in einem Codeblock; wenn es ein Ordner ist, auch die
references/- /scripts/- /assets/-Dateien auflisten. - Bereitstellungsanleitung – konkrete Schritte für die Zielumgebung.
- Testergebnisse – 3 positive + 3 negative Fälle.
- Diff-Prüfung – bestätigen, dass kein ursprünglicher Inhalt verloren gegangen ist (wenn es sich um ein Upgrade/Umschreiben handelt).
- Behandelte Fallstricke – wenn es sich um ein Upgrade handelt.
- Version – die Version im YAML.
Bereitstellungsanleitung
Ordner-Skill (Claude Code / Agent / API):
- Erstellen Sie den Ordner
skill-name-kebab-case/. - Legen Sie
SKILL.mdim Stammverzeichnis ab, plus ggf.scripts/,references/,assets/. - Installieren Sie den Skill so, wie es die Umgebung erwartet (Skills-Verzeichnis-Ordner oder ein
.skill-Paket). - Lösen Sie 1 positive Aufforderung aus, um die Aktivierung zu bestätigen.
Einzeldatei-Skill (UI-basierte Plattformen):
- Kopieren Sie den gesamten Inhalt oben in die SKILL.md des Ziels.
- Überprüfen Sie die YAML-Validierung.
- Starten Sie einen Test-Chat.
Testfälle (für diesen Skill)
Positive Fälle (sollte auslösen)
- „Schreibe einen Skill, der Links zu Notion speichert"
- „Erstelle einen Skill, der E-Mails sortiert"
- „Überprüfe, ob dieser Skill dem Standard entspricht"
Negative Fälle (sollte NICHT auslösen)
- „Was ist ein Skill in Claude?"
- „Erkläre das Konzept von KI-Agenten"
- „Schreibe einen Aufsatz über KI"
Fallstricke (für diesen Skill)
| # | Fallstrick | Lösung |
|---|---|---|
| 1 | Benutzer vergisst die Zielumgebung | In Schritt 1 erfragen; auf 2-Felder-Frontmatter zurückfallen, wenn unsicher |
| 2 | LLM komprimiert technische Details | Anti-Komprimierungsprozess mit Inventar anwenden |
| 3 | Frontmatter hat falsche Felder für Agent-Fähigkeiten | Nur name + description verwenden; Version/Muster/Typ in eine Blockquote verschieben |
| 4 | Beschreibung enthält Diakritika oder spitze Klammern | Vor dem Schreiben bereinigen |
| 5 | SKILL.md-Rumpf überschreitet 500 Zeilen | Lange Abschnitte in references/ auslagern |
| 6 | Upgrade patcht nur statt vollständig umzuschreiben | Erzwingen, dass alles umgeschrieben wird; Diff-Prüfung durchführen |
| 7 | Testfälle werden übersprungen | Checkliste erzwingt Testen |
Versionsgeschichte
| Version | Änderungen |
|---|---|
| 2.4.1 | Anti-Komprimierungsprozess hinzugefügt; Supreme Rule formalisiert |
| 2.4.0 | 2-Felder-Frontmatter für Agent-Fähigkeiten hinzugefügt |
| 2.3.0 | Progressive Offenlegung formalisiert |
| 2.2.0 | 14-Punkte-Checkliste als Tor hinzugefügt |
| 2.1.0 | Beschreibungs-Schreibprotokoll hinzugefügt |
| 2.0.0 | Vollständige Überarbeitung des ursprünglichen Skills |
| 1.0.0 | Erste Version |