---
name: skill-entwickeln
description: Entwickelt oder überarbeitet schlanke, modellunabhängige Agent Skills und prüft Struktur, Auslöser, fachliche Referenzen, Ressourcen sowie Laufzeitverknüpfungen. Verwenden, wenn ein Skill neu angelegt, aufgeteilt, vereinfacht, harmonisiert, umbenannt oder in seinem Verhalten geändert werden soll.
---

# Skill entwickeln

Entwickle nur wiederkehrendes Verhalten als Skill. Eine einmalige
Projektentscheidung gehört in einen Task oder ein ADR, eine dauerhaft geltende
Projektregel in die Projektanweisungen.

## Fachliche Grundlage

Die [Agent-Skills-Spezifikation](https://agentskills.io/specification) definiert
den gemeinsamen Kern: ein Verzeichnis mit `SKILL.md`, den Pflichtfeldern `name`
und `description` sowie optionalen Ressourcen. Sie empfiehlt Progressive
Disclosure, damit Details nur bei Bedarf geladen werden.

[Codex](https://developers.openai.com/plugins/build/skills) und
[Claude Code](https://code.claude.com/docs/en/skills) verwenden diesen Kern.
Laufzeitspezifische Metadaten dürfen ihn ergänzen, aber keine wesentlichen
Anweisungen duplizieren.

## Ablauf

1. Suche nach Projektanweisungen, dem aktuellen Task, Skill-Verzeichnissen und
   einem betroffenen bestehenden Skill. Prüfe dafür insbesondere
   `AGENTS.md`, `CLAUDE.md`, `PROJECT_GUIDE.md`, `README.md` und vorhandene
   Skill-Verknüpfungen. Kläre den Zielpfad, wenn daraus keine Konvention
   erkennbar ist. Prüfe vor Änderungen Git-Status und Nutzeränderungen.
2. Benenne mindestens einen konkreten Auslöser und das erwartete überprüfbare
   Ergebnis. Ist nur ein einmaliger Fall erkennbar, erstelle keinen Skill.
3. Prüfe, ob ein bestehender Skill erweitert werden kann, ohne deutlich
   verschiedene Zwecke zu vermischen. Bevorzuge wenige merkbare Skills.
4. Suche für fachliche Regeln nach einer Primärquelle oder anerkannten Praxis.
   Verlinke sie direkt im `SKILL.md` und kennzeichne eigene
   Projektkonventionen als solche.
5. Verwende einen kurzen, handlungsorientierten Namen aus Kleinbuchstaben,
   Ziffern und Bindestrichen. Verzeichnisname und `name` müssen übereinstimmen.
6. Nutze den im Projekt vorgesehenen Generator, wenn einer dokumentiert ist.
   Ist kein Generator vorgesehen, lege das minimale Verzeichnis mit `SKILL.md`
   nach der Agent-Skills-Spezifikation an. Fehlt ein erwartetes Werkzeug oder
   eine Abhängigkeit, stoppe und frage vor der Installation um Erlaubnis.
7. Beschränke das Frontmatter für breite Kompatibilität auf `name` und
   `description`, sofern das Projekt nichts anderes verlangt. Beschreibe in
   `description`, was der Skill tut und wann er verwendet wird.
8. Schreibe den Ablauf imperativ, knapp und mit passender Freiheit. Lege
   `scripts/`, `references/` oder `assets/` nur an, wenn wiederkehrender Inhalt
   dadurch zuverlässiger oder kürzer wird.
9. Halte den modellunabhängigen Inhalt im `SKILL.md`. Ergänze
   laufzeitspezifische Metadaten nur ausserhalb dieses Kerns und dupliziere
   dort keine wesentlichen Anweisungen.
10. Ermittle Kataloge, Manifeste und Laufzeitverknüpfungen anhand bestehender
    Skills und Projektanweisungen. Aktualisiere nur die tatsächlich verwendeten
    Mechanismen sowie betroffene Regeln, Vorlagen und verwandte Skills.
    Vermeide dieselbe Regel an mehreren inhaltlichen Quellen.
11. Nutze den dokumentierten Validator. Fehlt er, stoppe und frage vor seiner
    Installation um Erlaubnis. Prüfe zusätzlich alle Verknüpfungen und führe
    eine realistische Gegenprobe aus, wenn der Skill Werkzeuge aufruft,
    zwischen mehreren Abläufen entscheidet, Stoppregeln enthält oder
    wesentliches fachliches Ermessen verlangt.
12. Dokumentiere Ergebnis und Prüfungen nach den Regeln des Projekts. Stage
    oder committe nur nach ausdrücklichem Auftrag.

## Fertig, wenn

- Zweck, Auslöser und Stoppregel ohne Zusatzwissen verständlich sind;
- der Skill eine wiederkehrende Aufgabe löst und keine Prozesssammlung ist;
- Referenzen und eigene Konventionen unterscheidbar sind;
- unterstützte Laufzeiten denselben inhaltlichen Kern verwenden;
- formale Prüfung, Verknüpfungen und relevante Gegenprobe erfolgreich sind.

Änderungen an diesem Skill folgen demselben Ablauf. Das verleiht ihm keine
zusätzliche Autorität; es macht seine eigene Pflege lediglich überprüfbar.