nova-skill-creator

Verwenden, wenn der Benutzer eine neue Fähigkeit schreiben, eine Fähigkeit erstellen, eine Fähigkeit für einen KI-Agenten bauen, eine Fähigkeit aktualisieren, bearbeiten oder reparieren oder eine Fähigkeit für Claude, Grok oder ein anderes LLM überprüfen und auditieren möchte. IMMER wenn der Benutzer eine Fähigkeit, SKILL.md, eine SOP für KI, einen virtuellen Mitarbeiter oder einen Skill-Ingenieur erwähnt. Beispiele: Schreiben Sie eine Fähigkeit, die Links zu Notion speichert, erstellen Sie eine Fähigkeit, die E-Mails sortiert, aktualisieren Sie diese Fähigkeit auf eine neue Version, überprüfen Sie, ob diese Fähigkeit dem Standard entspricht, beheben Sie den Auslöser dieser Fähigkeit, erstellen Sie eine SKILL.md für diesen Workflow. Nicht verwenden, wenn der Benutzer nur allgemein fragt, was eine Fähigkeit ist, nach KI-Agenten-Konzepten fragt, ohne eine bestimmte Fähigkeit zu entwerfen, oder nach anderen Inhalten fragt, die keine Fähigkeitsdatei sind.

Was ist nova-skill-creator?

Der Nova Skill Creator ist ein Meta-Skill, der jeden anforderungsbezogenen Skill (neu schreiben, aktualisieren, bearbeiten, überprüfen) in einen standardisierten Engineering-Prozess umwandelt. Er produziert professionelle, sofort einsetzbare Fähigkeiten als eigenständige „virtuelle Mitarbeiter“ – entweder als einzelne SKILL.md-Datei oder als vollständigen Ordner mit gebündelten Ressourcen. Der Skill folgt dem „Skill Engineer Protocol v2.2“ und legt großen Wert auf die vollständige Bewahrung von Inhalten: Beim Umschreiben oder Aktualisieren wird eine Anti-Komprimierungsstrategie mit Inhaltsinventar, eingeschränktem Umschreiben und Diff-Prüfung angewendet, um sicherzustellen, dass keine Tabellen, Schemata, konkreten Werte oder Fallstricke verloren gehen. Der Skill unterstützt mehrere Zielumgebungen (z. B. Claude.ai-Konten, Claude Code, Codex) und bietet zwei Varianten der YAML-Frontmatter: eine 5-Felder-Version für freie LLMs und eine 2-Felder-Version für standardisierte Agent-Fähigkeiten. Er umfasst einen 14-Punkte-Checkliste-Gate-Prozess, Beschreibungsrichtlinien zur Erhöhung der Aktivierungsrate, Auswahl aus 5 Patterns und 9 Skill Types sowie eine schrittweise Anleitung für das Schreiben, Aktualisieren und Bereitstellen neuer Fähigkeiten.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/chuong1224/nova-skill-creator/tree/HEAD/skills/nova-skill-creator

Installed? Explore more Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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 korrigierenTabellen, Zeilen, Spalten, Beispiele weglassen
Jeden Wert/jedes Schema/jede ID/jede Regel genau beibehaltenEin Schema in „ungefähr" paraphrasieren
Anzahl der Ausgabeelemente >= Anzahl der Eingabeelemente10 Fallstricke auf 4 reduzieren
Klarheit erhöhenDetails reduzieren „um es kürzer zu machen"

3-Schritte-Anti-Komprimierungsprozess – VERPFLICHTEND vor/nach jedem Umschreiben oder Aktualisieren:

  1. 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.
  2. 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.
  3. 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ätEmpfohlene Struktur
Einfache, kurze FähigkeitNur 1 SKILL.md-Datei (trotzdem gültig)
Fähigkeit mit sich wiederholender/deterministischer LogikOrdner + scripts/
Multidomänen-Fähigkeit / lange DokumentationOrdner + 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)

EbeneInhaltWann in den Kontext gelangt
1Metadaten (name + description)Immer (~100 Wörter)
2SKILL.md-RumpfWenn der Skill aktiviert wird (idealerweise unter 500 Zeilen)
3Gebündelte RessourcenBei 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)

