Communitygithub.com

Premium-PDF-Design

Institutionelles PDF-Designsystem für Präsentationen (16:9 dunkle Executive-Decks) und Berichte (Letter helles Swiss-Ivory). Erzwingt überprüfbare Open-Data-Pipelines, 60-30-40-Farbbalance, haardünne Tufte-Tabellen, Minto-Pyramiden-Aktionstitel, 300-DPI-Vektordatenvisualisierung, sichere Inter-Schriftregistrierung, randlose Canvas-Malerei und automatisierte PyMuPDF-Qualitätsaudits.

Was ist Premium-PDF-Design?

Dieses Skill definiert ein professionelles Designsystem zur Erstellung von institutionellen PDF-Präsentationen (16:9 dunkle Executive-Decks) und Berichten (Letter helles Swiss-Ivory), inspiriert von McKinsey, Stripe Press, WEF und The Economist. Es erzwingt zehn überprüfbare Open-Data-Regeln aus der verknüpften Pipeline (z. B. keine manuellen Daten, Pydantic-Grenzen, Herkunftsverzeichnis) und vier goldene Designgesetze: eine 60-30-10-Farbhierarchie, haardünne Tufte-Ledger ohne Boxen, Minto-Pyramiden-Aktionstitel und kalibrierte vertikale Füllbudgets. Es unterstützt Plattformen wie Claude Code, Cursor und Codex und implementiert Berichte mit ReportLab (Full-Bleed-Canvas, Inter-Schrift, Zwei-Durchlauf-Kopfzeilen) sowie Folien mit WeasyPrint (reine Vektor-SVG-Diagramme). Das Skill enthält außerdem Rezepte für institutionelle Datenvisualisierung (Zeitreihen, Balken, Streudiagramme, Bullet-Graphen, Sparklines, Heatmaps) und eine umfassende Audit-Funktion mittels PyMuPDF.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gke0op/verifiable-editorial-skills/tree/HEAD/skills/premium-pdf-design

In Ihrer bevorzugten KI fragen

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

Dokumentation

Überprüfbares institutionelles PDF-Präsentations- und Datenvisualisierungssystem

Dieses Skill arbeitet mit verifiable-pdf-pipeline (Datenintegrität) und editorial-page-layout-guidelines (Rastergeometrie) zusammen, um publikationsreife 16:9 dunkle Executive-Foliensätze und Letter helle Swiss-Ivory-Institutionsberichte zu erstellen, inspiriert von McKinsey, Stripe Press, WEF und The Economist.


1. Kerninvariante: Substanz vor Ästhetik

Jede mit diesem Skill erstellte Präsentation oder jeder Bericht muss die 10 Anti-Cheat-Hard-Regeln aus verifiable-pdf-pipeline/SKILL.md befolgen:

  1. Null-Luftspalt bei handgeschriebenen Daten – Alle Zahlen aus unveränderlichen Rohdateien in data/raw/ parsen.
  2. Realitäts- und Invarianten-Compiler – Pydantic-Domänengrenzen und Buchhaltungsidentitäten durchsetzen.
  3. Anti-zirkuläre Verifikation – Unabhängige Neuberechnung der Rohdatei + Python-AST-Prüfung, die hartcodierte literale Assertions verbietet.
  4. Atomares Herkunftsverzeichnis – Jeder veröffentlichte Skalar wird 1:1 in data/provenance_ledger.json abgebildet.
  5. Negative Fähigkeit und das heilige „N/A“ – Echte upstream-Nullen werden explizit als [N/A] dargestellt, nicht als erfundene Platzhalter.
  6. Kompilationssperre – PDF-Compiler rufen verify_integrity.py auf und brechen bei einem Exit-Code ungleich Null ab.
  7. Kategorie- und Einheitenwächter – Niemals inkommensurable Bereiche oder Testmethoden vermischen.
  8. Gesetzlicher Nachweis – Offizielle Amtsblatt-IDs für regulatorische oder tarifliche Behauptungen erforderlich.
  9. Wissenschaftliche Taxonomie- und Registerverifikation – Binominale, Autoritäten, Phylogenie und IUCN-Status wörtlich gegen aktuelle GBIF/OpenTree/iNaturalist-Register abgleichen.
  10. Nach-Rendering-Prosa-Grundierung (vedit prose) – Jede gerenderte Zahl im endgültigen PDF führt zurück zu provenance_ledger.json, summary_metrics.json oder einem DOI-gestützten Eintrag in background_citations.json.

