Communitygithub.com

bertbertov/buch-erstellungspipeline

Claude Code Skills für die vollständige Buchproduktion: Schreiben, Illustration, Kompilierung, Hörbuch, Veröffentlichung

Was ist buch-erstellungspipeline?

Diese Skill-Sammlung bietet einen vollständigen, bewährten Workflow für die Produktion von Büchern – von einem einzelnen Taschenbuch bis zu einer 10-bändigen Serie. Sie umfasst alle Phasen: Konzeptfindung (mit Fokus auf Sprachregister, Erzählerstimme und Markttauglichkeit), Cover-Generierung (unter Verwendung von Google Gemini Nano Banana Pro oder Flux Krea Dev), Erstellung von Innenillustrationen (mit einem verpflichtenden Freigabegatter aus 10 Testskizzen), Manuskriptentwurf (parallelisierbar für Serien via Anthropic-API-Limit von 4 Agenten), Kompilierung zu EPUB und PDF, Hörbuchproduktion (Kokoro für Englisch, F5-TTS für Russisch) und die Veröffentlichungsvorbereitung für Amazon KDP. Sie enthält kritische Lektionen und Fehlervermeidungsstrategien aus der Praxis, wie z. B. das Testen der Erzählerstimme an einem Kapitel vor der Massenproduktion, die Vermeidung von weißem Himmelsraum auf Covern und die Verwendung von Markierungstokens ([SKETCH:], [QUOTE:], [SEEDS]) für nahtlose Nachbearbeitung. Die Skill ist für Claude Code, Cursor und andere KI-Agenten-Plattformen optimiert, die Skriptausführung und Dateimanagement auf der Kommandozeile unterstützen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add bertbertov/book-creation-pipeline

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht buch-erstellungspipeline?

Workflow zur End-to-End-Produktion von illustrierten Büchern – eines oder mehrere – von der Idee bis zur Auflistung im Handel. Ergänzung zu illustrated-book (Details zum Einzelbuch-Layout); verwenden Sie diese Skill, wenn der Benutzer etwas von einem einzelnen illustrierten Taschenbuch bis zu einer 10-bändigen Serie erstellt.

Wann verwenden

  • "Hilf mir, ein Buch / eine Buchreihe zu schreiben"
  • "Gleiches Cover-Format, gleiche Stimme, gleicher Illustrationsstil über N Bücher hinweg"
  • "Generiere das gesamte Manuskript mit Covern und Innen-Skizzen"
  • "Übersetze meine Idee in ein veröffentlichungsfertiges Amazon-Taschenbuch + Kindle + Hörbuch"

Wann NICHT verwenden

  • Eine originalgetreue Übersetzung eines fremden, urheberrechtlich geschützten Werks – siehe Gespräch zu Übersetzungsrechten
  • Ein Kinderbilderbuch – andere Layout-/Illustrationspipeline
  • Reine Sachliteratur-Nachschlagewerke (Lehrbücher, Handbücher) – andere Struktur
  • Ein literarischer Roman, dessen visuelles Merkmal fotografisch ist – illustrated-book-Skill direkt mit Muster A oder B verwenden

Die Pipeline (beliebig viele Bücher)

Im Folgenden finden Sie den bewährten Workflow. Er skaliert: Ein einzelnes Buch durchläuft die Phasen 0-9 nacheinander. Eine N-bändige Serie fügt in Phase 5 parallelen Agentenversand und in Phase 1 eine SERIES_GUIDE.md hinzu. Die nachgelagerten Phasen (Kompilierung, Hörbuch, Veröffentlichung) sind pro Buch identisch.

Phase 0 – Konzeptfestlegung (BENUTZER-Abstimmung, obligatorisch)

