---
name: skill-edit
description: "Öffnet einen bestehenden Skill zum Editieren. Beim Speichern wird geprüft, ob `eval/test_basic.md` aktuell ist (Pflicht); fehlt der Eval-Test, wird der Skill nicht aktiviert. Mit `--force` wird die Eval-Test-Pflicht übersprungen — nur für Notfall-Patches."
---

# /skill-edit — Skill editieren

Tool-neutraler Workflow zum kontrollierten Bearbeiten eines bestehenden Skills.

## Workflow

1. **Skill-Namen erfragen** oder aus Kontext ableiten. Falls mehrere Skills passen könnten, die Treffer-Liste zur Auswahl zeigen.

2. **Skill öffnen.** `.skills/<name>/SKILL.md` lesen, Frontmatter und Body anzeigen. Falls Hook: zusätzlich `hook.yaml` und `scripts/<name>.py`.

3. **Edit-Wunsch klären.** Was soll geändert werden — Trigger-Wörter, Workflow-Schritte, Hook-Logik? Bei Hook-Logik-Änderungen explizit fragen, ob die Eval-Szenarien angepasst werden müssen.

4. **Änderung anwenden.** Nur die betroffenen Dateien editieren, `updated`-Frontmatter auf heute setzen.

5. **Eval-Test-Pflicht prüfen.** Vor dem Speichern Pflicht-Check:
   - `eval/test_basic.md` existiert.
   - Mindestens drei Szenarien.
   - Bei substantieller Logik-Änderung: Eval-Datei wurde mit angefasst (Frontmatter `updated` heute) ODER der User hat explizit erklärt, dass keine Eval-Anpassung nötig ist.
   - Bei Verstoß: Skill wird **nicht** aktiviert. User-Hinweis: „Eval-Test fehlt oder ist veraltet. Bitte erst Tests anpassen, dann erneut /skill-edit."
   - Mit `--force` wird die Pflicht übersprungen — nur für Notfall-Patches und mit klarem stderr-Warnhinweis.

6. **Manifest synchron halten.** Wenn `trigger_words` im SKILL.md geändert wurden, in `manifest.json` mitziehen. Wenn der Skill umbenannt wird: AGENTS.md-Skill-Index, manifest.json und das Verzeichnis selbst alle drei anpassen.

7. **Bestätigen.** Geänderte Dateien auflisten. Hinweis: Beim nächsten sync.py-Lauf wird die Änderung in `.claude/skills/` gespiegelt.

## Verknüpfungen

- [[AGENTS|AGENTS.md]]
- [[INDEX|INDEX.md]]
