update

skills/README.md

@@ -0,0 +1,28 @@
+# Skill-Vertrag (Lektion 106: ein Protokoll, keine Sonderfälle)
+
+Komposition: 1 Rolle + 0..n Stile + 1 Aufgabe. Nur die Aufgabe definiert das
+Ausgabeformat. Welche Skills ein Knoten nutzt, steht AUSSCHLIESSLICH in
+pipeline.yaml (`skills:` + `extra_skills:`) — nie im Worker-Code.
+
+## Prompt-Struktur (Parser und Fakes verlassen sich darauf)
+
+- Eingabe-Abschnitte: `NAME:` in GROSSBUCHSTABEN am Zeilenanfang, Inhalt in
+  den Folgezeilen. Erlaubte Klammer-Zusätze klein dahinter.
+- Nummerierte Mehrfach-Eingaben: `=== NAME <n> ===`-Zeilen.
+- Der Format-Abschnitt beginnt mit einer Zeile, die mit `Ausgabeformat`
+  anfängt. Regeln stehen unter `Regeln:`.
+
+## Ausgabe-Protokoll
+
+- Blöcke: `===MARKE===`, Felder `FELD: wert` (GROSS, 2-20 Zeichen).
+- Leere pro Eingabe-Element: genau EIN Marker projektweit — `===LEER===`
+  mit dem ID-Feld des Elements. Kein NICHTS, kein OK, kein Freitext.
+- Leeres Einzel-Feld: genau EIN Wert projektweit — `KEINER`.
+- Paar-Aufgaben rendern Eingaben einheitlich über `textkit.paar_liste`
+  (`PAAR n:` / `A:` / `B:`).
+- Protokoll-Tokens (Urteile wie `dublette`, `mangel`) sind sprachneutrale
+  Enum-Marker und ändern sich bei Übersetzungen NICHT.
+
+Sprachvorgabe für Prosa-Ausgaben liegt allein im Stil-Skill
+(deutsch-praezise) — Aufgaben-Prompts enthalten keine sprachspezifischen
+Beispiel-Floskeln.

skills/aufgabe/anker-fix.md

@@ -13,9 +13,9 @@ ATOME:
 QUELLTEXT:
 {{quelltext}}
 
-Regeln: ZITAT zeichengetreu aus dem Quelltext (mindestens ein voller Satz); gibt es keine passende Stelle, schreibe exakt VERWERFEN.
+Regeln: ZITAT zeichengetreu aus dem Quelltext (mindestens ein voller Satz); gibt es keine passende Stelle, schreibe exakt KEINER.
 
 Ausgabeformat — GENAU so, ein Block pro Atom:
 ===FIX===
 ID: <Atom-ID>
-ZITAT: <wörtliches Zitat oder VERWERFEN>
+ZITAT: <wörtliches Zitat oder KEINER>

skills/aufgabe/bausteine.md

@@ -7,10 +7,10 @@ platzhalter: [ziel, atome, band]
 
 Teile die Atome des Lernziels „{{ziel}}" in Bausteine mit je {{band}} Atomen. Ein Baustein ist eine didaktische Einheit, die man am Stück lernt.
 
-ATOME (in Quellreihenfolge):
+ATOME:
 {{atome}}
 
-Regeln: jede Atom-ID genau einmal; Reihenfolge innerhalb eines Bausteins beibehalten; TITEL beschreibt den Baustein-Inhalt.
+Regeln: die Atome stehen in Quellreihenfolge; jede Atom-ID genau einmal; Reihenfolge innerhalb eines Bausteins beibehalten; TITEL beschreibt den Baustein-Inhalt.
 
 Ausgabeformat — GENAU so, ein Block pro Baustein:
 ===BAUSTEIN===

skills/aufgabe/guide-fix.md

@@ -16,7 +16,7 @@ BEFUNDE:
 BELEGE (Faktenbasis):
 {{belege}}
 