#SchrittBeschreibung
1Nach fehlenden Informationen fragenZiel, Fallstricke, Sprache, Ausgabe, Zielumgebung. Wenn die Konversation bereits den Workflow enthält → zuerst aus dem Verlauf extrahieren, nur nach Fehlendem fragen
21 Muster + 1 Fähigkeitstyp auswählenGenau 1 von jedem (siehe Listen unten)
3Zuerst die BESCHREIBUNG schreibenDer wichtigste Schritt – befolgen Sie das Beschreibungsprotokoll unten
4Die Struktur wählen + den Inhalt entwerfenEinzeldatei oder Ordner? Was bleibt inline, was kommt in references/, welche Logik wird scripts/?
5SKILL.md schreibenYAML + Workflow + Regeln/Schema + Fallstricke; Rumpf unter 500 Zeilen, lange Teile in Referenzen auslagern
6Skripte/Referenzen schreiben (falls erforderlich)Deterministische/wiederkehrende Logik → scripts/; lange Dokumentation → references/ mit Verweisen
7Aktivierung testen3 positive + 3 negative Fälle
8Mit dem Ausgabeformat antwortenSiehe Abschnitt Ausgabeformat unten

NUR FREIGEBEN, wenn alle 14/14 Checklistenpunkte bestanden sind.


AKTUALISIEREN / BEARBEITEN – Prozess (8 Schritte)

  1. Lesen Sie die gesamte aktuelle SKILL.md (und ihre gebündelten Dateien).
  2. Zuerst inventarisieren – Listen Sie jede Tabelle/jedes Schema/jeden Wert/jeden Fallstrick/jeden Testfall auf, der NICHT verloren gehen darf (Oberste Regel, Schritt 1).
  3. Notieren Sie Fallstricke vom Benutzer und aus früheren Durchläufen.
  4. Bewerten Sie anhand der 14-Punkte-Checkliste.
  5. Identifizieren Sie die Fehlerart: Zu wenig Auslösung / Zu viel Auslösung / Ausführungsfehler / Inhaltsverlust (Komprimierung/Abschneidung).
  6. Alles unter der Bewahrungsbeschränkung umschreiben – umstrukturieren, NICHT komprimieren. NIEMALS stückweise patchen.
  7. Anschließend prüfen – die Ausgabe mit dem Inventar abgleichen, fehlende Elemente wiederherstellen.
  8. 3 positive + 3 negative Fälle erneut testen, version erhö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.

ZielFrontmatterWo Version / Muster / Typ hinkommen
claude.ai-Konto, Grok, andere LLMs5 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 ValidierungNUR name + description, jeweils in EINER Zeile – kein >-, keine eingerückten Zeilen, kein drittes Feldeine 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 %.

AnforderungDetail
AuslösephrasenMindestens 5 Phrasen (in jeder Sprache, die Ihre Benutzer schreiben, falls nötig romanisiert, z. B. Englisch + Vietnamesisch)
StilSituativ: „Verwenden, wenn der Benutzer ... möchte", „IMMER wenn ..."
Reale BeispieleMindestens ein paar Beispielaufforderungen, die Benutzer tatsächlich eingeben
LängeUnter 1024 Zeichen
Keine DiakritikaNur 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 KlammernNiemals öffnende/schließende spitze Klammern verwenden
Negativer BlockerMit 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)