2. Die 4 goldenen Designgesetze

Gesetz 1: Die 60-30-10-Farbhierarchie (helle und dunkle Modi)

  • Heller Schweizer Redaktionsmodus (Letter-Berichte):
    • 60% Leinwand: Swiss Warm Ivory (#fcfbf9) – explizit über onPage gemalt.
    • 30% Gerüst: Deep Navy (#0f2b48), Slate (#334155), Steel (#64748b), Hairlines (#cbd5e1), Subtle Tint (#f1f5f9).
    • 10% Signalakzent: Cobalt (#0284c7), Amber (#d97706), Emerald (#059669), Signal Crimson (#dc2626 – nur Risiko/Anstieg).
  • Dunkler Executive-Modus (16:9 Foliensätze):
    • 60% Leinwand: Deep Obsidian (#0b0f19) oder Midnight Navy (#051c2c) – MUSS randlos in onFirstPage/onLaterPages VOR dem Rendern von Flowables gemalt werden, niemals auf das standardmäßige weiße PDF-Papier verlassen!
    • 30% Gerüst und kontrastreicher Text: Subtle Tonal Band (#111827 / #0a253a), Hairlines (#243247), Pure White Titles (#ffffff), Crisp Light Body (>= #e2e8f0 bei >= 9.5–10 pt), Secondary Captions (>= #cbd5e1, niemals #64748b–#94a3b8 Prosa auf dunklem Hintergrund dimmen). Platziere immer einen subtilen horizontalen dunklen Scrim hinter der Cover-Typografie, wenn parametrische Drahtgitterwellen oder helle Kunstwerke in der Nähe von Text sitzen.
    • 10% Signalakzent: Electric Cobalt (#38bdf8), Bright Amber (#fbbf24), Emerald (#34d399), Signal Crimson (#f87171).

Gesetz 2: Haardünne Linien und Weißraum-Schwerkraft (Null Box-Karten)

  • Niemals Metriken oder Prosa in schwere rechteckige BOX-Striche oder INNERGRID-Web-Dashboard-Boxen einsperren.
  • KPIs und Callouts über rahmenlose tonale Bänder (#111827 dunkel / #f1f5f9 hell) gruppieren, gekrönt mit einer knackigen 1.2 pt oberen Akzent-Haarlinie, großzügigen 12–16 pt Spaltenabständen und Booktabs-artigen Tufte-Ledgern (null vertikale Linien).

Gesetz 3: Minto-Pyramiden-Aktionstitel

Jede Folie oder jeder Berichtsabschnitt beginnt mit einer vollständigen, assertiven Behauptung, nicht mit einem passiven Themenetikett:

  • Verboten: „Globale Emissionstrends“
  • Erforderlich: „OECD-5 senkte Emissionen um -25,0 %, doch Emerging-3 stieg um +235,8 % und hob die Panel-Summen auf 23,52 Gt CO2e.“

Gesetz 4: Kalibrierte vertikale Füllbudgets + visuelle Inspektion

  • Letter-Berichte (612×792 pt): 85%–92% Ziel vertikale Füllung (min >= 82%).
  • 16:9 Decks (960×540 pt): 72%–88% Ziel vertikale Füllung (min >= 72%).
  • Behandle einen automatischen Durchlauf niemals als endgültiges Wort: Exportiere 180-DPI-PNG-Vorschauen via audit_pdf.py und überprüfe jede gerenderte Seite visuell auf Label-Überlappungen, Witwen-Überschriftenumbrüche und optische Balance.

3. Institutionelle Datenvisualisierungsrezepte (300 DPI, Transparent)

Rendere alle Diagramme mit dpi=300, transparent=True, entfernten oberen/rechten Achsenspinen und themenangepassten Paletten (dunkel vs hell):

  1. Zweifach-Zeitreihe + Ratenbeschleunigung: Historische monatliche/tägliche Trajektorie mit Ereignisschattierung und direkten Start/Peak-Annotationen, gepaart mit dekadischen/periodischen Ratenbalken.
  2. Gestapeltes Massenbilanz-Flächendiagramm + Indizierte Trajektorie: Gestapelte Flussvolumina mit direkten rechten Rand-Endlabels (keine separaten schwebenden Legendenboxen!), gepaart mit Basis = 100 strukturellen Divergenzlinien.
  3. Entkopplungs-Streudiagramm im Quadranten + Hantelkompression: 2D-Wachstums-vs-Ergebnis-Streudiagramm mit schattiertem Zielquadranten + Führungspfeilen für enge Cluster, gepaart mit horizontalen Hanteln von Basislinie zu aktuell.
  4. Stephen Few horizontale Bullet-Graphen: 3 qualitative Hintergrundbänder + primärer Leistungsbalken + vertikaler Zielstrich (Amber-Baseline/Target) + rechtsbündiger Delta-Text (beschnittene x-Achsen-Spine mittels ax.spines["bottom"].set_bounds(...)).
  5. Kopflose Tufte-Sparklines im Arbeitsspeicher: 46–66 pt × 13–16 pt Mikrolinien, die in io.BytesIO()-Puffer gerendert und direkt in ReportLab-Tabellenzellen eingebettet werden, mit semantischen Smaragd-/Karmin-Endpunkten.
  6. Ursprungs-Ziel-Matrix-Heatmap + Ridgeline-KDEs: Sequentielle Palette mit kontrastgeschalteter dualer Typografie oder überlappenden Verteilungskämmen, die $P_{50}$ und $P_{90}$ markieren.

4. Produktions-ReportLab-Implementierungsmuster

4.1 Randlose Canvas-Malerei (Kritisch für dunkle und Elfenbeinfarbene Themen)

Registriere immer einen onPage-Callback, damit der Canvas-Hintergrund unter jedem Flowable auf jeder Seite malt:

from reportlab.lib import colors

def paint_background(canv, _doc, bg_hex="#0b0f19", accent_hex="#38bdf8", page_w=960.0, page_h=540.0):
    canv.saveState()
    canv.setFillColor(colors.HexColor(bg_hex))
    canv.rect(0, 0, page_w, page_h, fill=1, stroke=0)
    if canv.getPageNumber() == 1:
        canv.setFillColor(colors.HexColor(accent_hex))
        canv.rect(0, page_h - 4, page_w, 4, fill=1, stroke=0)
    canv.restoreState()

4.2 Sichere Inter-TTF-Erkennung mit sauberem Fallback

Hartcodiere niemals "Inter-SemiBold" ohne vorherige TTF-Registrierung – verwende eine Hilfsfunktion, die INTER_FONT_DIR und standardmäßige OS-Schriftpfade prüft und sauber auf Helvetica zurückfällt:

import os
from pathlib import Path
from reportlab.pdfbase import pdfmetrics
from reportlab.pdfbase.ttfonts import TTFont

def register_editorial_fonts() -> dict[str, str]:
    search = [Path(os.environ["INTER_FONT_DIR"])] if os.environ.get("INTER_FONT_DIR") else []
    search += [Path.home() / "Library/Fonts", Path("/Library/Fonts"), Path("/usr/share/fonts/truetype/inter")]
    files = {"regular": "Inter-Regular.ttf", "semibold": "Inter-SemiBold.ttf",
             "bold": "Inter-Bold.ttf", "italic": "Inter-Italic.ttf", "bold_italic": "Inter-BoldItalic.ttf"}
    found = {r: d / f for d in search if d.is_dir() for r, f in files.items() if (d / f).is_file()}
    if {"regular", "bold", "italic", "bold_italic"}.issubset(found):
        for role, name in [("regular", "Inter-Regular"), ("bold", "Inter-Bold"),
                           ("italic", "Inter-Italic"), ("bold_italic", "Inter-BoldItalic")]:
            pdfmetrics.registerFont(TTFont(name, str(found[role])))
        semi = "Inter-Bold"
        if "semibold" in found:
            pdfmetrics.registerFont(TTFont("Inter-SemiBold", str(found["semibold"])))
            semi = "Inter-SemiBold"
        pdfmetrics.registerFontFamily("Inter-Regular", normal="Inter-Regular", bold="Inter-Bold",
                                      italic="Inter-Italic", boldItalic="Inter-BoldItalic")
        return {"regular": "Inter-Regular", "semibold": semi, "bold": "Inter-Bold",
                "italic": "Inter-Italic", "bold_italic": "Inter-BoldItalic", "mono": "Courier"}
    return {"regular": "Helvetica", "semibold": "Helvetica-Bold", "bold": "Helvetica-Bold",
            "italic": "Helvetica-Oblique", "bold_italic": "Helvetica-BoldOblique", "mono": "Courier"}

4.3 Zwei-Durchlauf-Laufköpfe und dynamische Seitenzahlen

Verwende eine Unterklasse von reportlab.pdfgen.canvas.Canvas, die Seitenzustandsdiktate in showPage() speichert und "Seite X von Y" oder "Folie X / Y" in save() einprägt (siehe examples/reportlab_premium_template.py).


5. 2023-Consulting-Flaggschiff-Modus (WeasyPrint + reine Vektor-Inline-SVG)

Für Keynote-würdige Decks, die auf Flaggschiff-Institutionspublikationen von 2023 modelliert sind (Quantum Technology Monitor, The Economic Potential of Generative AI, Global Economics Intelligence, The State of Organizations), kombiniere WeasyPrint (@page { size: 960pt 540pt; margin: 0; }) mit 100 % reinen Vektor-Inline-<svg>-Exponaten:

  1. Dunkel-Held / Rein-Weiß-Daten-Polaritäts-Kadenz (Niemals eintönig):
    • Cover-Held: Deep Midnight Navy (#051C2C) übergehend in Cobalt (#0A2E8A), überlagert mit einer 42-strängigen parametrischen hyperbolischen Bezier-Drahtgitterwelle (#2251FF / #00A9F4) und sauberer redaktioneller Heldenkunst auf der rechten Seite.
    • Executive Summary: Randloses #051C2C, knappe 28 pt weiße Serifen-Überschrift über einem 1.2 pt weißen horizontalen Strich, 3 luftige serifenlose Spalten und 3 riesige cyan/blaue Serifen-KPIs.
    • Geteilte Kapiteltrenner: Obere 48 % randlose leuchtende Kunst, verankert durch eine 120 pt fette weiße Serifenziffer (1, 2), untere 52 % reines Weiß mit 220 pt links eingerückter Serifen-Kapitelüberschrift und 2-spaltigem Rahmenkopier.
    • Datendiagramm-Folien: Reine #FFFFFF-Leinwand, 19.5–22 pt fette Serifen-Aktionstitel über einem 1.1 pt #051C2C-Strich, subtiler unterer Fußnotentrenner und eine unten rechts #9AE6FF eis-cyan Abschnittsfortschrittspille.
  2. Kontrastreiche redaktionelle Serifen- + geometrische Serifenlosen-Paarung:
    • Anzeige-Serife (Charter / Georgia / Baskerville Bold): Cover-Titel, Abschnittszahlen, Folien-Aktionstitel, riesige 54 pt #2251FF-KPI-Callouts und zentrierte Donut-Gesamtsummen.
    • Daten-Serifenlose (Inter / Helvetica Neue): Diagrammannotationen, Untertitel, Ledger-Zellen, Fußnoten und Implikationskopien.
  3. Die 4-stufige McKinsey-Blau-Chromatik-Rampe (Null Regenbogen-Unordnung):
    • #051C2C Midnight Navy (Ankersummen, Basislinien, tiefe Kontraktionen) → #06319C Deep Royal → #2251FF Electric Blue (fokale Deltas, riesige KPIs, Expansionsschübe) → #00A9F4 Vivid Cyan → #9AE6FF Ice Cyan (sekundäre Anteile und Abschnittspillen).
  4. Charakteristische Vektor-SVG-Exponat-Archetypen:
    • Massenbilanz-Wasserfall / Brückendiagramm: Ankerbalken (#051C2C), schwebende Additionen (#2251FF) und Reduktionen (#00A9F4), gestrichelte Schrittverbinder, obere eckige Klammer-Span-Callouts und schwebendes Serifen-Netto-Delta.
    • Small-Multiples-Wand + graue »-Implikationsseitenleiste: Gruppierte 5 + 3 indizierte Trajektorienkarten, gepaart mit einer rechten #EFEFEF-Seitenleiste, verbunden durch ein kreisförmiges #051C2C-»-Chevron-Abzeichen (3 pt weißer Ring).
    • 10×10 abgerundetes-Quadrat-Waffel-Einheitsmatrix: Von unten nach oben gefüllte 10×10-Gitter (#E5E7EB-Spur, 4-stufige blaue Füllung) mit zentrierten fetten Ziffern im grauen Negativraum.
    • Donut-Ring + 100 % gestapelte Anteilsverschiebung: 5-stufiger blauer Donut (2 px weiße Scheibentrenner, Serifen-Zentrumssumme) gepaart mit 2000 vs. 2024-Spalten, verbunden durch durchscheinende Flussbänder.
    • WeasyPrint-SVG-Leitplanken: Gib Inline-<svg> innerhalb von Flex-Containern immer explizite width/height in pt (und setze .slide { height: 539.5pt; break-after: page; break-inside: avoid; }), um Subpixel-Leerseiten oder 300 px-SVG-Kollaps zu vermeiden. Verwende niemals SVG 2 paint-order="stroke" auf <text> in WeasyPrint (es zeichnet über der Textfüllung); verwende saubere Label-Offsets oder ein explizites <rect> im Hintergrund.
  5. Randloser redaktioneller Fotografie-Magazin-Modus (612 × 792 pt Letter Hochformat, WeasyPrint): Bei der Produktion fotografieorientierter redaktioneller Magazine (Stil Kinfolk × Cereal × Condé Nast Traveler × National Geographic, wie in demos/felis-mundi-magazine/ demonstriert):
    • Typografie und Papierqualität: Kombiniere warmes unbeschichtetes Archivpapier (#FAF8F5) und tiefe Kohlenstoff-Kohle-Tinte (#161616) mit kontrastreichen Didone-Anzeige-Serifen (Didot / Bodoni 72), warmer Buch-Serifen-Fließtext (Charter / Baskerville bei 9 pt, 1.5× Zeilenabstand) und weit gespurten Großbuchstaben-Metadaten (Inter, 6.5–7 pt, +0.18em Tracking). Wechsle laufende Kolumnentitel und Bildnachweise nahtlos zu reinem #FFFFFF über randlosen Fotos.
    • Kohärente Fotografie (>= 50 % randloser Rand): Erstelle jede Tafel unter einem gesperrten Master-Fotografischen Film-Identitätskern (siehe references/image_generation_recipes.md §5), variiere die Ausbreitungsarchitektur über benachbarte Seiten hinweg (100 % Cover → 61 % oberer Rand → 65 % rechte vertikale Spalte → 100 % Fotoessay → 76 % Diptychon mit 4 pt weißen Druckrinnen → 68 % unterer Rand → 77 % Kontaktabzug-Triptychon → 100 % abschließende Dämmerungskolophon) und kreditiere KI-Fotografie transparent zusammen mit einem SHA-256-Plattenmanifest.
    • WeasyPrint-Magazin-Leitplanken (empirisch verifiziert):
      • Initialen (float: left): Platziere niemals eine float: left-Initiale innerhalb eines CSS-Grid- oder Flexbox-Elements in WeasyPrint 67.0 (sie schrumpft die Textspalte oder versetzt/kollidiert die Initiale). Verwende position: absolute-Block-Spalten (display: block) für geteilte Magazinseiten, damit Initialen 100 % bündig links mit sauberem mehrzeiligen Umbruch sitzen.
      • Nahtlose Farbverlaufsscrims: Platziere niemals eine teilhöhe linear-gradient-Überlagerungsbox über hellem Himmel oder Schnee in WeasyPrint (Cairo malt eine schwache 1 px Haarlinien-Naht entlang der Boxkante). Dimensioniere immer jeden Scrim-Overlay auf 100 % seines Fotocontainers und blende zu rgba(..., 0) innerhalb der transparenten Stopps aus.
      • Rotierte Rand-Bildnachweise: Verankere vertikale rechte Rand-Bildnachweise mit top: 18pt; right: 16pt; transform-origin: 100% 0%; transform: rotate(180deg); writing-mode: vertical-rl; für zuverlässige Ausrichtung (statt transform: rotate(90deg);), um konsistentes bündiges rechts/Rand- und Blätterverhalten in WeasyPrint zu gewährleisten.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills