Communitygithub.com

slides-genedit

Erstellt und bearbeitet wissenschaftliche Präsentationsdecks aus Forschungsmaterialien. Zwei Wege: (1) Neues Deck aus Paper/Notizen unter festen Vorgaben zu Zielgruppe, Dauer und Folienanzahl, mit claims pro Folie, wörtlicher Evidenz-Zuordnung, Sprechernotizen und PDF-Vorschau; (2) quellentreue Bearbeitung eines bestehenden Decks – Inventur, lokale Änderungen, Nachweis der Byte-Identität unberührter Folien.

Was ist slides-genedit?

slides-genedit ist ein Skill für KI-Agenten, der automatisch wissenschaftliche Präsentationsfolien aus Forschungsmaterialien erstellt oder gezielt bearbeitet. Im GENERATE-Modus wird aus einem Paper oder Notizen unter Berücksichtigung von Zielgruppe, Zeitvorgabe und Folienanzahl ein neues Deck aufgebaut. Dabei legt der Skill pro Folie die Kernaussage (claim) fest, ordnet Zahlen und Zitate aus der Quelle wörtlich zu und erstellt Sprechernotizen sowie eine PDF-Vorschau. Im EDIT-Modus wird ein bestehendes .pptx-Deck inventarisiert, dann werden nur die explizit gewünschten Änderungen (Textersatz, Folien hinzufügen/löschen/verschieben) angewandt – alle nicht betroffenen Folien bleiben byte-identisch, was durch einen Prüfbericht belegt wird. Der Skill ist für Cursor, Claude Code und ähnliche agentische Plattformen gedacht, erfordert Python-Skripte im `scripts/`-Ordner und eine JSON-Konfiguration (`case.json`). Die besondere Stärke liegt in der nachvollziehbaren Auswahl und Anordnung von Inhalten, nicht im bloßen Kopieren von Textblöcken.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/qingyulzx/pku-efficiency3-skills/tree/HEAD/slides-genedit

In Ihrer bevorzugten KI fragen

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

Dokumentation

slides-genedit – wissenschaftliche PPT-Erstellung & quellentreue Bearbeitung

Sie verwandeln Forschungsmaterial (Paper, Notizen, bestehendes Deck) in eine bearbeitbare, evidenzgestützte wissenschaftliche Präsentation – und Sie bearbeiten vorhandene Decks, ohne das zu zerstören, was nicht angetastet werden soll. Die Herausforderung liegt in der Auswahl und Anordnung, nicht im Kopieren von Absätzen: Welches Ergebnis verdient eine eigene Folie, wie viele Aufzählungspunkte braucht eine Methode, welche Abbildung kommt zuerst, was wird weggelassen, wenn das Folienbudget überschritten wird? Sie treffen diese Urteile; die Skripte in scripts/ erledigen die deterministische Arbeit (Parsen, Zusammenbau, Verifikation, Rendern). XML niemals von Hand zusammenbauen, wenn ein Skript existiert.

Routendispatch (zuerst entscheiden, dann niemals mischen)

Lesen Sie /input/case.json und task.md. Führen Sie Schritt 1 unten aus – parse_case.py gibt einen Routenhinweis mit Belegen aus. Bestätigen Sie gegen die Aufgabenbeschreibung:

  • GENERATE – kein Startdeck in den Eingaben (Forschungsmaterial + Zielgruppen-/Zeit-/Folienanzahl-Vorgaben + Vorlage). Neues Deck erstellen.
  • EDIT – ein Startdeck (.pptx) wird bereitgestellt UND die Anweisung verlangt lokale Änderungen (修改/压缩/换受众/加页/删页/调整). Inventarisieren Sie es und wenden Sie chirurgische Operationen an. Bearbeitung muss erhalten: byte-identische unberührte Folien, unberührte Master/Layouts, Vorlagenstil, Notizen von nicht betroffenen Folien.
  • Wenn ein Deck existiert, die Anweisung aber den Großteil des Inhalts umschreibt oder die gesamte Erzähllogik umordnet, handelt es sich um einen Generate-Lauf unter falscher Flagge – neu aus derselben Vorlage erstellen und das Startdeck als Version N-1 behalten. Routenentscheidung und Belege dokumentieren.

Budgedisziplin durchgehend: ~7 Tool-Schritte ist der Sweet Spot, 64 Modellanfragen / 900 s insgesamt. Schritt 1 schreibt bereits ein vertraglich vollständiges Gerüst von result.json, sodass ein Absturz danach immer noch ein verifizierbares Ergebnis liefert. Schrittweise verbessern, niemals als Gerüst belassen.

Schritt 1 – Eingaben parsen, result.json-Grundgerüst schreiben (beide Routen)

python scripts/parse_case.py --input /input/case.json --workdir /app/work --output-dir /app/output

Lesen Sie den ausgegebenen Routenhinweis UND den eigentlichen Aufgabentext, bevor Sie sich auf eine Route festlegen (der Hinweis ist Beleg, kein Urteil). Überprüfen Sie den Constraint-Scan (case-parsed.json) selbst gegen task.md – Stichwortscans übersehen und treffen zu viel; der Aufgabentext gewinnt. Lesen Sie alle vorhandenen Eingabedateien (material*.md/pdf/tex, Abbildungen); für PDFs verwenden Sie pdf-text-tool / pdf-render-tool / ocr-tool wie bereitgestellt. Niemals Inhalt aus Dateinamen annehmen.

Schritt 2 – Extraktion mit wörtlicher Erfassung (Generate)

Aus dem tatsächlichen Material extrahieren: Forschungsfrage, Methode, Ergebnisse, Einschränkungen (die Erzählspine). Beim Lesen wörtliche Zitate mit Orten (Abschnitt, Tabelle, Abbildung) für jede Zahl und Behauptung erfassen, die auf einer Folie erscheinen könnte – dies ist die Evidenzkarte, einmal erfasst und in den Schritten 3 und 7 wiederverwendet. Fehlen dem Material Schlussfolgerungen/Ergebnisse, wenden Sie reference/exception-playbook.md #1 an: Schlussfolgerungen als solche kennzeichnen, niemals erfinden.

Schritt 3 – Foliengerüst: Ihr Urteil, dokumentiert (Generate)

/app/work/outline.json gemäß reference/schemas.md erstellen. Dies ist der zentrale intellektuelle Schritt – selbst durchführen, nicht per Vorlage:

  • Eine Folie = eine Kernaussage. Der Titel drückt die Botschaft der Folie aus („Ergebnisse: Formfehler 38,2 % niedriger bei gleicher Kompressionsrate“, nicht „Experimentelle Ergebnisse“). Jede Folie erhält eine role (problem/method/result/limitation/...) und Sprecher-notes (das Vortragsskript – ein Deck ohne Notizen ist unvollständig).
  • Zahlen wörtlich. Ziffern exakt aus dem Material kopieren (28,4 BLEU, nicht ~28; 41,8, nicht 42). Die Quelle jeder Zahl steht in der evidence dieser Folie. Wenn Sie die Quelle einer Zahl nicht finden, kommt sie nicht auf eine Folie.
  • Auswahl für Zielgruppe/Zeitbudget. ~1 Folie pro 1–2 Minuten. Fachkollegen: Methodendetails wichtig. Prüfungskomitee: Fortschritt und Plan wichtig. Verteidigung: Beiträge und Belege wichtig. Ergebnisse nach Erzählkraft ordnen (Ist es gut? → Wie viel? → Bestätigt es sich?), nicht nach Abschnittsreihenfolge des Papers.
  • Abbildungen: das Originalbild mit seiner wörtlichen Bildunterschrift zitieren, wenn die Quelle eine Bitmap ist; nur neuzeichnen, wenn die Datentabelle vorliegt. Rein bildliche Ergebnisse verdienen eine eigene Seite; sekundäre Abbildungen werden zusammengeführt oder wandern auf Backup-Seiten nach der Schlussfolie.
  • decisions-Log: Jeder behaltene/gestrichene/zusammengelegte/umgeordnete Punkt mit Begründung („Tabelle 2 Ablation gestrichen – Seitenbudget 6 Seiten, Hauptergebnisse priorisiert“). Dies ist sowohl Ihr Verifizierungsartefakt als auch das Material für Fallstudien; leere Entscheidungen sind ein Fehler.

Schritt 4 – Deck zusammenbauen (Generate)

python scripts/assemble_deck.py --outline /app/work/outline.json \
  --template <template.pptx falls vorhanden> --out /app/output/deck_v1.pptx \
  --workdir /app/work/scratch

assembly-report.json lesen. Das Gerüst (nicht das Deck) korrigieren, wenn es Überlaufrisiko, Layout-Fallbacks oder Budgetüberschreitung meldet, dann erneut ausführen – Deck und Entscheidungslog müssen konsistent bleiben. Die Skripte garantieren: Inhalt landet in folienbezogenen Platzhaltern (bei Fehlen aus dem Layout geklont – Schreiben in Layout-Platzhalter wird nicht gerendert), Bilder werden seitenverhältnistreu beschnitten, nicht verzerrt, Notizen werden angehängt.

Schritt 2' – Startdeck inventarisieren (Edit)

python scripts/inventory_deck.py --deck <start.pptx> --out /app/work/inventory.json

Das Inventar lesen. Die genauen Ziele lokalisieren, die die Anweisung nennt (Folienindex + Platzhalter-ID / Shape-Name). Wenn ein Bearbeitungsziel nicht existiert, Playbook #8 anwenden: deutlich melden, neu ausrichten oder ergänzen – niemals stillschweigend überspringen.

Schritt 3' – Chirurgische Operationen erstellen (Edit)

/app/work/ops.json gemäß reference/schemas.md (Ops-Schema) schreiben. Operationen werden der Reihe nach auf 1-basierte Folienindizes angewandt. Nur das abdecken, was die Anweisung verlangt: replace_text für umgeschriebene Aufzählungspunkte (vorhandene Formatierung bleibt erhalten), append_bullets, set_notes, insert_image (seitenverhältnistreu), add_slide, delete_slide, move_slide, duplicate_slide. Eine komplette Deck-Neuschreibung über Ops ist Missbrauch – stattdessen Route wechseln.

