---
name: skill-new
description: "Legt einen neuen Skill unter `.skills/<name>/` an, mit SKILL.md, eval/test_basic.md und optionaler hook.yaml. Trägt den Skill in `manifest.json` ein und ergänzt die AGENTS.md-Skill-Index-Tabelle. Eval-Test ist Pflicht — ohne ihn wird der Skill nicht aktiviert."
---

# /skill-new — neuen Skill anlegen

Du legst einen neuen Skill im Bundle-Format an. Tool-neutral: derselbe Workflow gilt für Claude Code und Codex.

## Workflow

1. **Namen erfragen.** Kurzer, kebab-case Name (`memory-router`, `output-filter`). Falls der User nur ein Stichwort liefert, in einen Kebab-Case-Namen normalisieren und kurz rückbestätigen.

2. **Trigger-Wörter erfragen.** Mindestens zwei deutsche Trigger-Phrasen, die Claude oder Codex eindeutig auf den Skill leiten sollen. Alternative: leere Trigger-Liste, wenn der Skill nur per `/skill-name` aktiviert wird.

3. **Hook ja oder nein klären.** Wenn der Skill ein Hook ist, zusätzlich Event abfragen (`PreToolUse`, `UserPromptSubmit`, `SessionStart`, `Stop`, `PostToolUse`). Sonst reiner Skill ohne hook.yaml.

4. **Verzeichnis anlegen.** `.skills/<name>/` mit:
   - `SKILL.md` mit Frontmatter (name, description, type: skill, agent_ready: true, schema_version: 1, tags, scope: vault, bundle_skill: true, default_active.allgemein: true, trigger_words, depends_on: [], conflicts_with: [], created, updated) und einem H1-Body, der Workflow und Scope erklärt.
   - `eval/test_basic.md` — Pflicht. Mindestens drei Szenarien (Trigger-Match, Negativ-Fall, Robustheits-Edge).
   - Falls Hook: `hook.yaml` mit name, events, matcher, script, description, tool_support (claude_code: true, codex: false bis Probe).
   - Falls Hook: `scripts/<name>.py` mit PEP-723-Header und `{"action": "allow"}`-Default.

5. **Manifest und AGENTS.md updaten.** `.skills/manifest.json` bekommt einen neuen Skill-Eintrag mit `trigger_words`. Bei Hook zusätzlich `hooks_index`-Eintrag. AGENTS.md-Skill-Index-Tabelle wird um eine Zeile ergänzt — Trigger-Wörter aus dem Manifest und Skill-Pfad eintragen.

6. **Eval-Test prüfen.** `eval/test_basic.md` muss existieren und mindestens drei Szenarien enthalten. Andernfalls Skill nicht aktivieren — User muss zuerst Tests definieren.

7. **Bestätigen.** Pfad des angelegten Skills, Liste der erzeugten Dateien, Hinweis auf nächste Schritte (sync.py-Lauf für Spiegelung).

## Verknüpfungen

- [[AGENTS|AGENTS.md]] — Skill-Index-Tabelle
- [[INDEX|INDEX.md]]