Bevor Sie etwas schreiben, stimmen Sie mit dem Benutzer ab:

  1. Anzahl der Bücher, Titel und der rote Faden. Welche Angst / welches Fachgebiet / welche Neugier spricht jedes Buch an? Für ein einzelnes Buch reichen Titel + Aufhänger. Für N Bücher der Serienbogen.
  2. Sprachregister. Wählen Sie eines aus und bestätigen Sie es mit einem Absatz Beispieltext:
    • Manson-würzig (Kraftausdrücke, direkt)
    • Burkeman-intellektuell (keine Flüche, kontemplativ)
    • Manson × Burkeman × Gor (lockere Selbsthilfe, leichte östliche Weisheit, keine Flüche)
    • Pelevin-traditionell literarisch (philosophisch, surreal, dicht)
    • Sebald-artig meditativ (Fotografien, durchsetzt mit Prosa)
  3. Autorenpersönlichkeit – wichtigste Entscheidung.
    • Autobiografisch (der Benutzer) – fesselnd, aber riskant, wenn der Benutzer eine Nische ist
    • Pseudo-autobiografisch generisch ("ein Ingenieur Mitte 30", "ein Lehrer in den 40ern") – breitere Anziehungskraft
    • Dritter-Person fiktiver Erzähler
    • Kritischer Test: Fragen Sie "Was ist der Kaltkäufer-Aufhänger?" Wenn die Persönlichkeit eine Leservorbildung erfordert, bevor sie ansprechen kann (Nischen-Subkultur, Emigranten-Framing, spezifische religiöse Tradition), wird der kalte Amazon-Käufer nicht anbeißen. Generisch-aber-relatierbar gewinnt fast immer.
    • Führen Sie ein 1-Kapitel-Beispiel DURCH, BEVOR Sie im großen Stil parallel schreiben. Eine nach 100.000 Wörtern entdeckte Persönlichkeitsdrift ist brutal zu korrigieren.
  4. Erscheinungsrhythmus (nur bei mehreren Büchern). Schnelle Veröffentlichung in 2-4 Wochen (maximaler KDP-Algorithmus-Boost) vs. einzeln.
  5. Sprachen. Nur EN oder EN + RU / andere – beeinflusst die Wahl der Hörbuch-Engine (siehe project_audiobook_engine.md).
  6. Rechte. Wenn der Benutzer bestehende Bücher als "Vorlage" nennt, bestätigen Sie, ob er Übersetzungsrechte besitzt. Ein Originalwerk in ähnlichem Register ist reinecht; Übersetzung ohne Rechte ist es nicht.

Phase 1 – Ordnerstruktur

Bücher/<Projektname>/
├── _serie/                         # nur für mehrere Bücher; bei Einzelbuch überspringen
│   ├── SERIES_GUIDE.md              # Stimme + Persönlichkeit + wiederkehrende Elemente + Kunstbibel
│   ├── _gen_covers.py               # Cover-Generator
│   ├── _gen_sketches.py             # Innen-Skizzen-Generator
│   └── test_sketches/               # Freigabe-Muster
├── 01_<Buch_Slug>/                  # bei Einzelbuch nur ein Ordner unter Bücher/
│   ├── BOOK_PLAN.md                 # Kapitelgliederung (beliebig viele Kapitel; typisch 25)
│   ├── chapters/                    # NN_slug.txt-Dateien
│   ├── images/00_cover.png          # Hauptcover
│   └── sketches/                    # Innenillustrationen
├── 02_<Buch_Slug>/...               # weitere Bücher
└── _publishing/                     # Metadaten-Kits pro Buch

SERIES_GUIDE.md (oder BOOK_GUIDE.md für Einzelbuch) muss enthalten:

  • Sprachregister (mit positiven Beispielen + VERBOTENE Register)
  • Erzählerpersönlichkeit (spezifische Biografie, Textur, Dinge, die herangezogen werden sollen, Dinge, die NICHT preisgegeben werden sollen)
  • Wiederkehrende Elemente (z. B. "Ich habe das versucht"-Muster, modern nacherzählte Parabel, ein meditativer Anker – wählen Sie eine universelle Praxis, wenn das Buch Weisheitsmomente hat)
  • Skizzen-Kunstbibel (FESTGELEGTER Prompt-Präfix; durch Freigabemuster getestet)
  • Cover-Bibel (Kompositionsformel – dasselbe X über alle Cover der Serie hinweg)
  • Marker-Konventionen (Phase 4)
  • Produktions-Checklisten

Phase 2 – Cover-Generierung

Beste Qualität für lesbaren Text auf dem Cover: Google Geminis Nano Banana Pro-Modell (nano-banana-pro-preview). Am besten für allgemeine Szenen mit sauberer Typografie: Nano Banana Flash (gemini-2.5-flash-image). Lokale Alternative: Flux Krea Dev FP8 über ComfyUI.

API-Schlüssel müssen über Umgebungsvariablen bereitgestellt werden – niemals fest im Skript codiert:

export GEMINI_API_KEYS="key1,key2,key3,key4"   # kommagetrennt, werden rotiert

Oder pro Aufruf:

import os
keys = os.environ["GEMINI_API_KEYS"].split(",")