-Regeln: Marker-Zeilen `<!-- atom: id -->` unverändert lassen; bei Redundanz-Befunden die Wiederholung ersatzlos streichen oder durch einen knappen Prosa-Halbsatz ersetzen („wie bereits beim … beschrieben") — KEINE Links; keine H1-H3, keine Fettzeilen-Definitionen; Zahlen nur mit ehrlicher Quellenangabe.
+Regeln: Marker-Zeilen `<!-- atom: id -->` unverändert lassen; bei Redundanz-Befunden die Wiederholung ersatzlos streichen oder durch einen knappen Prosa-Halbsatz ersetzen („wie bereits beim … beschrieben") — KEINE Links; Zahlen nur mit benannter Quelle. Vorhandene Tabellen, Listen und Code-Blöcke strukturell erhalten — nur ihren Inhalt korrigieren.
 
 Ausgabeformat:
 ===TEXT===

skills/aufgabe/guide-pruefung.md

@@ -9,13 +9,13 @@ Prüfe jede Guide-Section gegen ihre Belege.
 
 {{sections}}
 
-Suche NUR: (a) falsch = Aussage widerspricht den Belegen, ist unbelegt erfunden, oder verkauft eine Zahl ohne konkrete Studie als pauschale Studienaussage bzw. erfindet Bedingungen dazu; (b) luecke = ein Atom des Bausteins wird nicht wirklich erklärt; (c) stil = grober Verstoß (englische Passagen, Floskeln, kaputtes Markdown). Kein Geschmacks-Feedback. SECTION ist die angegebene Section-ID.
+Suche NUR: (a) falsch = Aussage widerspricht den Belegen, ist unbelegt erfunden, oder nennt eine Zahl/Quantität ohne benannte Quelle bzw. erfindet Bedingungen dazu; (b) luecke = ein Atom des Bausteins wird nicht wirklich erklärt; (c) stil = grober Verstoß (englische Passagen, Floskeln, kaputtes Markdown). Kein Geschmacks-Feedback. SECTION ist die angegebene Section-ID.
 
-Ausgabeformat — GENAU so, keine Prosa. Je Section: ein Block pro Befund; hat eine Section keine Befunde, schreibe für sie einen OK-Block. JEDE Section muss in der Ausgabe vorkommen:
+Ausgabeformat — GENAU so, keine Prosa. Je Section: ein Block pro Befund; hat eine Section keine Befunde, schreibe für sie einen LEER-Block. JEDE Section muss in der Ausgabe vorkommen:
 ===BEFUND===
 SECTION: <Section-ID>
 ART: falsch | luecke | stil
 STELLE: <wörtliches Kurzzitat aus der Section>
 DETAIL: <ein Satz>
-===OK===
+===LEER===
 SECTION: <Section-ID>

skills/aufgabe/kapitel-intro.md

@@ -5,7 +5,9 @@ beschreibung: Inhaltsfreien 2-3-Satz-Einstieg für ein Kapitel schreiben
 platzhalter: [kapitel, sections, vorherige]
 ---
 
-Schreibe 2-3 Einstiegssätze für das Kapitel „{{kapitel}}": Was lernt man hier und warum jetzt.
+Schreibe 2-3 Einstiegssätze für das folgende Kapitel: Was lernt man hier und warum jetzt.
+
+KAPITEL: {{kapitel}}
 
 SECTION-TITEL DES KAPITELS:
 {{sections}}
@@ -13,7 +15,7 @@ SECTION-TITEL DES KAPITELS:
 BEREITS GELESENE KAPITEL (nur DIESE dürfen als Rückbezug vorkommen — gibt es keine, dann KEIN Rückbezug):
 {{vorherige}}
 
-Regeln: KEINE fachlichen Inhalte vorwegnehmen; KEINE Links; keine Floskeln wie „schlägt die Brücke", „des betrachteten Systems", „Lerngruppe" — konkret zum Thema bleiben.
+Regeln: KEINE fachlichen Inhalte vorwegnehmen; KEINE Links; keine inhaltsleeren Überleitungs- und Verwaltungsfloskeln — konkret zum Thema bleiben.
 
 Ausgabeformat:
 ===INTRO===

skills/aufgabe/lektorat.md

@@ -0,0 +1,25 @@
+---
+name: lektorat
+art: aufgabe
+beschreibung: Den ganzen Guide als Lektor lesen — Dopplungen, Splitter, zähe Übergänge
+platzhalter: [guide]
+---
+
+Lies den kompletten Lern-Guide wie ein Lektor eines Kurzbuchs. Die Sections sind mit [SECTION <id>] markiert.
+
+GUIDE:
+{{guide}}
+
+Suche NUR die drei größten Probleme je Art:
+(a) redundanz = derselbe Fakt, dieselbe Studie oder Aussage wird in mehreren Sections erneut erklärt (Rückverweis in einem Halbsatz ist okay);
+(b) stil = eine Section ist ein Splitter (nur 1-2 Sätze) oder ein Übergang ist zäh/formelhaft und bremst den Lesefluss.
+
+Nenne höchstens 8 Befunde, die wichtigsten zuerst. SECTION ist die ID der Section, die geändert werden soll (bei Dopplung: die spätere).
+
+Ausgabeformat — GENAU so, ein Block pro Befund; keine Befunde → als einzige Ausgabe ein LEER-Block:
+===BEFUND===
+SECTION: <id>
+ART: redundanz | stil
+DETAIL: <ein Satz: was doppelt/zäh ist und was stattdessen>
+===LEER===
+OK: ja

skills/aufgabe/luecke-nachextraktion.md

@@ -11,12 +11,12 @@ Zu den folgenden Soll-Punkten fehlen Wissensatome. Extrahiere aus dem jeweiligen
 
 Regeln: wie bei der Atom-Extraktion (TITEL/TYP/DEFINITION/ZITAT, Zitat zeichengetreu aus dem Fenster des Punkts); Aufzählungspunkte derselben Kategorie sind zusammen EIN Atom; SOLL ist die ID des Soll-Punkts.
 
-Ausgabeformat — GENAU so, keine Prosa. Deckt ein Fenster seinen Punkt nicht ab, schreibe für ihn einen NICHTS-Block. JEDER Soll-Punkt muss in der Ausgabe vorkommen:
+Ausgabeformat — GENAU so, keine Prosa. Deckt ein Fenster seinen Punkt nicht ab, schreibe für ihn einen LEER-Block. JEDER Soll-Punkt muss in der Ausgabe vorkommen:
 ===ATOM===
 SOLL: <Soll-ID>
 TITEL: …
 TYP: …
 DEFINITION: …
 ZITAT: …
-===NICHTS===
+===LEER===
 SOLL: <Soll-ID>

skills/aufgabe/ordnung.md

@@ -10,7 +10,9 @@ Ordne die folgenden {{art}} in die beste Lernreihenfolge: Definition/Begriff/Her
 ELEMENTE:
 {{liste}}
 
-Vorschlag nach Quellreihenfolge (nur bei Gleichwertigkeit übernehmen): {{prior}}
+PRIOR: {{prior}}
+
+PRIOR ist der Vorschlag nach Quellreihenfolge; nur bei Gleichwertigkeit übernehmen.
 
 Regeln: Ausgabe ist eine EXAKTE Permutation aller IDs — jede genau einmal.
 

skills/aufgabe/quellen-relevanz.md

@@ -1,17 +0,0 @@
----
-name: quellen-relevanz
-art: aufgabe
-beschreibung: Suchtreffer auf inhaltliche Relevanz für ein Lernthema filtern
-platzhalter: [thema, treffer]
----
-
-Unten stehen Web-Suchtreffer für einen Lern-Guide zum Thema „{{thema}}". Behalte nur Treffer, die inhaltlich LEHREN (Erklärungen, Anleitungen, Hintergründe).
-
-TREFFER:
-{{treffer}}
-
-Aussortieren: Produkt-/App-Listen, Shops, Werbeseiten, Foren-Schnipsel, Off-Topic — auch Job-, HR-, Karriere- und Ratgeberportale, deren Kern ein ANDERES Thema ist (die das Thema nur beiläufig erwähnen).
-
-Ausgabeformat — GENAU so:
-===RELEVANT===
-IDS: <kommagetrennte Nummern der behaltenen Treffer>

skills/aufgabe/quellen-urteil.md

@@ -0,0 +1,21 @@
+---
+name: quellen-urteil
+art: aufgabe
+beschreibung: Geladene Quelle auf Nützlichkeit für ein Lernthema beurteilen
+platzhalter: [thema, titel, auszug]
+---
+
+Entscheide, ob diese geladene Quelle für einen Lern-Guide zum Thema „{{thema}}" nützlich ist.
+
+TITEL: {{titel}}
+
+AUSZUG (Anfang des Textes):
+{{auszug}}
+
+Nützlich = der Text LEHRT etwas zum Thema (Erklärungen, Anleitungen, Hintergründe, Referenz).
+Nicht nützlich = Produkt-/App-Listen, Shops, Kurs-Werbung, Login-/Fehlerseiten, reine Linklisten, oder der Kern ist ein ANDERES Thema.
+
+Ausgabeformat — GENAU so, genau ein Block:
+===URTEIL===
+NUETZLICH: ja | nein
+GRUND: <ein kurzer Satz>

skills/aufgabe/recherche-plan.md

@@ -10,10 +10,10 @@ Erzeuge je Blickwinkel 3 Web-Suchanfragen zum Thema „{{thema}}" (Runde {{runde
 BLICKWINKEL:
 {{lenses}}
 
-Bereits verwendete Suchanfragen (NICHT wiederholen, neue Winkel finden):
+BISHERIGE SUCHANFRAGEN (nicht wiederholen, neue Winkel finden):
 {{bisherige_queries}}
 
-Regeln: kurze, konkrete Suchanfragen (2-6 Wörter); deutsch oder englisch je nachdem, wo bessere Quellen zu erwarten sind; LENS ist exakt einer der gegebenen Blickwinkel-Namen.
+Regeln: kurze, konkrete Suchanfragen (2-6 Wörter); in der Sprache, in der die besten Quellen zu erwarten sind; LENS ist exakt einer der gegebenen Blickwinkel-Namen.
 
 Ausgabeformat — GENAU so, ein Block pro Suchanfrage, keine Prosa; JEDER Blickwinkel bekommt seine Blöcke:
 ===QUERY===

skills/aufgabe/soll-beleg.md

@@ -1,21 +0,0 @@
----
-name: soll-beleg
-art: aufgabe
-beschreibung: Gebündelte Beleg-Nachsuche für offene Soll-Punkte in einer Quelle
-platzhalter: [punkte, quelltext]
----
-
-Suche für jeden der folgenden Soll-Punkte ein wörtliches Beleg-Zitat im Quelltext.
-
-PUNKTE:
-{{punkte}}
-
-QUELLTEXT:
-{{quelltext}}
-
-Regeln: BELEG zeichengetreu aus dem Quelltext; findet sich keiner, schreibe exakt KEIN BELEG.
-
-Ausgabeformat — GENAU so, ein Block pro Punkt:
-===BELEG===
-ID: <Punkt-ID>
-BELEG: <wörtliches Zitat oder KEIN BELEG>

skills/aufgabe/writer.md

@@ -16,7 +16,7 @@ BELEGE (Faktenbasis — nichts behaupten, was hier nicht steht):
 BEREITS BEHANDELT (nur als knapper Prosa-Halbsatz erwähnen, falls nötig — NIE erneut erklären, KEINE Links):
 {{bekannt}}
 
-Regeln: Länge {{band}} Wörter; jeder Marker `<!-- atom: id -->` genau einmal; KEINE Markdown-Links; keine Überschrift für den Baustein-Titel und keine H1-H3 (Unterpunkte als ####); Feldnamen/Rohformate aus der Eingabe nie übernehmen; Zahlen und Statistiken nur mit ehrlicher Quellenangabe aus den Belegen („laut Anbieter X", „eine Studie der Universität Y") — nie pauschal „Studien zufolge", nichts dazuerfinden.
+Regeln: Länge {{band}} Wörter; jeder Marker `<!-- atom: id -->` genau einmal; KEINE Markdown-Links; keine Überschrift für den Baustein-Titel; Feldnamen/Rohformate aus der Eingabe nie übernehmen; Zahlen und Quantitäten nur mit benannter Quelle aus den Belegen — nie pauschal zugeschrieben, nichts dazuerfinden.
 
 Ausgabeformat — GENAU so, keine Prosa außerhalb:
 ===TEXT===

skills/stil/darstellung.md

@@ -0,0 +1,13 @@
+---
+name: darstellung
+art: stil
+beschreibung: Darstellungsform folgt dem Inhaltstyp — Liste, Tabelle, Code statt Schachtelsatz
+---
+
+Wähle je Inhalt die am schnellsten lesbare Form:
+- Abläufe und Verfahren mit festen Schritten → nummerierte Liste (1., 2., …), ein Schritt pro Zeile.
+- Gegenüberstellungen, Varianten, Kennwerte → Tabelle mit maximal 4 Spalten und kurzen Zellen.
+- Formale Notation (Code, Formeln, Konfiguration, strukturierte Auszüge) → umschlossener Block mit passender Kennzeichnung; kurze Bezeichner im Fließtext als `Inline-Code`.
+- Alles andere → knappe Prosa.
+
+Grenzen: Form ersetzt Prosa, sie ergänzt sie nicht — kein Inhalt doppelt als Text UND Tabelle. Keine zusätzlichen Beispiele, Analogien oder Merksätze erfinden. Höchstens zwei ####-Zwischentitel pro Section.

skills/stil/guide-lesbarkeit.md

@@ -5,9 +5,8 @@ beschreibung: Lesbarkeits-Regeln für Guide-Text (linear lesbar, keine Links, ke
 ---
 
 - Ein Konzept pro Abschnitt; nie zwei neue Ideen gleichzeitig einführen.
-- Der Text wird LINEAR gelesen: KEINE Links im Fließtext, kein „Wie in [X] gezeigt". Rückbezug auf früher Gelehrtes = knapper Halbsatz in Prosa („wie beim Vierer-Rhythmus beschrieben") — und nur, wenn er dem Verständnis dient.
+- Der Text wird LINEAR gelesen: KEINE Links im Fließtext, kein „Wie in [X] gezeigt". Rückbezug auf früher Gelehrtes = knapper Halbsatz in Prosa („wie im früheren Abschnitt beschrieben“) — und nur, wenn er dem Verständnis dient.
 - Bereits Gelehrtes NIE erneut erklären. Auch keine Meta-Sätze darüber („wird hier nicht erneut aufgegriffen", „schlägt die Brücke", „dieses Kapitel behandelt").
 - Gelieferte Kern-Definitionen EINARBEITEN, nie als Fettzeile zitieren und danach paraphrasieren — jede Information genau einmal.
 - Erklärung vor Beispiel: erst max. 5 Sätze Konzept, direkt danach das Beispiel.
 - Unterpunkte innerhalb des Textes als H4 (####) oder Aufzählung — H1 bis H3 setzt die Montage, nie du.
-- Tabellen nur mit maximal 4 Spalten und kurzen Zellen; sonst Liste.