#KriteriumBestanden, wenn
1name ist korrektes Kebab-Case und enthält nicht „claude"/"anthropic"☐
2YAML hat name + version + description (+ pattern + type)☐
3description erfüllt vollständig das Beschreibungs-Schreibprotokoll☐
4Keine spitzen Klammern in der Beschreibung☐
5SKILL.md-Rumpf unter 500 Zeilen (lange Teile in Referenzen ausgelagert)☐
6Genau 1 Muster + 1 Fähigkeitstyp ausgewählt☐
7Vermittelt keine Grundlagen, die die KI bereits kennt☐
8Hat echte Fallstricke (mindestens 5)☐
9Struktur passt zum Bedarf: lange Dokumentation in references/ mit klaren Verweisen aufgeteilt☐
10Wiederkehrende/deterministische Logik als scripts/ verpackt, anstatt von Hand beschrieben☐
11Beschreibung optimiert für Aktivierung + hat einen negativen Blocker☐
123 positive + 3 negative Fälle getestet☐
13Vollständig umgeschrieben (kein Patchen), wenn es sich um ein Upgrade handelt☐
14Diff-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

  1. Nichts lehren, was die KI bereits weiß – sich nur auf den spezifischen Kontext + Fallstricke konzentrieren.
  2. Fallstricke sind das wertvollste Gut – jeden wiederholten Fehler notieren.
  3. Ständig aktualisieren – jeder Fehler = ein neuer Fallstrick → sofort aktualisieren.
  4. Kleinste Struktur, die ausreicht – einfach = 1 Datei, komplex = in einen Ordner aufteilen und Progressive Offenlegung verwenden.
  5. Vollständig umschreiben = umstrukturieren, nicht komprimieren – technischen Inhalt vollständig bewahren; wenn zu lang, in Referenzen aufteilen, nicht wegkomprimieren.
  6. Nie stückweise patchen.

Ausgabeformat bei der Antwort an den Benutzer (VERPFLICHTEND, in dieser Reihenfolge)

  1. Skill-Zusammenfassung – Zweck, Muster, Typ, Struktur (Einzeldatei oder Ordner).
  2. Vollständiger SKILL.md-Inhalt – in einem Codeblock; wenn es ein Ordner ist, auch die references/- / scripts/- / assets/-Dateien auflisten.
  3. Bereitstellungsanleitung – konkrete Schritte für die Zielumgebung.
  4. Testergebnisse – 3 positive + 3 negative Fälle.
  5. Diff-Prüfung – bestätigen, dass kein ursprünglicher Inhalt verloren gegangen ist (wenn es sich um ein Upgrade/Umschreiben handelt).
  6. Behandelte Fallstricke – wenn es sich um ein Upgrade handelt.
  7. Version – die Version im YAML.

Bereitstellungsanleitung

Ordner-Skill (Claude Code / Agent / API):

  1. Erstellen Sie den Ordner skill-name-kebab-case/.
  2. Legen Sie SKILL.md im Stammverzeichnis ab, plus ggf. scripts/, references/, assets/.
  3. Installieren Sie den Skill so, wie es die Umgebung erwartet (Skills-Verzeichnis-Ordner oder ein .skill-Paket).
  4. Lösen Sie 1 positive Aufforderung aus, um die Aktivierung zu bestätigen.

Einzeldatei-Skill (UI-basierte Plattformen):

  1. Kopieren Sie den gesamten Inhalt oben in die SKILL.md des Ziels.
  2. Überprüfen Sie die YAML-Validierung.
  3. 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)

#FallstrickLösung
1Benutzer vergisst die ZielumgebungIn Schritt 1 erfragen; auf 2-Felder-Frontmatter zurückfallen, wenn unsicher
2LLM komprimiert technische DetailsAnti-Komprimierungsprozess mit Inventar anwenden
3Frontmatter hat falsche Felder für Agent-FähigkeitenNur name + description verwenden; Version/Muster/Typ in eine Blockquote verschieben
4Beschreibung enthält Diakritika oder spitze KlammernVor dem Schreiben bereinigen
5SKILL.md-Rumpf überschreitet 500 ZeilenLange Abschnitte in references/ auslagern
6Upgrade patcht nur statt vollständig umzuschreibenErzwingen, dass alles umgeschrieben wird; Diff-Prüfung durchführen
7Testfälle werden übersprungenCheckliste erzwingt Testen

Versionsgeschichte

VersionÄnderungen
2.4.1Anti-Komprimierungsprozess hinzugefügt; Supreme Rule formalisiert
2.4.02-Felder-Frontmatter für Agent-Fähigkeiten hinzugefügt
2.3.0Progressive Offenlegung formalisiert
2.2.014-Punkte-Checkliste als Tor hinzugefügt
2.1.0Beschreibungs-Schreibprotokoll hinzugefügt
2.0.0Vollständige Überarbeitung des ursprünglichen Skills
1.0.0Erste Version

Verwandte Skills