Einen Skill erstellen

Einen Ablauf, den du immer wieder erklärst, in einen Agent Skill verwandeln, mit dem Agent testen und auf Denofy veröffentlichen.

Gute Skills entstehen aus echter, wiederkehrender Arbeit. Wenn du deinem Agent jede Woche dasselbe erklärst, sollte es ein Skill sein.

1. Eine Aufgabe wählen#

Ein Skill macht eine Sache gut: „Release Notes schreiben“, „einen API-Endpunkt so anlegen, wie es dieses Repo macht“. Brauchst du ein „und“, brauchst du wahrscheinlich zwei Skills.

2. Ordner anlegen#

bash

mkdir -p .claude/skills/release-notes

.claude/skills/release-notes/SKILL.md:

markdown

---
name: release-notes
description: Drafts release notes from the merged pull requests since the last tag. Use when preparing a release or when the user asks for release notes.
license: MIT
version: 1.0.0
use_when:
  - Preparing a release
avoid_when:
  - The project generates notes automatically in CI
---

# Release notes

1. Find the last tag: `git describe --tags --abbrev=0`.
2. List merged PRs since then: `git log <tag>..HEAD --merges --oneline`.
3. Group them into Features, Fixes and Internal …

Der Name muss zum Ordner passen. Halte den Inhalt fokussiert: Schritte, Regeln, ein oder zwei Beispiele. Englisch ist für die meisten Agents die verlässlichste Sprache für Anweisungen.

3. Ressourcen nur bei Bedarf#

Lange Referenzen gehören in eigene Dateien, die der Skill verlinkt (reference.md, templates/). Skripte sind möglich, aber jedes Skript führt der Agent aus – halte sie klein, lesbar und ohne Downloads (siehe Sichere Skills schreiben).

4. Mit dem Agent testen#

Starte eine neue Sitzung und bitte um die Aufgabe, ohne den Skill zu nennen. Greift der Agent ihn nicht auf, schärfe die description. Macht er es anders als gewünscht, formuliere die Schritte genauer oder ergänze ein Beispiel.

5. Gegen die Regeln prüfen#

Lies einmal die Prüfregeln: Sie listen jedes Sicherheitsmuster mit Beispiel, erklären, wie der Kontext (Code-Block, Fließtext, verneintes Beispiel) den Schweregrad ändert, und nennen die Strukturgrenzen. Nach dem Veröffentlichen zeigt der Prüfbericht jeden Befund mit Datei und Zeile – beheben, erneut pushen; jeder Push erzeugt eine neue, neu geprüfte Version.

6. Veröffentlichen#

Pushe den Ordner in ein öffentliches GitHub-Repository mit LICENSE-Datei und veröffentliche ihn auf Denofy. Denofy importiert den Ordner, prüft ihn, pinnt ihn auf den Commit und zeigt den Bericht. Mit dem GitHub-Webhook wird jeder Push automatisch zur neuen Version. Details: Veröffentlichen.