27 KiB
Skill-Review claude-fuer-deutsches-recht
Begutachtung der konsolidierten Skills nach Kompendien-Sortierung
Verfasser: Claude (Opus 4.7 / 1M context)
Stand: 2026-06-05
Repository: Klotzkette/claude-fuer-deutsches-recht
Branch: claude/review-german-law-skills-9LH3E
Aufgabe: Einer von drei parallelen Reviews (Claude / Codex / Perplexity), die du danach gegeneinander vergleichst und Codex zur Implementierung gibst.
Diese Datei ist bewusst lang. Sie ist als Lesedokument für dich gedacht, nicht als Output an einen Mandanten.
0. Worauf ich geschaut habe (Methode)
Ich konnte nicht alle 5629 SKILL.md einzeln lesen. Was ich gemacht habe:
- Repo-weite Strukturzählungen (
Bash,Grep). - Stichproben aus elf repräsentativen Plugins quer durch die Cluster (Verbraucher-Recht, Beamtenrecht, Selbstvertreter, Steuerrecht, Römisches Recht, ALR, Arbeitszeugnis, DBA, Insolvenzrecht, Kartellrecht, Migrationsrecht).
- Volltextlesung von vier Kompendien (selbstvertreter-sozialgericht/k08, beamtenrecht/k06, selbstvertreter-amtsgericht/k01, roemisches-recht/k11).
- Vergleich zweier identisch wirkender Mini-Skills (
red-team-beamtenrecht↔output-waehlen-memo-widerspruch-eilantrag) zur Quantifizierung der Restduplikate. - Quervergleich mit Anthropic-Skill-Niveau (pdf, docx, xlsx, skill-creator).
Ich nenne unten an mehreren Stellen Plugin/SKILL-Pfad als konkretes Beleg-Sample, damit du oder Codex direkt nachgucken können.
1. Gesamtbild auf einen Blick
| Kennzahl | Wert |
|---|---|
| SKILL.md gesamt (in Repo) | 5951 |
Davon kompendium-* / komp-* (gebündelte Arbeitsbereiche) |
4369 |
| Nicht-Kompendien (Einzelskills, allgemein, red-team etc.) | 1582 |
Plugins mit skills/-Verzeichnis |
~209 |
Plugins mit skills/allgemein/ |
93 |
| Skills mit gleicher 6-zeiliger "V90 Fachkern"-Box | 855 |
Skills mit identischem BAG-Anker-Triplet (23.10.2025 8 AZR 300/24 + 2 weitere) |
102 |
Skills mit identischem BSG-Anker-Triplet (05.11.2024 B 12 BA 3/23 R + 2 weitere) |
82 |
| Skills mit identischer "Status und Rechtsquelle"-Prüfprogramm-Liste | 37 |
Skills mit identischer 4-Punkt-Arbeitsregel der Kompendien-Schablone |
4369 |
| Slugs mit ≥ 60 Zeichen | 58 |
Kernbefund: Die Codex-Konsolidierung hat das schlimmste Problem (19 162 generische Wrapper) erfolgreich gelöst. Die Kompendien-Schablone als solche ist tragfähig. Aber: in der Schablone steckt jetzt selbst Boilerplate-Duplikat (V90-Block, BAG/BSG-Triplet, 4-Punkt-Arbeitsregel), und der Bündelungsalgorithmus ist alphabetisch, nicht semantisch — das produziert disparate Mischungen.
Das Repo ist heute besser, aber noch nicht auf Anthropic-Niveau. Anthropic-Skills haben drei Eigenschaften, die wir noch nicht durchgängig erreichen:
- Eine klare, einzelne Funktion (
pdfkann genau PDFs lesen/schreiben — nichts anderes). - Eindeutiger Trigger im
description-Feld (das Modell weiß sofort: wann lade ich das, wann nicht). - Kein internes Boilerplate. Anthropic-Skills haben keinen "Fachkern-Block", keine "Quellenhygiene-Box", keine "Red-Team-Sieben-Fallen-Liste" — sondern den eigentlichen Inhalt und Beispiele.
Wir machen das umgekehrt: viele Skills haben eine fast leere ## Aufgabe, dann einen großen V90-Block, dann eine generische Prüfschablone. Das ist die historische Erblast aus den 19 162 Wrappern, sie steckt jetzt nur an anderer Stelle.
2. Was die Kompendien-Konsolidierung sehr gut gemacht hat
Damit das hier nicht nur Kritik ist — die echten Stärken:
2.1 Massive Reduktion ohne Substanzverlust
Aus ~19 162 SKILL.md sind 5951 geworden. Der wirklich wertvolle Inhalt (z. B. die BVerfG-Fünf-Parameter-Alimentation in beamtenrecht/kompendium-06, die condictio-Pendants in roemisches-recht/kompendium-11, die § 86b-SGG-Schriftsatzvorlage in selbstvertreter-sozialgericht/kompendium-08) ist erhalten geblieben. Das war die Hauptsorge, und sie ist nicht eingetreten.
2.2 Tatsächlich starke Inhalte
Einzelne Kompendien-Module sind genuin gut:
beamtenrecht/skills/kompendium-06-besold-neu-003-besol-bis-besold-neu-009-minde→ Modul 6 (Amtsangemessene Alimentation): Klare Fünf-Parameter-Pruefung erster Stufe, Trennung erste/zweite Stufe, BVerfGE-Anker mit Band+Randnummer. Das ist Fachanwalts-Niveau, nicht Lehrbuch.selbstvertreter-sozialgericht/skills/kompendium-08-.../eilantrag-86b-sgg-grundlagen→ Vollständiger SG-Eilantrag mit eidesstattlicher Versicherung, Antragsmuster, Anlagenliste. Das spart einer/m Bürger:in zwei Stunden Recherche.roemisches-recht/skills/kompendium-11-.../rom-074-bereicherungsrecht-vergleich→ Saubere Zuordnung Digestenstellen → BGB §§ 812-822, einschließlich Einheits- vs. Trennungslehre. Universitätsniveau.selbstvertreter-amtsgericht/skills/kompendium-01-anfaenger-workflow-a-bis-fristbeginn-zustellu→ Sehr starkes Triage-Schema in Sie-Form mit drei Führungsstufen (sehr geführt / normal / Kurzmodus). Das ist genau die richtige Idee für einen Allgemein-Skill.
2.3 Einheitliche Quellenhygiene
Der überall verbaute Block ("Keine BeckRS-, juris-, Kommentar- oder Aufsatz-Blindzitate aus Modellwissen") setzt eine sehr saubere Regel um. Das ist nicht Anthropic-Stil, aber für deutsche Kanzleien richtig. Sollte bleiben — nur nicht 855-mal im selben Wortlaut.
2.4 Frontmatter-Disziplin
Nur name + description. Keine wilden triggers, language, rechtsgebiet. Das ist sauber, validatorfest, und macht jedes Skill für Claude ladbar.
3. Was noch nicht stimmt — die fünf Hauptprobleme
Problem 1: Alphabetische Bündelung produziert disparate Kompendien
Beleg: selbstvertreter-sozialgericht/skills/kompendium-08-buergergeld-ueberbru-bis-eilantrag-86b-sgg-gr/ bündelt fünf Module:
| Modul | Thema |
|---|---|
buergergeld-ueberbrueckungsgeld |
SGB II Sondervorschrift Haftentlassene |
dokumenten-erzeugung-pdf-laien-sozialgericht |
IT-Anleitung: Word → PDF, Smartphone-Scan |
dolmetscher-beim-sozialgericht-laien |
§ 185 GVG Sprachmittlung |
dsgvo-art-15-auskunft-sozialakte |
Datenschutzrechtlicher Auskunftsanspruch |
eilantrag-86b-sgg-grundlagen |
SGG-Eilrechtsschutz |
Diese fünf haben gemeinsam: nichts. Außer dass sie alphabetisch in B-D-D-D-E fallen. Ein:e Bürger:in mit Eilantrag-Anliegen bekommt 600 Zeilen geladen, davon 400 zu PDF-Anleitung und DSGVO. Das ist genau das Disparat-Problem, das du befürchtet hast.
Weiter: kompendium-04-akteneinsicht-25-sgb-bis-anwaltskosten-bei-er mischt Akteneinsicht + Amtsermittlung + Anfechtungsklage + Anlagen-Bezeichnen + Anwaltskosten — wieder fünf "A"s, keine Sachlogik.
Beleg #3: beamtenrecht/skills/kompendium-06-besold-neu-003-besol-bis-besold-neu-009-minde bündelt Eingruppierung + Stufenfestsetzung + Auslandszuschlag + Erschwerniszulagen + Mehrarbeit + Amtsangemessene Alimentation + Mindestabstandsgebot. Hier ist die Kohärenz besser (alles Besoldungsrecht), aber die juristische Tiefe schwankt extrem: Module 1-7 sind 20-30 Zeilen Stichworte, Modul 8 (Alimentation) ist 50 Zeilen ausgearbeitetes Fachwissen. Das ist visuell, was man "Klumpenbildung" nennt.
Empfehlung für Codex:
- Re-Bündelung nach Sachzusammenhang, nicht nach Alphabet.
- In selbstvertreter-sozialgericht z. B.: ein Kompendium "Eilrechtsschutz" (§ 86b SGG + Bürgergeld-eA + Krankenkasse-eA + Pflegekasse-eA), ein eigenes "IT-Hilfsmittel" (PDF + Smartphone + ELSTER + MJP), ein eigenes "Sprache und Zugänglichkeit" (Dolmetscher + einfache Sprache + Schriftgrößen-Tipps), ein eigenes "Daten-Auskunft" (DSGVO + SGB X § 25 + Beschwerde Datenschutzaufsicht).
- Naming-Konvention vorgeben:
kompendium-<plugin-kurz>-<thema-kurz>stattkompendium-NN-<erstesmodul>-bis-<letztesmodul>. Die heutige Naming-Konvention macht es buchstäblich unmöglich, das richtige Kompendium zu finden.
Problem 2: Der "V90 Fachkern"-Block ist 855-mal dasselbe
855 Skills enthalten denselben sechszeiligen Block mit Problemfokus/Normenradar/Verifizierte Anker/Arbeitsmodus/Outputpflicht/Fehlerbremse. Beispielsweise:
- 102 Skills nennen identisch
BAG, Urteil vom 23.10.2025 - 8 AZR 300/24 (Entgeltgleichheit)+ zwei weitere BAG-Az. - 82 Skills nennen identisch
BSG, Urteil vom 05.11.2024 - B 12 BA 3/23 R (Lehrende/Dozenten)+ zwei weitere BSG-Az. - In
selbstvertreter-sozialgericht/kompendium-08taucht derselbe Block fünfmal hintereinander auf (einmal pro Modul) — das sind allein in einem File 30 redundante Zeilen.
Was dabei wirklich passiert: Ein:e Nutzer:in lädt das Skill, Claude bekommt seitenweise identischen Boilerplate-Text in den Kontext, der für die konkrete Fachfrage nichts beiträgt. Bei buergergeld-ueberbrueckungsgeld ist die "BAG-Entgeltgleichheit"-Verweis schlicht falsch verortet — das ist Arbeitsrecht, nicht SGB II.
Empfehlung für Codex:
- V90-Block pro Plugin einmal in
skills/allgemein/SKILL.mdschreiben. - Aus jedem Modul rausnehmen.
- Wenn ein Modul einen eigenen Norm-/Anker-Block braucht (z. B. Eilantrag § 86b SGG hat andere Anker als Pflegegrad MDK), dann modulspezifisch und kurz — drei Zeilen, nicht sechs Blockzitate aus Tarifgleichheits-Rechtsprechung.
- Konsequenz: ~5000 Skill-Zeilen weniger Boilerplate, schärferer Fokus.
Problem 3: 27 Skills enden mit demselben generischen Tagline
"mit geführtem Workflow, Normencheck, Beweis- und Fristenlogik, Red-Team und verwertbarem Ergebnis"
Das ist nicht-aussagekräftiges Marketing-Geräusch. In beamtenrecht/kompendium-06/Modul 1 z. B.: "Besoldungsgruppe Eingruppierung Amt und Funktion mit geführtem Workflow, Normencheck, Beweis- und Fristenlogik, Red-Team und verwertbarem Ergebnis." — Das sagt einem Modell nichts darüber, wann dieses Modul vor einem anderen gewählt werden soll.
Anthropic-Pattern: description ist der wichtigste Trigger. Es muss eine konkrete Lebenslage nennen, nicht den Methodenstil.
Empfehlung:
- Alle 27 betroffenen Skills: Tagline streichen, ersetzen durch konkrete Tatbestandsbeschreibung im Stil "Wenn der Bescheid X enthält und der Mandant Y will, …".
Problem 4: Restwrapper-Skills mit fast identischem Body
Beleg: beamtenrecht/skills/red-team-beamtenrecht/SKILL.md (38 Zeilen) und beamtenrecht/skills/output-waehlen-memo-widerspruch-eilantrag/SKILL.md (38 Zeilen) haben denselben Prüfprogramm-Block ("Status und Rechtsquelle / Eingriff und Ziel / Materielle Prüfung / Verfahren / Output"), dieselben Pflichtfragen ("Welcher Status liegt vor: Beamter, Richter, Bewerber, …"), dieselbe Ausgabeformatliste ("Kurzantwort in drei Sätzen / Checkliste …"). Nur ## Aufgabe und Frontmatter unterscheiden sich.
In beamtenrecht allein finden sich 37 Skills, die diese identische "Status und Rechtsquelle"-Liste enthalten.
Empfehlung:
- Diese Mini-Skills (
red-team-*,output-waehlen-*,quellenhygiene-*,versorgungsakte-dokumentenintake-*,aktenstruktur-und-dokumentenintake) sind funktional derselbe Skill: "Beamtenrecht-Vorbereitungs-Checkliste". Auf einen reduzieren, mit klarer Spezialisierung prodescription(z. B. "Red-Team" = nachträgliche Kritik vs. "Aktenintake" = Vorbereitung). - Oder: alle vier ins
skills/allgemein/SKILL.mdverschmelzen und einzeln löschen.
Problem 5: 58 Slugs an der 60-Zeichen-Grenze, einige zwingen zu Abkürzungen
Beispiele:
kompendium-08-buergergeld-ueberbru-bis-eilantrag-86b-sgg-gr→ "ueberbru" und "sgg-gr" sind ASCII-Trümmer, weil die 64-Zeichen-Grenze zwingt.wirtschaftspruefer-bestaetigungsvermerk-risikofall-kaltstart-u→ letzter Buchstabe weg.kv-001-kaltstart-krankenversicherung-bescheid-rechnung-und-frist(64 Zeichen, am Limit).
Empfehlung:
- Naming-Konvention wechseln auf
<plugin-prefix>-<thema-präzise>mit präzisem statt verkettetem Namen. - Z. B.
selbstvertreter-sozialgericht/skills/eilantrag-86b-sggstattkompendium-08-buergergeld-ueberbru-bis-eilantrag-86b-sgg-gr. - Maximallänge selbst auferlegt: 45 Zeichen. Lässt Luft für Suffixe.
4. Plugin-für-Plugin: konkrete Befunde aus den Stichproben
4.1 selbstvertreter-sozialgericht (27 Skills, davon 26 Kompendien)
Plus: Allgemein-Skill ist hervorragend (V90-Stummer-Upload-Logik, einfache Sprache, drei Führungsstufen). Eilantrag-Modul professionell. Bürgergeld-Überbrückungsgeld nach Haftentlassung — fachlich solide.
Minus:
- Alphabetische Kompendienbildung verbindet IT-Anleitung (PDF) mit Sozialrechtsgrundlagen (§ 86b SGG).
- Jedes Modul wiederholt den BSG-Anker (Lehrende/Pilot/GmbH-GF), obwohl die Module Pflegegrad oder Bürgergeld betreffen.
- "Dolmetscher beim SG" und "Einfache Sprache Tipps" wären besser zusammengebündelt als jedes für sich.
Was Codex tun sollte:
- Themen-Cluster bauen: Eilrechtsschutz / Bescheidlogik / Pflegegrad / Bürgergeld / Rente / Krankenkasse / Verfahrensformalitäten / IT-Hilfsmittel / Zugänglichkeit.
- Pro Cluster ein Kompendium, ~5-7 Module.
- V90-Block aus den Modulen rausstreichen, nur im Allgemein-Skill belassen.
- Bei jedem Bürgergeld-Modul stattdessen einen Bürgergeld-spezifischen Norm-Anker (§§ 7, 19, 22 SGB II, § 41 SGB II) statt der falsch verorteten BAG-Lehrender-Az.
4.2 beamtenrecht (45 Skills, davon 22 Kompendien)
Plus: Modul "Amtsangemessene Alimentation Fünf Parameter" ist das beste Modul im gesamten Repo, das ich gesehen habe. BVerfGE-Band+Randnummer-Zitate, saubere erste/zweite Stufe-Trennung, ausdrückliche Klarstellung "Privatwirtschaftsvergleich ist NICHT Parameter erster Stufe". Das ist Pflichtlektüre.
Minus:
- 37 von 45 Skills haben identische "Status und Rechtsquelle"-Prüfprogramm-Boilerplate.
- Vier Mini-Skills (
red-team-beamtenrecht,output-waehlen-memo-widerspruch-eilantrag,quellenhygiene-beamtenrecht-fundstellen-red-team,versorgungsakte-dokumentenintake-und-berechnung) wiederholen sich semantisch. - Module "Besold-Neu-003 Eingruppierung" usw. sind teils sehr knapp, manche unter 30 Zeilen.
Was Codex tun sollte:
- Die vier Mini-Skills auf zwei oder einen einzigen reduzieren.
- Das Alimentations-Modul aus dem Kompendium-06-Cluster rausziehen, eigener Skill
beamtenrecht/skills/alimentation-fuenf-parameter. Das verdient als Solo-Skill aufzutauchen, nicht als Modul Nr. 6 von 7. - Restliche Besoldungs-Module dünner schreiben (Stichworte) und in zwei thematische Cluster verteilen (Grundbesoldung / Zulagen+Auslandsdienst).
4.3 roemisches-recht (27 Skills, davon 22 Kompendien)
Plus: Die Vergleichs-Module (röm. Institut ↔ BGB) sind didaktisch sauber. Digesten-Zitate korrekt formatiert (D. 12.6.1 etc.).
Minus:
- Kompendienbildung wieder alphabetisch nach
rom-NNN-Nummer, was die historische Reihenfolge unterbricht (Kompendium 1 hatrom-047,rom-133,rom-153— bunt durcheinander). - "rom-neu"-Module sind redundant zu den älteren "rom"-Modulen (z. B.
rom-neu-005-zwoelftafelgnebenrom-102-zwoelftafelg). - Allgemein-Skill habe ich nicht detailliert gelesen, aber bei 27 Skills + Kompendien-Pattern droht dasselbe V90-Doppelproblem.
Was Codex tun sollte:
rom- undrom-neu-Module zusammenführen, Duplikate (Zwölftafelgesetz, Bereicherungsrecht) auf je ein Modul reduzieren.- Re-Bündelung chronologisch oder systematisch (Personenrecht / Sachenrecht / Schuldrecht / Erbrecht / Prozessrecht / Rezeption), nicht alphabetisch nach rom-NNN.
- Die "Vergleich"-Module (rom-074 bis rom-080) sind didaktisch das Wertvollste — bündeln und prominenter machen.
4.4 preussisches-allgemeines-landrecht-pralr (28 Skills, davon 19 Kompendien)
Plus: Sehr spezifisches Thema, klar abgegrenzt, gute Stoffsammlung.
Minus:
pralr-spez-*- vs.pralr-NNN-*vs.pralr-neu-NNN-*— drei parallele Naming-Schemata in einem Plugin. Das deutet auf historisch gewachsene, nicht final aufgeräumte Inkonsistenz.- Beispiel:
kompendium-12-pralr-050-pralr-in-a-bis-pralr-neu-004-erstermischt alte und neue Nummerierung.
Was Codex tun sollte:
- Eine einzige Nummerierung erzwingen (pralr-NNN), neu durchnummerieren, Duplikate löschen.
pralr-spez-*(Spezialthemen wie Gesinderecht, Sklaverei) als eigene Sammlung im Kompendium "Spezialinstitute".
4.5 steuerrecht-anwalt-und-berater (91 Skills, davon nur 25 Kompendien — 63 spezifische)
Plus: Hier ist der Anteil substantieller Einzelskills hoch. Insbesondere die DBA-Skills (stb-dba-frankreich-1959, stb-dba-grenzgaenger-schweiz-60-tage-rueckkehr etc.) sind echte Fachanwalt-Tools — pro Land ein Skill ist genau richtig.
Minus:
- 25 Kompendien stehen neben 63 Spezialskills — die Kompendien wirken hier wie ein Fremdkörper. Wenn
stb-dba-belgienein Einzelskill bleibt, warum dannkompendium-15mit "stb-lohn-abfindungen bis stb-lohn-jobticket"? - Ungleichgewicht zwischen Bündelungsgrad in DBA (sehr granular, ein Land = ein Skill) und Lohnsteuer (gepoolt in Kompendien).
Was Codex tun sollte:
- Lohnsteuer-Kompendien aufbrechen — Abfindung, Jobticket, Kurzarbeit, Krankheit verdienen je einen eigenen Skill, weil sie distinkte Tatbestände sind.
- DBA-Skills so lassen wie sie sind, das ist Best Practice.
- Allgemein-Skill
anw-kaltstart-interviewist solide; die anderen drei kaltstart-Skills (anw-grest-kaltstart-asset-share-deal, anw-grundsteuer-kaltstart-bescheidkette) sind richtig granular.
4.6 arbeitszeugnis-analyse (50 Skills, 0 Kompendien)
Plus: Hier ist das einzige Plugin im Repo, in dem Codex die Kompendien-Welle nicht angewendet hat. Ergebnis: 50 saubere, fokussierte Einzelskills. rote-flaggen-katalog, orange-flaggen-katalog, gruen-flaggen-katalog, negative-codeworte-katalog — jedes ist ein eigener Mini-Katalog mit klarer Funktion.
Minus:
- Trotzdem zu viele Skills, weil das Plugin um vier Achsen oversliced: Farbampel (rot/orange/grün) × Form (Katalog/Workflow/Spezial) × Phase (Kaltstart/Mandatsannahme/Berichtigung) × Spezial-Topik (Schlussformel/Steigerungsadverbien/Zufriedenheitsformel).
- Beispiel:
spezial-codeworte-compliance-dokumentation-und-aktevs.geheimcode-katalogvs.negative-codeworte-katalog— drei Skills für eine Sache (Codes erkennen). - Trotz fehlender Kompendien: identischer V90-Fachkern-Block taucht hier auch in jedem Skill auf.
Was Codex tun sollte:
- Konsolidieren auf ~25 Skills max: 4 Flag-Kataloge (rot/orange/grün + Sonderzeichen) + 1 Negationskatalog + 6 Workflow-Skills (Kaltstart, Mandatsannahme, Berichtigung, Klage, Vergleich, Verhandlung) + 5 Spezialanalyse-Skills (Schlussformel, Notenformel, Strukturanalyse, Branche, Führungsposition) + 5 Output-Skills (Mandantenbericht, Tabellenausgabe, Drohbrief, Klageschrift, Vergleichsentwurf) + 3 Beweis-/Recht-Skills.
- Diese bewusst keine Kompendien-Pattern verwenden, sondern Anthropic-Style: ein Skill, eine Funktion, einen Trigger.
- Das Plugin als Referenz nutzen, wie das Repo aussehen sollte.
4.7 selbstvertreter-amtsgericht (30 Skills, davon 29 Kompendien — 96 %)
Plus: Allgemein-Skill kompendium-01-anfaenger-workflow-a-bis-fristbeginn-zustellu enthält das ausgezeichnete Drei-Führungsstufen-Modell. Triage-Tabelle (Rolle/Verfahrensstand/Frist/Streitwert/Gericht/Unterlagen/Ziel) ist sehr brauchbar.
Minus:
- 96 % Kompendien-Quote ist extrem. Quasi keine Einzelskills mehr.
- Innerhalb der Kompendien dieselben Boilerplate-Probleme wie in
selbstvertreter-sozialgericht.
Was Codex tun sollte:
- Aus dem Allgemein-Skill ggf. drei eigenständige Triage-Skills extrahieren (Klage-Triage, Beklagten-Triage, Vollstreckungs-Triage), falls die Drei-Führungsstufen-Logik in einer einzigen Datei zu viel wird.
4.8 Plugins, in die ich nicht im Detail geschaut habe, aber aus Strukturzahlen ableite
Bei den folgenden Plugins liegt die Kompendien-Quote über 85 %:
verbraucherschutzrecht-pruefer(93 %)haushaltsrecht-bho(93 %)telekommunikationsrecht(90 %)private-equity-praxis(90 %)insiderrecht-compliance(90 %)commercial-courts-deutschland(90 %)bundesnetzagentur-verfahren(28/32 = 88 %)
Hier ist die Vermutung: gleiche Probleme wie bei selbstvertreter-* — alphabetische Bündelung, V90-Wiederholung, generische Taglines. Codex sollte diese Plugins als nächste Welle anpacken.
Bei den großen Fachanwalts-Plugins (jeweils 45-58 Skills, davon ~22 Kompendien, also ~50 % Kompendien-Quote) ist die Mischung ähnlich wie bei beamtenrecht/steuerrecht: gute Spezialskills nebenher, aber Kompendien-Boilerplate raubt Kontext.
5. Anthropic-Niveau: was die uns als Maßstab vorgeben
Du hattest dich erinnert, dass wir uns Anthropic-Skills angeschaut hatten. Wesentliche Eigenschaften:
| Anthropic-Skill | Wir |
|---|---|
Eine Funktion pro Skill. pdf macht PDF, sonst nichts. |
Manche Kompendien decken 5+ disparate Themen ab. |
| Description ist Trigger. "Use when the user wants to read or write a PDF." | Description sagt oft methodisches Geräusch ("mit geführtem Workflow, Normencheck…"). |
| Kein Boilerplate im Body. Direkt Schritt 1, 2, 3. | Jeder Skill hat V90-Block, Quellenhygiene-Box, "Arbeitsregel"-Liste. |
| Beispiele zuerst. Was schreibt der User, was tut der Skill, was kommt zurück. | Beispiele oft am Ende oder fehlen. |
| Klare Voraussetzungen. "Requires X tool / Y permission." | Wir haben keine Tool-Voraussetzungen, weil die Skills tool-agnostisch sind, aber sagen das nicht offen. |
| Kompakt. Meist 80-200 Zeilen. | Unsere Kompendien sind 400-800 Zeilen. |
Daraus folgt — drei Schraubregeln, die ich Codex an die Hand geben würde:
- Skill = ein Tatbestand + ein Output. Wenn ein Skill mehrere Tatbestände abdeckt, prüfen, ob Aufspaltung möglich ist.
- V90-Block kommt ins Allgemein-Skill, sonst nirgends. Spezialskills haben einen eigenen, kurzen, modulspezifischen Normradar (3-5 Zeilen, nicht 6 generische).
- Description = Wann lade ich das? Nicht: Was kann das? Anthropic-Modell entscheidet anhand der
description, ob ein Skill geladen wird. Generische Description = Skill wird unter-/übertrieben oft geladen.
6. Konkrete Streich- und Verschmelz-Liste für Codex
Wenn ich Codex am Schluss zwei Stunden geben würde, würde ich ihn folgende fünf Operationen tun lassen:
Operation A: Boilerplate-Diet (geschätzte 5000 Zeilen weniger)
Für jedes SKILL.md in skills/kompendium-*/ und skills/komp-*/:
- Wenn V90-Block vorhanden UND identisch mit dem in skills/allgemein/SKILL.md:
→ Block entfernen, ggf. durch 3-zeiligen modulspezifischen Normradar ersetzen.
- Wenn "Qualitäts-Hardening"-Block am Ende vorhanden UND identisch mit anderen Skills:
→ Block entfernen, einmalig in skills/allgemein/SKILL.md belassen.
Operation B: Kompendien-Resort nach Sachzusammenhang
Pro Plugin:
- Aktuelle Kompendien-Module extrahieren.
- In thematische Cluster zu je 4-6 Modulen einsortieren (statt alphabetisch).
- Neue Kompendien-Slugs nach Pattern <plugin>-<cluster-name> (z. B. selbstvertreter-sozialgericht-eilrechtsschutz).
Operation C: Mini-Wrapper-Verschmelzung
Finde alle SKILL.md kleiner als 50 Zeilen ohne substantiellen Inhalt:
- red-team-* / output-waehlen-* / quellenhygiene-* / aktenstruktur-* / *-dokumentenintake
- Verschmelze zu einem Skill pro Plugin: skills/red-team-und-quality/SKILL.md
- Oder: in skills/allgemein/SKILL.md aufnehmen und Einzeldateien löschen.
Operation D: Slugnamen kürzen
Für alle Skill-Slugs > 50 Zeichen:
- Neuer Slug nach Pattern <thema-konkret> ohne "kompendium-NN-X-bis-Y"-Brücke.
- Lange Beschreibung statt verstümmelter Slug.
Operation E: Description-Trigger einschärfen
Für jedes SKILL.md:
- Description liest sich wie "Wenn der User X braucht, dann …", nicht wie "[Plugin]: X mit geführtem Workflow, Normencheck, …".
- Tagline "mit geführtem Workflow, …" streichen.
- Kommata in Zahlen nicht erlaubt (CLAUDE.md sagt das schon).
7. Wo ich unsicher bin (offene Fragen für deinen Vergleich mit Codex / Perplexity)
-
Ist die Kompendien-Schablone überhaupt das richtige Pattern, oder sollten wir komplett zurück zu Einzelskills?
- Pro Schablone: Reduziert Frontmatter-Overhead, gruppiert verwandte Themen, ein File pro Cluster.
- Contra Schablone: Lädt für eine konkrete Frage 500 Zeilen, davon 400 irrelevant. Anthropic macht das nicht.
- Mein Vorschlag: Beibehalten, aber chirurgischer einsetzen — nicht 96 % Kompendien-Quote wie bei
selbstvertreter-amtsgericht, sondern ~40 %. Restliche 60 % sollten Einzelskills sein.
-
Sollen wir den V90-Block überhaupt behalten? Er steht nirgends in der CLAUDE.md, wirkt aber wie Codex-erfundene Konvention.
- Pro: Einheitliche Quellenhygiene-Checkliste pro Plugin.
- Contra: 855-fach redundant.
- Mein Vorschlag: V90 als eigener kleiner Skill
skills/quellenhygiene-und-anker/SKILL.mdpro Plugin, einmal. Verweis inskills/allgemein/SKILL.md, nicht in jedes Modul.
-
Wie aggressiv reduzieren? Wenn Codex/Perplexity sagen "auf 3000 Skills runter", würde ich zustimmen. Wenn sie "auf 2000" sagen, wird's eng.
-
Was tun mit den 58 zu langen Slugs? Brechen wir die naming-Konvention auf oder zwingen Code zur Verkürzung?
8. Mein Ein-Satz-Urteil
Das Repo ist nach der Codex-Konsolidierung fachlich brauchbar, aber technisch noch zu generisch — die Kompendien-Schablone selbst ist Boilerplate geworden, die Bündelung ist alphabetisch statt semantisch, und Anthropic-Niveau (eine Funktion = ein Skill mit klarem Trigger) erreichen wir noch nicht. Mit den fünf Operationen oben kommen wir auf ~3000-3500 wirklich gut sortierte Skills, von denen jeder einzeln ladbar ist und genau eine Frage beantwortet.
Anhang: Daten zu den Stichproben
Gelesene Files
selbstvertreter-sozialgericht/skills/kompendium-08-buergergeld-ueberbru-bis-eilantrag-86b-sgg-gr/SKILL.md(589 Zeilen)beamtenrecht/skills/kompendium-06-besold-neu-003-besol-bis-besold-neu-009-minde/SKILL.md(384 Zeilen)selbstvertreter-amtsgericht/skills/kompendium-01-anfaenger-workflow-a-bis-fristbeginn-zustellu/SKILL.md(gelesen Anfang)roemisches-recht/skills/kompendium-11-rom-074-bereicherung-bis-rom-081-lateinische/SKILL.md(Anfang)arbeitszeugnis-analyse/skills/rote-flaggen-katalog/SKILL.md(65 Zeilen)steuerrecht-anwalt-und-berater/skills/anw-kaltstart-interview/SKILL.md(Anfang)selbstvertreter-sozialgericht/skills/allgemein/SKILL.md(Anfang)beamtenrecht/skills/red-team-beamtenrecht/SKILL.md(38 Zeilen)beamtenrecht/skills/output-waehlen-memo-widerspruch-eilantrag/SKILL.md(38 Zeilen)
Plugins mit hoher Kompendien-Quote (>85 %)
selbstvertreter-amtsgericht96 %verbraucherschutzrecht-pruefer93 %haushaltsrecht-bho93 %telekommunikationsrecht90 %private-equity-praxis90 %insiderrecht-compliance90 %commercial-courts-deutschland90 %bundesnetzagentur-verfahren88 %
Plugins mit niedriger Kompendien-Quote (Vergleichsfälle)
arbeitszeugnis-analyse0 % (50 Skills, alle Einzelskills)steuerrecht-anwalt-und-berater27 % (91 Skills, davon 25 Kompendien)ki-richtlinie-kanzleien33 % (48 Skills, davon 16 Kompendien)