Cover-Kompositionsformel (bewährt für lockere Selbsthilfereihen; je nach Genre anpassen):

  • Oben: AUTORENNAME in gesperrten Großbuchstaben mit optionalem Logo-Trenner
  • Titel: fette, handgezeichnete Großbuchstaben, die das obere Drittel ausfüllen (der Clickbait-Headline)
  • Untertitel in Akzentfarbe (das beschreibende Versprechen)
  • Hauptmotiv klein im Bild, Umgebung dominiert
  • Fußzeile: kleiner, gesperrter Anreißer (z. B. "VOM AUTOR VON ___")
  • Serienkohäsion: gleiches wiederkehrendes visuelles Motiv über alle Cover hinweg (ein Hut, ein Stuhl, ein Fenster – alles Konsistente)

Prompt-Regeln (gelernt am 25.04.2026):

  • NICHT nach "leerem weißem Himmelsraum oben" fragen → erzeugt flache, ausgewaschene Stelle. Lassen Sie die Szene den Rahmen füllen; Titel auf natürlichen Schatten legen.
  • DO geben Sie den genauen Text in Anführungszeichen an ("der Text lautet genau: '…'") – Pro reproduziert wortgetreu.
  • DO sagen Sie "die gesamte Szene füllt den Rahmen bis ganz oben aus, KEIN ausgewaschener Negativraum."

Phase 3 – Skizzen-Freigabegatter (obligatorisch)

Generieren Sie NICHT die vollständige Skizzenserie, bevor Sie die Benutzerfreigabe erhalten haben. Gehen Sie immer wie folgt vor:

  1. ~10 Testskizzen in hoher Qualität generieren (Flux Krea Dev FP8 bei 1024×1024, 25 Schritte)
  2. Dem Benutzer zeigen → auf Freigabe warten
  3. Nach Freigabe auf schnellere Produktionseinstellungen umschalten (768×768, 18 Schritte) für ~3-4× Beschleunigung
  4. Beschleunigte Einstellungen mit 1 Skizze testen – bestätigen, dass die Qualität dem freigegebenen Stil entspricht
  5. Dann vollständige Serie ausführen

Festgelegter Produktions-Prompt-Präfix für Cartoon-Line-Art (Gor-Ästhetik, bewährt am 25.04.2026):

Schwarze Tinte, lockerer, handgezeichneter Federstrich auf reinweißem Hintergrund,
minimalistische Cartoon-Line-Art, einzelnes Motiv, keine Schattierung, keine Füllungen, keine Graustufen,
keine Farbe, kein Farbverlauf, kein Hintergrunddetail, nur schwarze Linien auf Weiß,
einfache ausdrucksstarke Konturlinien, leichtes Wackeln, viel leerer weißer Raum,
flache 2D-Illustration, das gesamte Bild ist reines, festes Weiß mit nur schwarzen Tintenlinien darauf.
KEIN Foto, KEINE Notizbuchseite, KEINE Papierstruktur, KEIN Rahmen, KEINE Bindung, KEIN Rand.

Festgelegter Negativ-Prompt:

fotorealistisch, Foto einer Skizze, Foto eines Notizbuchs, Papierstruktur,
Notizbuchbindung, Seitenränder, Skizzenbuch, Tagebuch, Rahmen um die Zeichnung,
3D-Rendering, Farbe, Farbverlauf, Schattierung, Aquarell, Ölfarbe, Anime, Manga,
aufwändiger Hintergrund, überladene Komposition, detaillierte Umgebung, graue Füllungen,
Kreuzschraffur, dichte Linienführung, dekorativer Rand, dunkler Hintergrund, schwarzer Hintergrund

Häufige Falle: Wenn Skizzen als Fotos von Federzeichnungen in einem Notizbuch zurückkommen, hat Ihr Prompt "Taschenbuch" / "Notizbuch" / "zwischen Absätzen" erwähnt → entfernen Sie diese Phrasen.

Für andere Stile (Aquarell, Fotocollage, Vektor-Flat usw.) ersetzen Sie den Prompt-Präfix und führen Sie dasselbe Freigabegatter durch.

Nachbearbeitung: Jedes Pixel mit R+G+B > 720 → auf (255,255,255) setzen. Entfernt fast-weiße Farbstiche.

Phase 4 – Pro-Buch BOOK_PLAN.md

Jedes Buch erhält eine Kapitelgliederung. Drei Akte zu je etwa ⅓. Erforderliche Elemente:

  • Dateinamens-Slug für jedes Kapitel (snake_case)
  • Ein-Absatz-Kapitelzusammenfassung
  • Skizzenhinweisliste (wiederkehrende visuelle Elemente)
  • Anreißer-Kandidatenpool (der Agent verwendet einige, erfindet andere)
  • Wiederkehrende Platzierung des meditativen Ankers (~3 Kapitel pro Buch, falls zutreffend)
  • Querverweisregeln (nur für Serien mit mehreren Büchern relevant)

