Codex-Instruktion: Skill-Veredelung auf Anthropic-Niveau

Detaillierter Implementierungsauftrag fuer ~1850 verbesserbare Skills
in 9 Operationen (A-I) plus Reihenfolge (J) und Anhaenge:

- Operation A: 534 Workflow-Wrapper-Skills (byte-identische Klone) individualisieren oder loeschen
- Operation B: 276 Spezial-Wrapper aufloesen (livequellen + red-team)
- Operation C: 841 V90-Fachkern-Bloecke aus Modulen entfernen, in allgemein zentralisieren
- Operation D: 4369 Kompendien re-clustern (semantisch statt alphabetisch) und umbenennen
- Operation E: 4691 Boilerplate-Descriptions durch Lebenslagen-Trigger ersetzen
- Operation F: ~250 Mini-Wrapper verschmelzen
- Operation G: Tom-Wissens-Injektionspunkte pro Plugin
- Operation H: Naming-Konvention (max 45 Zeichen, semantisch)
- Operation I: Validation-Kriterien

Enthaelt konkrete Cluster-Vorschlaege fuer selbstvertreter-sozialgericht,
beamtenrecht, roemisches-recht; Anti-Patterns; Anhang mit ~1850 worst-skill
Suchabfragen.
This commit is contained in:
Claude
2026-06-05 07:37:35 +00:00
parent 2d0680f356
commit 89a85c905a
+510
View File
@@ -0,0 +1,510 @@
# Codex-Instruktion: Skill-Veredelung auf Anthropic-Niveau
## Konkreter Implementierungsauftrag für ~1000+ verbesserbare Skills
Verfasser: Claude (Opus 4.7)
Stand: 2026-06-05
Branch: `claude/skill-improvements-codex-instructions`
Adressat: Codex
Aufgabe: Implementiere die unten gelisteten sechs Operationen. Reihenfolge ist vorgegeben (A → F), weil spätere Operationen auf früheren aufbauen.
**Grundprinzipien für Codex bei jeder Änderung:**
1. **Kein Substanzverlust.** Fachinhalt (BGB-§§, BVerfGE-Anker, Subsumtionsbeispiele, Mandantenwissen, Schriftsatzmuster) bleibt erhalten oder zieht in einen anderen Skill um. Nichts wird gelöscht.
2. **Nicht roboterhaft.** Keine neuen Templates. Wenn du eine alte Floskel ersetzt, ersetzt du sie durch **fallbezogene, lebenslagen-spezifische Sprache** — nicht durch eine andere Floskel.
3. **Individualisierung statt Generizität.** Jeder Skill bekommt sein **eigenes** Norm-Profil, seine **eigenen** Anker-Az, seine **eigenen** Ausgaben. Beispiel: ein Skill zu § 86b SGG zitiert § 86b-Rechtsprechung — nicht den BAG-Entgeltgleichheits-Anker, der heute überall steht.
4. **Anthropic-Niveau heißt:** Ein Skill = eine Frage = ein klarer Trigger im `description`-Feld. Description sagt **wann**, nicht **wie**.
5. **Sprache:** Sie-Form (außer Plugin spielt explizit Du-Mandat). Behördensprache nüchtern. Lebenslagen statt Lehrbuch-Intros.
---
## Datenlage (Stand 2026-06-05)
| Kennzahl | Wert |
|---|---|
| SKILL.md gesamt | 5951 |
| Plugins | 209 |
| Kompendien mit "kompendium-NN-X-bis-Y"-Slugs | 4369 |
| Skills mit V90-Fachkern-Block (Boilerplate) außerhalb `allgemein` | 841 |
| Skills mit exakt 35 Zeilen (byte-identische `workflow-*`-Klone, nur Plugin-Name getauscht) | 242 |
| Skills mit `workflow-kaltstart-und-routing`-Slug (verteilt auf Plugins) | 101 |
| Skills mit `workflow-dokumentenintake`-Slug | 97 |
| Skills mit `workflow-output-waehlen`-Slug | 88 |
| Skills mit `workflow-rechtsquellen-livecheck`-Slug | 87 |
| Skills mit `workflow-unterlagen-lueckenliste`-Slug | 95 |
| Skills mit `workflow-anschluss-skills-router`-Slug | 66 |
| Skills mit `spezial-*-livequellen-und-rechtsprechungscheck` | 188 |
| Skills mit `spezial-*-red-team-und-qualitaetskontrolle` | 88 |
| Kompendien mit Boilerplate-Description `"…: eigenständiger Arbeits-Skill für verwandte Arbeitsmodule…"` | 4691 |
| Skills mit Description-Marker `im Plugin X` | 652 |
**Erkennbares Veredelungs-Volumen:** Mindestens **1850 Skills** lassen sich substanziell verbessern, davon ~880 (workflow-* + spezial-* Wrapper) durch Verschmelzung oder Individualisierung und ~970 durch De-Boilerplate-Operationen auf Kompendien. Das überschreitet das von Tom genannte Ziel "1000 Skills" deutlich.
---
## Operation A — Plugin-spezifische Veredelung der sechs Workflow-Wrapper-Skills
### Befund
Sechs `workflow-*`-Skills sind aktuell **byte-identische Klone**, in 60-101 Plugins parallel vorhanden, nur mit Plugin-Name getauscht:
| Skill-Slug | Vorkommen | Zustand |
|---|---|---|
| `workflow-kaltstart-und-routing` | 101 Plugins | Großteils 35-Zeilen-Klon mit Plugin-Name in der `description` |
| `workflow-dokumentenintake` | 97 Plugins | Klon mit kleinen plugin-spezifischen Anhängen (Bsp. `fachanwalt-verkehrsrecht`: Verkehrsrechts-Intake nach Säule) |
| `workflow-unterlagen-lueckenliste` | 95 Plugins | Klon |
| `workflow-output-waehlen` | 88 Plugins | Klon |
| `workflow-rechtsquellen-livecheck` | 87 Plugins | Klon |
| `workflow-anschluss-skills-router` | 66 Plugins | Klon |
**Belegt:** `diff` zwischen `ki-richtlinie-kanzleien/skills/workflow-anschluss-skills-router/SKILL.md` und `common-law-kompass/skills/workflow-anschluss-skills-router/SKILL.md` nach Plugin-Name-Substitution = **0 Bytes Unterschied**. Reine Wrapper.
**Gegenbeispiel:** `patentrecherche/skills/workflow-dokumentenintake/SKILL.md` ist tatsächlich plugin-spezifisch (Espacenet, DEPATISnet, IPC/CPC-Klassen, FTO, Validity). Das ist der Zielzustand.
### Auftrag an Codex
Für **jeden** der sechs Wrapper-Slugs in **jedem** der 60-101 Plugins:
#### Schritt A1 — Inhaltliche Individualisierung (Pflicht)
Pro Plugin und Wrapper-Skill:
- **Identifiziere das Plugin-spezifische Substrat:** Was wird in diesem Rechtsgebiet hochgeladen / dokumentiert / abgefragt / routet sich wohin?
- Bei `patentrecherche/workflow-dokumentenintake`: Erfindungsmeldung, Anspruchssatz, DEPATISnet-Treffer — schon gut.
- Bei `selbstvertreter-amtsgericht/workflow-dokumentenintake`: Klageschrift, Klageerwiderung, Ladung, Urteil, Vollstreckungstitel.
- Bei `mietrecht/workflow-dokumentenintake`: Mietvertrag, Nebenkostenabrechnung, Mängelanzeige, Mahnung, Kündigungsschreiben, Räumungsklage.
- Bei `kartellrecht-marktabgrenzung-pruefung/workflow-dokumentenintake`: Anmeldungsunterlagen, Umsatzdaten, Marktbefragungen, BKartA-Schreiben, Phase-I-Mitteilung.
- **Ersetze die 35 Klon-Zeilen** durch 100-200 Zeilen plugin-spezifischen Inhalt.
- **Behalte die Slug-Namen** für Operation A. Erst in Operation D werden sie umbenannt.
#### Schritt A2 — Description präzisieren
Aktuell: `"Kaltstart und Routing im Plugin <X>: führt vom ersten Satz oder Dokument in den passenden Arbeitsweg, erkennt Rolle, Ziel, Risiko und Anschluss-Skills."`
Ersetze durch eine Lebenslagen-Beschreibung, z. B.:
- `workflow-kaltstart-und-routing` in `mietrecht`: `"Erstanalyse mietrechtlicher Sachverhalte: ordnet Wohnraummiete / Gewerbemiete / WEG, sortiert nach Mängel / Kündigung / Betriebskosten / Mieterhöhung, identifiziert Notfristen § 174 BGB Schriftform und § 573c BGB Ordentliche Kündigung, leitet zum passenden Spezial-Skill."`
- `workflow-kaltstart-und-routing` in `kartellrecht-marktabgrenzung-pruefung`: `"Erstanalyse kartellrechtlicher Vorgänge: trennt Fusionskontrolle / Kartellverbot / Marktmissbrauch, identifiziert BKartA / EU-KOM / nationale Behörde, ordnet relevante Marktdefinition (sachlich, räumlich, zeitlich), leitet zur passenden Methodik."`
#### Schritt A3 — Bei echter Redundanz: Löschen statt Veredeln
In einigen Plugins ist der Workflow-Wrapper schlicht überflüssig, weil das `allgemein`-Skill dieselbe Funktion bereits übernimmt. Prüfe bei jedem Plugin: Wenn `allgemein` bereits Triage + Routing macht, **lösche** `workflow-kaltstart-und-routing` und `workflow-anschluss-skills-router`. Behalte nur, wenn substantiell andere Funktion.
**Geschätzte Reduktion:** ~250 Skills (aus den 534 wrapper-Vorkommen) bleiben nach Individualisierung und Löschung. Ergebnis: 280-330 echte, plugin-spezifische Workflow-Skills.
---
## Operation B — Spezial-Wrapper auflösen (276 Skills)
### Befund
Zwei systematische Wrapper-Klassen:
- `spezial-*-livequellen-und-rechtsprechungscheck` (188 Skills) — generischer "frische Rechtsprechung holen"-Stub.
- `spezial-*-red-team-und-qualitaetskontrolle` (88 Skills) — generischer "Fehler-Check"-Stub.
Diese sind weder fachlich individualisiert noch unterscheiden sich die Bodies wesentlich.
### Auftrag an Codex
#### Schritt B1 — Livequellen-Skills
Ersetze die 188 `spezial-*-livequellen-*`-Skills durch **plugin-spezifische Live-Quellen-Karten**. Pro Plugin entsteht eine Datei `skills/<plugin-slug>-quellenkarte/SKILL.md` mit:
- Konkrete Behörden-URLs (DPMA, BMF, BKartA, BfArM etc.)
- Konkrete Rechtsprechungsdatenbanken mit den **plugin-relevanten Senaten/Spruchkörpern** (Bsp. `kartellrecht`: BGH Kartellsenat KZR, OLG Düsseldorf VI-Kart)
- Konkrete Aktenzeichen-Muster (Bsp. `patentrecht`: X ZR / 4 Ni / BPatG)
- Konkrete Fachjournale, die der Nutzer kennen muss (Bsp. `arbeitsrecht`: NZA, NJW-RR, AuR)
- Quellenhygiene-Regel: "Kein BeckRS/juris-Blindzitat aus Modellwissen" (1-Zeiler, nicht der bisherige 5-Block).
#### Schritt B2 — Red-Team-Skills
Ersetze die 88 `spezial-*-red-team-*`-Skills durch **plugin-spezifische Fehlerlisten**. Pro Plugin entsteht `skills/<plugin-slug>-redteam-fehlerkatalog/SKILL.md` mit:
- 8-15 **konkrete typische Fehler** in diesem Rechtsgebiet (nicht: "falsche Frist" — sondern: "Übersehene 4-Tage-Bekanntgabe-Fiktion nach § 37 Abs. 2 SGB X seit 01.01.2025").
- Pro Fehler: Symptom + Diagnose + Heilung.
- Bsp. für `sozialrecht-redteam-fehlerkatalog`:
- **Fehler:** Klagefrist § 87 SGG verpasst, weil Bekanntgabe-Fiktion ab 01.01.2025 auf 4 Tage verkürzt (vorher 3 Tage). **Diagnose:** Tagebuchberechnung mit altem 3-Tage-Anker. **Heilung:** Wiedereinsetzung § 67 SGG mit Substantiierung der Fristberechnung.
#### Schritt B3 — Verschmelzung wo angebracht
Wenn ein Plugin sowohl `*-livequellen-*` als auch `*-red-team-*` enthält und beide unter 50 Zeilen sind, **verschmelze** zu einem Skill `<plugin>-qualitaetssicherung/SKILL.md`.
**Geschätzte Reduktion:** 276 → ~140 plugin-spezifische Qualitäts-Skills.
---
## Operation C — Boilerplate-Diet im V90-Fachkern (841 Skills)
### Befund
841 Skills tragen einen identischen 6-Zeilen-V90-Fachkern-Block (Problemfokus / Normenradar / Verifizierte Anker / Arbeitsmodus / Outputpflicht / Fehlerbremse).
**Konkret:** 102 Skills verschiedener Plugins enthalten denselben BAG-Anker `BAG, Urteil vom 23.10.2025 - 8 AZR 300/24` — auch Skills, die mit Arbeitsrecht nichts zu tun haben (z. B. Bürgergeld-Module in `selbstvertreter-sozialgericht`). 82 Skills enthalten denselben BSG-Anker.
### Auftrag an Codex
#### Schritt C1 — V90-Block nur im `allgemein`-Skill belassen
Für jedes Plugin:
1. Behalte den V90-Block in `skills/allgemein/SKILL.md`.
2. **Entferne** ihn aus allen anderen Skills.
#### Schritt C2 — Modulspezifische Drei-Zeilen-Anker einsetzen
Wo der V90-Block entfernt wird, **füge einen 3-zeiligen modulspezifischen Anker** ein:
- **Zeile 1:** Tragende Norm (1-2 Paragraphen, das wirklich Relevante).
- **Zeile 2:** Eine zentrale Entscheidung mit Gericht/Datum/Az + Kernaussage in einem Satz — passend zum **konkreten Modul**.
- **Zeile 3:** Quellenhygiene-Hinweis (kurz: "Az live verifizieren").
Beispiele:
- In `selbstvertreter-sozialgericht/skills/.../eilantrag-86b-sgg-grundlagen`:
- **Norm:** § 86b SGG iVm § 920 ZPO analog.
- **Anker:** BVerfG, Beschluss vom 12.05.2005 - 1 BvR 569/05 (effektiver Eilrechtsschutz Art. 19 IV GG); bei Bürgergeld-eA zusätzlich BSG, Beschluss vom 13.10.2011 - B 14 AS 33/11 B (Existenzminimum-Sicherung).
- **Quellenhygiene:** Az live über bsg.bund.de / bverfg.de prüfen.
- In `beamtenrecht/skills/.../alimentation-fuenf-parameter`:
- **Norm:** Art. 33 V GG.
- **Anker:** BVerfGE 139, 64 (R-Besoldung 5.5.2015 - 2 BvL 17/09); BVerfGE 155, 1 (Berliner Richterbesoldung 4.5.2020 - 2 BvL 4/18).
- **Quellenhygiene:** Bandzahl und Rn live in bverfg.de prüfen.
**Vorteil:** Anker ist **modulrelevant**, nicht generisch. Modell bekommt im Kontext genau das, was zur konkreten Frage passt.
**Schätzung:** Entfernt ~5050 Boilerplate-Zeilen aus dem Repo, fügt ~2520 modulspezifische Zeilen ein. Netto: -2530 Zeilen, +2520 Substanz.
---
## Operation D — Kompendien re-clustern und umbenennen (4369 Skills)
### Befund
4369 Skills heißen `kompendium-NN-<erstesmodul>-bis-<letztesmodul>`. Drei Probleme:
1. **Slug-Trümmer:** "kompendium-08-buergergeld-ueberbru-bis-eilantrag-86b-sgg-gr" (60 Zeichen am Limit). Nicht durchsuchbar.
2. **Alphabetische statt semantische Bündelung:** Module B-D-D-D-E in einem File, obwohl thematisch nicht verwandt.
3. **Identische `Arbeitsregel`-Boilerplate** ("1. Zuerst das passende Arbeitsmodul…") in allen 4369 Files.
### Auftrag an Codex
#### Schritt D1 — Re-Clustering nach Sachzusammenhang
Pro Plugin:
1. Liste alle Module aller Kompendien auf (es gibt z. B. in `selbstvertreter-sozialgericht` heute 26 Kompendien × ~5 Module = ~130 Module).
2. Cluster die Module **nach Rechtsgebiet/Lebenslage**, nicht nach Alphabet.
3. Bilde 6-12 neue Kompendien pro Plugin mit je 4-7 thematisch verwandten Modulen.
4. Neue Slugs: `<plugin-prefix>-<cluster-thema>` ohne `NN-X-bis-Y`-Brücke.
**Konkrete Cluster-Vorschläge für die wichtigsten Plugins:**
##### `selbstvertreter-sozialgericht` (26 → ~10 Kompendien)
- `selbstvertreter-sozialgericht-eilrechtsschutz` (Eilantrag § 86b SGG + Bürgergeld-eA + Krankenkasse-eA + Pflegekasse-eA + Aufschiebende Wirkung)
- `selbstvertreter-sozialgericht-pflege` (Pflegegrade + Pflegegeld + Pflegekassenleistungen + Verhinderungspflege + Pflegekurse)
- `selbstvertreter-sozialgericht-buergergeld` (Antrag + Bedarfsgemeinschaft + Sanktionen + Mehrbedarf + Aufrechnung + Überbrückungsgeld nach Haft)
- `selbstvertreter-sozialgericht-rente` (EM-Rente + Mutterrente + Kontenklärung + Versorgungsausgleich)
- `selbstvertreter-sozialgericht-gdb-und-schwerbehinderung` (GdB-Verfahren + Schwerbehindertenausweis + Nachteilsausgleiche + Persönliches Budget + Eingliederungshilfe)
- `selbstvertreter-sozialgericht-krankenkasse` (Hilfsmittel + Häusliche Krankenpflege + Wahltarife + Zahnersatz + Mutterschutz)
- `selbstvertreter-sozialgericht-verfahrensformalitaeten` (Akteneinsicht § 25 SGB X + DSGVO Art. 15 + Anwaltskosten § 183 SGG + Klage zur Niederschrift + Mitwirkungspflichten § 60 SGB I)
- `selbstvertreter-sozialgericht-fristen-und-rechtsmittel` (Widerspruchsfrist § 84 SGG + Wiedereinsetzung § 67 SGG + Berufung + Revision + Zulassungsgrenzen)
- `selbstvertreter-sozialgericht-zugaenglichkeit-und-it` (Dolmetscher § 185 GVG + Einfache Sprache + PDF-Erstellung + Mein Justizpostfach + Schriftform)
- `selbstvertreter-sozialgericht-wohnen-und-existenzsicherung` (Wohngeld + KdU + Sozialhilfe + BAföG + Elterngeld + Kindergeld)
##### `beamtenrecht` (22 → ~8 Kompendien)
- `beamtenrecht-status-und-eingriff` (Status + Statusamt/Funktionsamt + Ernennung + Entlassung + Versetzung)
- `beamtenrecht-besoldung-grundsystem` (Besoldungsgruppen + Eingruppierung + Stufenfestsetzung + Familienzuschlag + Aufstieg)
- `beamtenrecht-besoldung-zulagen` (Auslandszuschlag + Erschwerniszulagen + Mehrarbeit + Schichtdienst + Gefährdung)
- `beamtenrecht-alimentation-verfassung` ⭐ (Fünf-Parameter-BVerfG + Mindestabstandsgebot + Zeitnahe Geltendmachung)
- `beamtenrecht-konkurrenten-und-beurteilung` (Konkurrentenklage + Beurteilung + Bestenauslese Art. 33 II GG + Eilrechtsschutz § 123 VwGO)
- `beamtenrecht-disziplinar-und-dienstvergehen` (BDG + Disziplinarmaßnahmen + Beamtstg § 47 + Außerdienstliches)
- `beamtenrecht-dienstunfaehigkeit-und-versorgung` (BeamtVG + Ruhegehalt + Hinterbliebenenversorgung + Unfallruhegehalt + Dienstunfähigkeit)
- `beamtenrecht-spezialberufe` (Polizei/Feuerwehr + Soldaten + Hochschullehrer + PTBS + Schwerbehinderte-Bewerber)
##### `roemisches-recht` (22 → ~8 Kompendien)
- `roemisches-recht-personenrecht-status-und-familie`
- `roemisches-recht-sachenrecht` (Eigentum + Besitz + Servituten + Hypotheca + Vindikation)
- `roemisches-recht-schuldrecht-vertraege` (Kauf + Leihe + Darlehen + Miete + Auftrag + Gesellschaft + Innominatkontrakte)
- `roemisches-recht-schuldrecht-haftung` (Delikte + Bereicherung + GoA + Aquilia)
- `roemisches-recht-erbrecht` (Testament + Kodizill + Fideikommiss + Pflichtteil)
- `roemisches-recht-prozessrecht` (Legisaktionen + Formularprozess + Kognitionsverfahren + Konkurs)
- `roemisches-recht-quellen-und-rezeption` (XII Tafeln + Digesten + Justinian + Glossatoren + Rezeption ius commune)
- `roemisches-recht-vergleich-mit-bgb` ⭐ (rom-074 bis rom-081 — die didaktisch besten Module zu Bereicherung/GoA/Delikt/Servituten-Vergleich)
#### Schritt D2 — Slug-Konvention durchsetzen
| Alte Konvention | Neue Konvention |
|---|---|
| `kompendium-08-buergergeld-ueberbru-bis-eilantrag-86b-sgg-gr` | `selbstvertreter-sozialgericht-eilrechtsschutz` |
| `komp-15-teil-02-laufbahnrecht-laender-matrix` | `beamtenrecht-laufbahnrecht-laendermatrix` |
| `kompendium-11-pralr-043-band-teil-bis-pralr-049-abschlussm` | `pralr-quellen-und-methodik` |
Regel: Max 45 Zeichen, semantischer Cluster-Name, kein `NN`, kein `bis`.
#### Schritt D3 — `Arbeitsregel`-Boilerplate ersetzen
Die identische 4-Punkt-Liste in 4369 Files raus. Stattdessen ein **plugin-spezifischer Arbeitsweg-Satz** pro Kompendium, z. B.:
- In `selbstvertreter-sozialgericht-eilrechtsschutz`: *"Eilrechtsschutz beim SG braucht Anordnungsanspruch und Anordnungsgrund. Glaubhaftmachung durch eidesstattliche Versicherung. Stets parallel Widerspruch oder Klage in der Hauptsache führen. Wenn Existenzminimum betroffen: BVerfG verlangt zügige Entscheidung."*
- In `beamtenrecht-alimentation-verfassung`: *"Verfassungsmäßigkeit der Alimentation ist zweistufig: erste Stufe Fünf-Parameter, zweite Stufe Gesamtabwägung. Zeitnahe Geltendmachung im Haushaltsjahr ist Anspruchsvoraussetzung. BVerfG-Urteile zitierst Du nach Band/Rn, nicht nach Az allein."*
---
## Operation E — Description-Triggert auf Anthropic-Niveau (4691 Skills)
### Befund
4691 Skills haben eine `description` der Form:
```
"<plugin-name>: eigenständiger Arbeits-Skill für verwandte Arbeitsmodule zu X, Y, Z und N weitere Arbeitsmodule; mit Intake, Prüfroutine, Normen-/Quellenradar, Beweislogik, Outputmuster und Qualitätscheck."
```
Anthropic-Vergleich:
- Anthropic `pdf`: `"Use this when the user wants to read, edit, or create a PDF document."` — sagt **wann** das Skill geladen werden soll.
- Anthropic `xlsx`: `"Use this skill when working with Excel spreadsheets (.xlsx, .xls files)."` — Trigger.
- Unsere Kompendien-Description sagt **was im Skill drin ist** (Intake / Prüfroutine / etc.) — kein Trigger.
### Auftrag an Codex
Ersetze die 4691 Boilerplate-Descriptions durch **Lebenslagen-Trigger**:
#### Muster für Spezialskills
```
"Nutze dies, wenn <konkrete Lebenslage / konkreter Auftrag>.
Beispiele: <2-3 prototypische Sätze, mit denen Nutzer:innen das Skill auslösen>."
```
Beispiel `selbstvertreter-sozialgericht-eilrechtsschutz/SKILL.md`:
```
description: "Nutze dies, wenn jemand selbstvertretend einen Eilantrag § 86b SGG beim Sozialgericht braucht — typischerweise weil Bürgergeld eingestellt wurde, eine Krankenkassen-Leistung dringend verweigert wird oder ein Pflegehilfsmittel zurückgehalten wird. Auslöser: 'Mein Geld wurde gestrichen', 'Die Kasse zahlt nicht', 'Ich brauche einen Eilantrag'."
```
Beispiel `beamtenrecht-alimentation-verfassung/SKILL.md`:
```
description: "Nutze dies, wenn ein Beamter oder Richter Verfassungsmäßigkeit der eigenen Besoldung prüft — Fünf-Parameter-Test erster Stufe (BVerfGE 139, 64), Mindestabstand zur Grundsicherung (BVerfG 4.5.2020 - 2 BvL 4/18), zeitnahe Geltendmachung im Haushaltsjahr. Auslöser: 'Ist meine Besoldung amtsangemessen?', 'Widerspruch gegen R-Besoldung', 'Verfassungsbeschwerde Alimentation'."
```
#### Anti-Patterns die zu vermeiden sind
-`"<plugin>: X mit geführtem Workflow, Normencheck, Beweis- und Fristenlogik, Red-Team und verwertbarem Ergebnis."` (27 Skills haben das aktuell — alle ersetzen)
-`"<plugin>: eigenständiger Arbeits-Skill für …"` (4691 Skills — alle ersetzen)
- ❌ Kommas in Zahlen: `1,5``1.5` oder `eineinhalb`. (CLAUDE.md schon vorgegeben.)
- ❌ HTML-Tags `<>` in Description (Validator beschwert sich).
- ❌ Description > 1024 Zeichen (Validator-Bruch).
---
## Operation F — Mini-Wrapper-Klone konsolidieren (~250 Skills)
### Befund
In `beamtenrecht` (Beispiel) gibt es vier Mini-Skills (38-42 Zeilen), die strukturell **denselben Inhalt** mit unterschiedlichen Titeln haben:
- `red-team-beamtenrecht/SKILL.md`
- `output-waehlen-memo-widerspruch-eilantrag/SKILL.md`
- `quellenhygiene-beamtenrecht-fundstellen-red-team/SKILL.md`
- `versorgungsakte-dokumentenintake-und-berechnung/SKILL.md`
- `aktenstruktur-und-dokumentenintake/SKILL.md`
Sie wiederholen die identische "Status und Rechtsquelle / Eingriff und Ziel / Materielle Prüfung / Verfahren / Output"-Prüfschema-Boilerplate. 37 Skills im `beamtenrecht` allein nutzen diese Liste; über alle Plugins hinweg 100+.
### Auftrag an Codex
#### Schritt F1 — Pro Plugin: Mini-Wrapper verschmelzen oder löschen
Pro Plugin alle Skills < 60 Zeilen sammeln. Wenn ihre Bodies > 70 % Überlappung haben:
- **Variante A (bevorzugt):** Verschmelze zu einem einzigen `<plugin>-qualitaetssicherung/SKILL.md` mit klaren Subsections (Red Team / Output-Wahl / Quellenhygiene / Aktenstruktur). Sub-Sections sind durch Headings strukturiert, nicht durch separate SKILL.md-Files.
- **Variante B:** Wenn das `allgemein`-Skill schon diese Funktionen abdeckt: **lösche** die Mini-Wrapper komplett.
#### Schritt F2 — Inhaltlich aufwerten
Die verschmolzenen Skills sollen **plugin-spezifisch** werden:
- Bsp. `beamtenrecht-qualitaetssicherung`: Statt generischer "Status / Eingriff / Materielles / Verfahren / Output"-Liste — konkrete Red-Team-Fragen zu Beamtenrecht: *"Habe ich Bundes- vs. Landesbesoldung sauber getrennt? § 19 BBG vs. § 18 LBG NW? Ist Konkurrentensituation berücksichtigt? Bestenauslese Art. 33 II GG geprüft? Bei Eilantrag § 123 VwGO: Anordnungsanspruch vs. Anordnungsgrund? Akteneinsicht § 88 ff. BBG vor Schriftsatz?"*
**Geschätzte Reduktion:** ~250 Mini-Wrapper → ~100 echte plugin-spezifische Qualitäts-Skills.
---
## Operation G — Wissens-Injektions-Punkte (wo Tom-Wissen rein muss)
Das ist der wichtigste Punkt für Codex, weil Tom explizit sagt: *"mit dem von mir addierten / generierten Wissen, das ist wichtig"*.
### Auftrag an Codex
Bei jeder veredelten Skill-Datei prüfen, ob Tom-Wissen (in `references/`, in `CLAUDE.md`, in vorherigen Sessions) injiziert werden sollte. Die folgenden Wissensbestände sind in diesem Repo dokumentiert und sollen aktiv in die richtigen Skills eingearbeitet werden:
#### G1 — Methodik (in `references/methodik-buergerliches-recht.md`)
Soll referenziert werden in **allen** Skills, die Subsumtion machen. Konkret in Gutachtenstil-Skills (Hausarbeiten, Memos, Schriftsätze). Mehrere Plugins betroffen:
- `jurastudium`, `subsumtions-pruefer`, `bgb-at-pruefer`, `hausarbeitenmacher`
- alle `fachanwalt-*` Plugins (Mandantenmemos)
#### G2 — Zitierweise (in `references/zitierweise.md`)
Soll referenziert werden in **allen** Skills, die Quellen ausgeben. Das ist praktisch jedes Skill. Codex soll einen 1-Zeiler einbauen: *"Quellenangaben nach `references/zitierweise.md`."*
#### G3 — Quellenhygiene-Regeln aus CLAUDE.md
CLAUDE.md verbietet:
- Halluzinierte Aktenzeichen
- BeckRS/juris-Blindzitate aus Modellwissen
- Mandantengeheimnis-Verletzungen
Diese drei Verbote sind heute in 855 V90-Blocks redundant kopiert. Soll **einmal** in `references/quellenhygiene.md` ausgelagert und in jedem Skill referenziert werden, nicht ausgeschrieben.
#### G4 — Plugin-spezifische Sammlungen
Pro Plugin gibt es einen Wissensschatz, den Tom über mehrere Sessions kuratiert hat:
| Plugin | Tom-Wissen, das injiziert werden soll |
|---|---|
| `beamtenrecht` | BVerfGE 139, 64 + BVerfGE 155, 1; Fünf-Parameter-Trennung erste/zweite Stufe; Mindestabstandsgebot 15 %; Zeitnahe Geltendmachung |
| `selbstvertreter-sozialgericht` | § 86b SGG-Eilantragsmuster mit eidesstattlicher Versicherung; 4-Tage-Bekanntgabe-Fiktion § 37 II SGG seit 01.01.2025; § 183 SGG-Kostenfreiheit |
| `selbstvertreter-amtsgericht` | Drei-Führungsstufen-Modell (sehr geführt / normal / Kurzmodus); Stummer-Upload-Logik |
| `roemisches-recht` | Digestenstellen D. 4.9 (receptum nautarum), D. 12.6 (condictio indebiti), D. 13.6 (commodatum), D. 14.2 (lex Rhodia), D. 18.6 (Kauf-Gefahrtragung), D. 41.2 (Besitz); 11 Vergleichs-Module rom-074 bis rom-080 |
| `pralr` | Einl. §§ 74-75 Aufopferung, ALR II 5 §§ 196-197 Sklaverei, PrALR 38 Spezialinstitute |
| `arbeitszeugnis-analyse` | Geheimcode-Katalog rot/orange/grün, Zufriedenheitsformel-Decodierung, § 109 GewO |
| `kartellrecht-marktabgrenzung-pruefung` | SSNIP-Test, Marktabgrenzung sachlich/räumlich/zeitlich, BKartA-Phase-I/Phase-II |
| `bauträgervertrag` (40 Skills, von Tom kuratiert) | MaBV § 3, MaBV § 7, BGB §§ 650u ff., § 650v BGB Sicherheitsleistung |
| `gebrauchsmusterrecht` | GebrMG § 1 (Erfindungsbegriff), § 5 (Neuheit), § 13 (Eintragung), § 15 (Löschung) |
| `steuerrecht-anwalt-und-berater` | Alle DBA-Skills sind bereits Tom-individualisiert (60-Tage-Rückkehr, Grenzgänger-Frankreich/Schweiz/Österreich, Tie-Breaker-Rules) — **nicht anfassen**, das ist Gold |
| `roemisches-recht/rom-074 bis rom-081` | Vergleichs-Module BGB ↔ röm. Recht (Bereicherung, GoA, Delikt, Servituten, Hypothek, Gesellschaft, Kauf, lateinische Maximen) — sind bereits Tom-individualisiert |
#### G5 — V90 Fachkern: wo der eigentlich hingehört
Der V90-Block ist **gut gemeint, aber falsch platziert**. Er gehört NICHT in jedes Modul. Er gehört in `skills/allgemein/SKILL.md` pro Plugin **einmal**, als sektion "Qualitäts- und Quellenstandards für dieses Plugin". Dort darf er ausführlich sein — der Allgemein-Skill ist genau dafür da.
---
## Operation H — Naming-Konvention pro Plugin (alle 5951 Skills)
### Regeln (verbindlich für Codex)
1. **Max 45 Zeichen** im Slug (Anthropic-Limit ist 64, wir nehmen Puffer).
2. **ASCII only**, `[a-z0-9-]+`, keine `_`, keine Großbuchstaben.
3. **Kein `kompendium-NN-X-bis-Y`-Pattern**. Stattdessen semantischer Cluster-Name.
4. **Prefix nur, wenn nötig**. Wenn das Plugin `selbstvertreter-sozialgericht` heißt, muss nicht jeder Skill `selbstvertreter-sozialgericht-`-Prefix tragen — der Plugin-Pfad sagt das schon. Aber bei Cluster-Slugs ist Prefix lesbarkeits-helfend.
5. **Keine Stop-Wörter** wie `spezial-`, `workflow-`, `kompendium-`, `komp-`. Das ist Metadaten, kein Thema.
6. **Mit dem Cluster-Thema beginnen, nicht enden.** `eilrechtsschutz-86b-sgg` (gut) statt `sgg-86b-eilrechtsschutz` (umständlich).
### Slugnamen-Refactoring: Beispielliste
| Alter Slug | Neuer Slug |
|---|---|
| `kompendium-08-buergergeld-ueberbru-bis-eilantrag-86b-sgg-gr` | `eilrechtsschutz-86b-sgg` |
| `komp-15-teil-02-laufbahnrecht-laender-matrix` | `laufbahnrecht-laendermatrix` |
| `kompendium-11-pralr-043-band-teil-bis-pralr-049-abschlussm` | `pralr-quellen-und-methodik` |
| `spezial-pflichtverteidigung-livequellen-und-rechtsprechungscheck` | `pflichtverteidigung-quellenkarte` |
| `wirtschaftspruefer-bestaetigungsvermerk-risikofall-kaltstart-u` | `wp-bestaetigungsvermerk-risikofall` |
| `space-001-kaltstart-weltraummandat-quellenkarte-und-risikocockpi` | `weltraummandat-kaltstart` |
| `output-waehlen-memo-widerspruch-eilantrag` | (LÖSCHEN, weil in `allgemein` integriert) |
---
## Operation I — Validation und Qualitätskriterien (am Ende jeder Operation)
Nach jeder Operation Codex laufen lassen:
```bash
node scripts/validate-plugin-structure.mjs
```
Pflicht-Kriterien:
- ✅ Alle SKILL.md haben Frontmatter mit genau `name` + `description`.
- ✅ Alle `description` ≤ 1024 Zeichen.
- ✅ Alle Slugs ≤ 64 Zeichen (Soll: ≤ 45).
- ✅ Keine Zahl-Komma-Zahl-Muster.
- ✅ Kein HTML-`<>` in Description.
- ✅ Skill-`name` im Frontmatter = Verzeichnisname.
- ✅ Plugin-`description` in `plugin.json` ≤ 300 Zeichen.
Manuelle Stichproben durch Tom:
- 5 zufällige veredelte Skills durchlesen — keine generische Sprache, keine Boilerplate?
- 3 Plugins komplett durchgehen — sinnvolle Cluster, keine Redundanz?
- 1 Vergleich Anthropic-Skill (z. B. `pdf`) ↔ unser veredeltes Skill — vergleichbarer Stil?
---
## Operation J — Reihenfolge der Implementierung
Codex soll in dieser Reihenfolge arbeiten, weil Operationen aufeinander aufbauen:
1. **Operation C** (V90-Diet) zuerst — entfernt Boilerplate, macht den Rest lesbar.
2. **Operation E** (Description-Trigger) parallel — viele Descriptions berühren keine V90-Blocks.
3. **Operation B** (Spezial-Wrapper) — kleines, abgegrenztes Volumen, gut zum Üben.
4. **Operation A** (Workflow-Wrapper) — größtes Volumen, braucht plugin-spezifische Inhalte.
5. **Operation F** (Mini-Wrapper) — räumt nach den anderen auf.
6. **Operation D** (Re-Clustering + Rename) zuletzt — strukturelle Großoperation, sollte auf bereits bereinigtem Boden stattfinden.
7. **Operation G** (Wissens-Injektion) wirkt **parallel** in allen Operationen — pro Skill, das angefasst wird, prüfen.
8. **Operation H** (Naming) wird mit Operation D zusammengeführt.
9. **Operation I** (Validation) nach jeder Operation.
---
## Anhang 1 — Konkrete Liste der ~1000 worst skills (Beispiele)
Codex bekommt die vollständige Liste durch die folgenden Suchen (alle laufen direkt im Repo):
```bash
# 1. Workflow-Wrapper (~534 Skills, jeder ein Kandidat)
find . -name SKILL.md -path "*/skills/workflow-kaltstart-und-routing/*"
find . -name SKILL.md -path "*/skills/workflow-dokumentenintake/*"
find . -name SKILL.md -path "*/skills/workflow-output-waehlen/*"
find . -name SKILL.md -path "*/skills/workflow-rechtsquellen-livecheck/*"
find . -name SKILL.md -path "*/skills/workflow-unterlagen-lueckenliste/*"
find . -name SKILL.md -path "*/skills/workflow-anschluss-skills-router/*"
# 2. Spezial-Wrapper (~276 Skills)
find . -name SKILL.md -path "*/skills/spezial-*livequellen*"
find . -name SKILL.md -path "*/skills/spezial-*red-team*"
# 3. V90-Block in Modulen (841 Skills) — bekommen Operation C
grep -l "V90 Fachkern" -r --include=SKILL.md . | grep -v "/allgemein/"
# 4. Generische "mit geführtem Workflow"-Tagline (27 Skills)
grep -l "mit geführtem Workflow, Normencheck, Beweis- und Fristenlogik" -r --include=SKILL.md .
# 5. Kompendien mit "X-bis-Y"-Slug (4369 Skills) — bekommen Operation D + H
find . -name SKILL.md -path "*/kompendium-*-bis-*"
# 6. Mini-Wrapper-Skills (~250 Skills) — bekommen Operation F
find . -name SKILL.md | while read f; do
lines=$(wc -l < "$f")
[ "$lines" -lt 45 ] && echo "$f"
done
```
**Geschätzte Größenordnung:** Summe der distinkten Skills aus den obigen Listen (mit Overlap-Bereinigung): ~1850 unique Skills, davon mindestens 1000 echte Veredelungs-Kandidaten.
---
## Anhang 2 — Was NICHT verändert werden soll
Diese Skills sind bereits auf gutem Niveau und sollen **nicht** angefasst werden:
- **`steuerrecht-anwalt-und-berater/skills/stb-dba-*` (alle Länder-DBA)** — Goldstandard, perfekt individualisiert.
- **`beamtenrecht/skills/komp-08-teil-02-amtsangemessene-alimentation` Modul-6** (Fünf-Parameter) — soll bleiben, ggf. als eigener Skill ausgelagert.
- **`selbstvertreter-amtsgericht/skills/kompendium-01-anfaenger-workflow-a-bis-fristbeginn-zustellu` Drei-Führungsstufen-Modell** — Gold, bleibt.
- **`arbeitszeugnis-analyse/skills/rote-flaggen-katalog`, `orange-flaggen-katalog`, `gruen-flaggen-katalog`** — sind echte Kataloge, bleiben (aber Description-Trigger nach Operation E aufwerten).
- **`roemisches-recht/skills/.../rom-074 bis rom-081`** (Vergleichsmodule) — didaktisches Gold, bleibt.
---
## Anhang 3 — Erwartetes Endergebnis nach allen Operationen
| Kennzahl | Heute | Ziel nach allen Operationen |
|---|---|---|
| SKILL.md gesamt | 5951 | ~3500-4000 |
| Kompendien | 4369 | ~1600-1800 (semantisch geclustert) |
| Spezialskills | 1260 | ~1700-2200 (durch Workflow-Wrapper-Individualisierung) |
| Plugins | 209 | 209 (unverändert) |
| V90-Blocks in Modulen | 841 | 0 (alle in `allgemein` zentralisiert) |
| Wrapper-Klone | ~810 | 0 |
| Slug-Länge max | 64 | ≤ 45 |
| Description-Trigger-Qualität | 4691 Boilerplate | 0 Boilerplate, alle Lebenslagen-Trigger |
Das Repo ist danach kompakter, individueller, näher an Anthropic-Niveau — aber mit der gesamten von Tom kuratierten juristischen Substanz erhalten.
---
## Schluss
Tom erwartet vergleichbare Reviews von Claude (dieses Dokument), Codex und Perplexity. Codex implementiert die Synthese.
Wenn Codex zu einer Operation Rückfragen hat: bitte vor Implementierung Pull Request mit `Draft` öffnen und einzelne Plugin-Veredelung als Beispiel pushen. Tom validiert.