Skills schreiben
Wie Sie einen neuen Skill schreiben, der den Konventionen des Repositorys entspricht.
Diese Anleitung erklärt, wie Sie einen neuen Skill schreiben, der den Konventionen des Repositorys entspricht.
Aufbau eines Skills
Jeder Skill liegt unter <rechtsgebiet>/skills/<skill-name>/SKILL.md und folgt diesem Aufbau:
---
name: skill-name
description: "Eine prägnante Beschreibung..."
language: de
agents:
researcher: ../../agents/researcher.md
drafter: ../../agents/drafter.md
reviewer: ../../agents/reviewer.md
provider_variants:
- claude
- gemini
- openai
test: ./test.md
---
# /rechtsgebiet:skill-name
## Zweck
...
## Eingaben
...
## Sub-Agent-Architektur
...
## Ablauf
...
## Quellen und Zitierweise
...
## Ausgabeformat
...
## Risiken / typische Fehler
...Pflichtabschnitte
- Zweck — was der Skill leistet und wann er einzusetzen ist.
- Eingaben — welche Angaben die Nutzerin bzw. der Nutzer liefern muss.
- Sub-Agent-Architektur — wie Researcher, Drafter und Reviewer zusammenwirken.
- Ablauf — das schrittweise Vorgehen.
- Quellen und Zitierweise — Normen, Kommentarliteratur, Rechtsprechung (Fundstellen verlinkt).
- Ausgabeformat — die Form des Arbeitsergebnisses (Schreiben, Vermerk, Tabelle usw.).
- Risiken / typische Fehler — bekannte Fallstricke.
Zitierdisziplin
- Normen: Verlinkung auf
gesetze-im-internet.de. - Unionsrecht: Verlinkung auf
EUR-Lex. - Rechtsprechungsnachweise haben genau einen von drei Zuständen:
- (ohne Kennzeichnung, mit URL) — gegen eine amtliche Quelle geprüft. - [unverifiziert – prüfen] — Modellwissen, nicht extern geprüft. Die Prüfung obliegt Ihnen. - [generiert] — in mandatsbezogenen Ausgaben unzulässig.
Die verbindlichen Zitierkonventionen finden Sie in references/zitierweise.md.
Methodik
- Für Vermerke und begründete Mandantenschreiben grundsätzlich Gutachtenstil.
- Urteilsstil für Schriftsätze und kurze interne Notizen.
- Anspruchsgrundlagenprüfung in der klassischen Reihenfolge: Vertrag → c.i.c. → GoA → dinglich → Delikt → Bereicherung.
Testdatei
Zu jedem Skill gehört eine test.md mit mindestens einem vollständigen Durchlauf aus Eingabe und Ausgabe. Die Testdatei wird im Frontmatter referenziert (test: ./test.md).
Einreichen
Öffnen Sie einen Pull Request gegen main. Die CI-Pipeline führt die Smoke-Tests aus und prüft das Frontmatter-Schema.