Kapitelanzahl: 15-30 ist typisch. Einige Manifeste funktionieren mit 10 Kapiteln; einige literarische Romane mit 40+.

Phase 5 – Manuskripterstellung

Einzelbuch: EINEN general-purpose-Agenten mit der BOOK_GUIDE.md + BOOK_PLAN.md beauftragen.

Serie mit mehreren Büchern (parallel): EINEN general-purpose-Agenten PRO BUCH beauftragen. Jeder Agent erhält:

  • Pfad zur SERIES_GUIDE.md (zuerst lesen)
  • Pfad zu seiner BOOK_PLAN.md
  • Persönlichkeitsspezifikation im Prompt selbst (verteidigt in der Tiefe)
  • Ausgabeordner-Spezifikation
  • Marker-Konventionen (Phase 6)
  • Wortziel pro Kapitel und insgesamt
  • Speichern-während-des-Arbeitens-Anweisung (nicht im Speicher bündeln)
  • Rückmeldeformat

Anthropic-API-Limit: 4 parallele general-purpose-Agenten ist die sichere Obergrenze. 5+ können drosseln.

Achtung Persönlichkeitsdrift. Der häufigste Fehlermodus ist, dass der Agent die falsche Persönlichkeitstextur aufgreift. Überprüfen Sie während des Vorgangs regelmäßig mit Grep auf verbotene Tokens (alles, was Sie im GUIDE als tabu definiert haben). Wenn erkannt, anhalten, archivieren, den GUIDE nachdrücklicher umschreiben, erneut beauftragen.

Phase 6 – Marker-Konventionen

Quell-.txt-Dateien verwenden Marker-Tokens, die das Kompilierungsskript ersetzt.