Schritt 4' – Bearbeitungen anwenden und Erhalt prüfen (Edit)

python scripts/edit_deck.py --deck <start.pptx> --ops /app/work/ops.json \
  --out /app/output/deck_v2.pptx --workdir /app/work/scratch

edit-report.json prüfen: alle Ops ok; slides_identical_raw >= source slides − touched slides; masters_untouched und layouts_untouched true. Wenn unberührte Folien nicht einmal strukturell identisch sind, ist die Bearbeitung übergelaufen – Playbook #9. Neu rendern, dann ausliefern.

Schritt 5 – Rendern und prüfen (beide Routen)

python scripts/render_check.py --pptx /app/output/deck_v1.pptx --outdir /app/output/render/

Die PDF-Vorschau muss existieren mit Seitenzahl == Folienzahl. Die Vorschau auf Überlauf, Font-Substitution, abgeschnittene Bilder prüfen (pdf-render-tool / office-renderer verwenden, falls verfügbar). Font-Substitution in der Vorschau wird als Unschärfe dokumentiert – NICHT die Vorlagenfonts des Decks ändern, um den Renderer zufrieden zu stellen (Playbook #4). Wenn Rendern unmöglich ist, die .pptx behalten und den Fehler ehrlich dokumentieren (Playbook #6).

Schritt 6 – Gezielt iterieren (beide Routen)

Benutzerfeedback trifft als neue Bearbeitungsanweisung für das aktuelle Deck ein: zurück zu Schritt 2' (Edit-Route) gegen die neueste Version. Vorherige Versionen behalten (deck_v1.pptx, deck_v2.pptx, ...) – niemals überschreiben; jeder Render-Bericht plus Ops-Log/Entscheidungs-Diff ist der Versionsnachweis. Regressionsprüfung bei jedem Durchlauf: Sind unberührte Folien identisch geblieben?

Schritt 7 – result.json finalisieren (beide Routen)

/app/output/result.json (das Gerüst aus Schritt 1) auf endgültige Werte aktualisieren: jedes output_contract-Feld aus case.json befüllt – Präsentationsdatei, Folienanzahl, Evidenzzuordnung pro Folie (Ort + wörtliches Zitat), Render-Vorschaupfad, Status der Sprechernotizen; Edit-Läufe ergänzen das Ops-Log und die Erhaltungsmatrix. Felder, die Sie wirklich nicht produzieren konnten, bleiben null mit Grund in unanswered. status ∈ complete | partial (Grenzen benennen). Dann anhalten – .pptx, Notizen, PDF-Vorschau und result.json ausliefern.

Unverhandelbar

  • Zahlen/Zitate auf Folien gehen auf wörtlich erfasste Quellen zurück; keine erfundenen Werte, keine geschätzten Neuzeichnungen, keine stillschweigenden Rundungen.
  • Edit-Route niemals Master/Layouts oder nicht betroffene Folien anrühren; die Erhaltungsmatrix beweist es.
  • Ehrliches Scheitern vor vorgetäuschtem Erfolg in result.json, immer.
  • Vorlagen, Abhängigkeiten, Schemata und das Ausnahme-Playbook befinden sich in README.md und reference/; vor Abweichungen lesen.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

biopathway-mechanism-diagram

Build or edit publication-grade biological mechanism/pathway diagrams from research materials (PDF/text) as a challengeable mechanism statement - three-layer model (typed entities, typed directed edges with verbatim evidence, compartment layout), semantics-correct SVG source, PNG/PDF exports and a traceable, uncertainty-aware result.json. Use for tasks asking to draw, generate or edit signaling pathways, mechanism figures, crosstalk diagrams or pathway flowcharts; refuses to guess regulation direction and marks unstated information instead.

graphical-abstract-builder

Build a single-page graphical abstract (question, method, results, conclusion) from research material as a traceable, editable SVG with PNG/PDF exports. Use when asked to create or edit a graphical abstract, science summary figure, mechanism or flow diagram, or data chart from a paper, study notes or experimental records, especially when editable source files and element-to-source traceability are required.

paper-to-academic-ppt

Turn a research paper (PDF) into a structured, evidence-traceable, template-compliant academic slide deck. Two phases: agent-authored narrative spine and page-level claims (each with paper locators and verbatim quotes), then scripted template adaptation that writes content into real master/layout placeholders, embeds original paper figures, checks overflow/aspect/notes, and exports a PDF preview. Handles missing conclusions, figure-trimming, layout mismatch and over-limit slide counts with explicit rules.

relationship-schematic

Generate or edit scientific entity-relationship schematics (mechanism diagrams, pathway chains, experimental workflows, structural containment) as traceable, editable SVG with verified relation semantics. Extracts an evidence-quoted entity/relation table first, renders a layered SVG from it, reads the drawing back to verify every relation type, direction and containment, then exports 300-dpi PNG and vector PDF. Use for any "draw a mechanism/workflow/relationship figure from this paper or case material" task where scientific correctness of entities, arrow directions and hierarchy matters.

Verwandte Skills