From 89a85c905a74d1618519bd458c26cb2b6fe9534a Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 5 Jun 2026 07:37:35 +0000 Subject: [PATCH] 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. --- CODEX_INSTRUCTIONS_SKILL_VEREDELUNG.md | 510 +++++++++++++++++++++++++ 1 file changed, 510 insertions(+) create mode 100644 CODEX_INSTRUCTIONS_SKILL_VEREDELUNG.md diff --git a/CODEX_INSTRUCTIONS_SKILL_VEREDELUNG.md b/CODEX_INSTRUCTIONS_SKILL_VEREDELUNG.md new file mode 100644 index 0000000000..37d475d90e --- /dev/null +++ b/CODEX_INSTRUCTIONS_SKILL_VEREDELUNG.md @@ -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 : 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/-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/-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 `-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--bis-`. 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: `-` 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: + +``` +": 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 . +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 + +- ❌ `": X mit geführtem Workflow, Normencheck, Beweis- und Fristenlogik, Red-Team und verwertbarem Ergebnis."` (27 Skills haben das aktuell — alle ersetzen) +- ❌ `": 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 `-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.