MarkerWoRendert als
[SKETCH: Beschreibung der Szene]Inline, eigene ZeileEine vorab generierte PNG-Skizze, an dieser Position eingefügt
[QUOTE: ein-sätziger Anreißer]InlineEPUB: gestylter HTML-Anreißer-Callout. PDF: gestylter Callout ODER als Grafik neu generiert
[SEEDS]…[/SEEDS]Am Kapitelende, mit - AufzählungszeichenGestylte Callout-Box mit kursiven Serifen-Aphorismen (das Gor-„Samen der Weisheit"-Element)
Erster und letzter img_map-EintragPro Kapitel BildkarteGanzseitige Marquee-Illustration VOR dem Kapiteltext. Mittlere Einträge → Textumbruch (Muster B v2 aus illustrated-book-Skill)

Passen Sie jeden Marker je nach Genre an oder lassen Sie ihn weg. Selbsthilfe und Pop-Spiritualität verwenden alle vier. Literarische Romane verwenden oft nur [SKETCH:] und die Kapitel-Bildkarte.

Phase 7 – Skizzen-Generierung (Produktionsserie)

Nachdem alle Kapitel entworfen wurden:

  1. Grep aller [SKETCH:]-Marker in den chapters/-Dateien
  2. Skizzen-Generator-Skript im Batch-Modus ausführen – generiert ein PNG pro Marker in <buch>/sketches/
  3. Dateibenennungskonvention: <kapitel_slug>_s01.png, _s02.png usw.
  4. Weißwäsche-Nachbearbeitung
  5. Produktionseinstellungen (für Line-Art gesperrt): 768×768, 18 Schritte, Flux Krea Dev FP8, euler/simple, cfg 1.0, guidance 3.0

Durchsatz: ~15s/Skizze auf RTX 5080. 400 Skizzen in ~1,5 Stunden.

Phase 8 – Kompilierung (gemäß illustrated-book-Skill)

Verwenden Sie das bewährte Skript _compile_novel.py (verarbeitet fpdf2 PDF + ebooklib EPUB). Das Skript unterstützt den vollständigen Markersatz aus Phase 6 und das hybride Layout (Muster B v2: erster + letzter img_map-Eintrag werden zu ganzseitigen Marquee-Bildern; mittlere Einträge Textumbruch mit abwechselndem L/R).

Pro Buch:

python _compile_novel.py <Projektname>/<Buch_Slug>

Ausgaben: <Buch>_EN.pdf, <Buch>_EN.epub, <Buch>_Cover_Amazon.jpg (1600×2560) und <Buch>_RU.{pdf,epub}, wenn RU-Kapitel vorhanden sind.

Phase 9 – Hörbücher (Audiobook-Engine)

cd <Audiobook-Engine-Pfad>
tts.bat audiobook "<voller Pfad zum Buchordner>" en

EN: Kokoro v1.0 af_heart (~25-49× RTF). RU: F5-TTS Misha24-10 mit geklonter Stimme (~1× RTF). Ausgabe: <Buch>_AUDIOBOOK_<SPRACHE>.mp3 bei 192 kbps.

Phase 10 – Veröffentlichung

Verwenden Sie das Veröffentlichungs-Metadatenkit-Muster: Metadatenpaket pro Buch mit KDP-Kategorien, BISAC-Codes, Schlüsselwörtern, Preisvorschlägen, Klappentext (HTML), Vergleichstiteln, Autorenbiografie. Hybrid-Verfahren: Metadaten vorbereiten, Benutzer öffnet KDP/Kobo/Google Play, fügt ein/ lädt hoch.

Für Serien mit mehreren Büchern: schnelle Veröffentlichung über 2-4 Wochen, KDP Select nur für Buch 1.


Kritische Lektionen (bewährt bei mehreren Buchproduktionen bis zum 25.04.2026)

1. Persönlichkeitsiteration ist die Phase mit dem höchsten Risiko

Das Schreiben im großen Stil mit der falschen Persönlichkeit ist brutal rückgängig zu machen. Führen Sie IMMER ein 1-Kapitel-Beispiel der vorgeschlagenen Persönlichkeit DURCH, BEVOR Sie parallel schreiben. Fragen Sie explizit: „Ist das ein guter Aufhänger für einen kalten Amazon-Käufer?"

2. Die autobiografische Stimme des Benutzers ist selten der richtige Aufhänger

Autoren stellen sich vor, dass Leser von ihrem tatsächlichen Leben fasziniert sein werden. Kalte Leser wollen projizieren. Standardmäßig auf pseudo-autobiografisch generisch einstellen, es sei denn, der Benutzer hat nachweisliche Wiedererkennbarkeit.

3. Skizzen-Testgatter ist nicht verhandelbar

~10 Testskizzen → Benutzerfreigabe → Produktionseinstellungen → Test → vollständige Serie. Das Überspringen des Gatters produziert Hunderte falscher Skizzen.

4. Cover-Prompt-Regeln

  • Vermeiden Sie "leeren weißen Himmelsraum" → flache, ausgewaschene Stelle
  • Geben Sie den genauen Text im Prompt in Anführungszeichen an – Pro reproduziert wortgetreu
  • Serienkohäsion = sagen Sie explizit "gleiches X wie vorherige Cover" im Prompt

5. Skizzen-Prompt-Regeln

  • Vermeiden Sie "Taschenbuch / Notizbuchseite" → Flux rahmt die Skizze als Notizbuchfoto ein
  • Verwenden Sie stattdessen "flache 2D-Zeichnung auf reinem Weiß"

6. Cover-API-Kontingentmodell

Nano Banana Pro der kostenlosen Stufe ist pro-Schlüssel-pro-Zeitfenster, nicht pro-Tag-Gesamt. Schlüssel rotieren; wenn einer ratenbegrenzt ist, übernimmt der nächste nach ~45s Abkühlung.

7. Kokoro-Hörbuch: Stilindex klemmen

Kokoro-onnx hat einen Off-by-One-Fehler bei MAX_PHONEME_LENGTH=510. Patchen Sie die Hilfsfunktion:

style = voice_style[min(len(tokens), voice_style.shape[0] - 1)]

8. Backup vor Reset

Wenn während des Schreibens ein Persönlichkeitswechsel notwendig ist, archivieren Sie die alten Kapitel (verschieben Sie sie in _v1_old_persona_archive/). Nicht löschen. Sie enthalten wiederverwendbare Strukturen, Wendepunkte und Anreißer, die in v2 genutzt werden können.

9. Kompilierungs-, Hörbuch- und Veröffentlichungsphasen sind zu 90 % wiederverwendbar

Sobald GUIDE und PLAN richtig sind, läuft die nachgelagerte Pipeline unverändert. Investition: ~2 Stunden für den einmaligen Pipeline-Aufbau. Pro Buch nachgelagert: ~30 Minuten.

10. Die gleiche russische Cover-Formel reproduziert sich sauber über Nano Banana Pro für englischsprachige Bücher

Hut + tropisches Setting + fette schwarze Großbuchstaben-Titel + Untertitel in Akzentfarbe +

…

[gekürzt für die Übersetzung]

Verwandte Skills