CommunitySchreiben & Editierengithub.com

paper-to-academic-ppt

Verwandle eine wissenschaftliche Arbeit (PDF) in eine strukturierte, belegbare und vorlagenkonforme akademische Präsentation. Zwei Phasen: Vom Agenten erstellte narrative Struktur und seitenweise Behauptungen (mit Seitenverweisen und wörtlichen Zitaten), dann skriptgesteuerte Vorlagenanpassung, die Inhalte in echte Master-/Layout-Platzhalter schreibt, Originalabbildungen einbettet, Überlauf/Seitenverhältnis/Notizen prüft und eine PDF-Vorschau exportiert. Behandelt fehlende Schlussfolgerungen, Bildzuschnitt, Layout-Konflikte und überschreitet die Folienanzahl mit expliziten Regeln.

Was ist paper-to-academic-ppt?

Dieses Skill wandelt eine Forschungspublikation (PDF) in eine professionelle, akademische Präsentation um, die auf einer bereitgestellten PowerPoint-Vorlage basiert. Der Prozess ist zweigeteilt: Zuerst extrahieren Sie (der Agent) die narrative Struktur (Problem, Methode, Ergebnisse, Einschränkungen) und erstellen eine Folie pro Behauptung, jede mit direktem Papiernachweis (Seite, Zitat, Abbildung). In der zweiten Phase füllen Skripte die Folien mit Inhalten in Platzhaltern, betten Originalabbildungen ein, prüfen auf Überlauf und exportieren eine PDF-Vorschau. Das Skill ist besonders nützlich für Entwickler und KI-Agenten, die schnell konsistente, evidenzbasierte Präsentationen aus wissenschaftlichen Artikeln erstellen müssen. Es stellt sicher, dass jede Folie eine klare Behauptung mit nachprüfbaren Quellen enthält und die Präsentation mit der Vorlage konform ist. Die Architektur ist als Pipeline (7 Schritte) aufgebaut, die über die Befehlszeile gesteuert wird und Fehler robust behandelt, z. B. bei fehlenden PDF-Backends oder nicht extrahierbaren Abbildungen.

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

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

Paper to Academic PPT (belegbar)

Was dieses Skill macht

Wandele eine Forschungspublikation in eine akademische Präsentation um, bei der:

  • der narrative Kern (Problem / Methode / Ergebnisse / Einschränkungen) aus der Arbeit selbst extrahiert wird, nicht aus der Absatzreihenfolge;
  • jede Folie eine Behauptung trägt, die durch einen Papierverweis (Abbildung / Tabelle / Abschnitt / Zitat + Seite) belegt wird;
  • die Präsentation innerhalb der bereitgestellten Vorlage zusammengesetzt wird – Text wird in Master-/Layout-Platzhalter geschrieben, Vorlagenschriftarten und -design bleiben erhalten;
  • Sprechernnotizen hinzufügen, was gesagt werden soll, keine Wiederholung des Folientexts;
  • die Präsentation geprüft wird (Überlauf, Seitenverhältnis, Platzhalternutzung, Belegabdeckung) und als PDF zur Überprüfung gerendert wird;
  • das Ergebnis ist maschinenüberprüfbar: result.json bildet jede Folie auf ihren Papierbeleg ab.

Die Skripte übernehmen das Parsen, Zusammenstellen und Prüfen. Sie (der Agent) treffen die Urteile: was die narrative Struktur ist, welche Behauptungen Seiten verdienen, was bei knappem Folienbudget weggelassen wird und welche Abbildungen welche Behauptung belegen. Delegieren Sie diese Entscheidungen nicht an die Skripte.

Eingaben

EingabeWoHinweise
/input/case.jsonfester Pfadcase_id, Papierpfad, Vorlagenpfad, Zielgruppe, Dauer, max_folien, ausgabe_vertrag
Papier-PDFPfad aus case.jsonwird tatsächlich geparst; keine vorab extrahierte Antwortschicht
Vorlage .pptxPfad aus case.jsonkann eine Vorlage (0 Folien) oder eine Startpräsentation (>0 Folien) sein

Arbeiten Sie unter /app/work; Ergebnisse gehen nach /app/output.

Pipeline (7 Schritte)

Schritt 0 – Das Gerüst des Ausgabevertrags zuerst schreiben (vor allem anderen)

Erstelle sofort /app/output/result.json mit allen Feldern des Ausgabevertrags auf null + Grund, Status "partial". Dies garantiert ein gültiges Ergebnis, selbst wenn spätere Schritte fehlschlagen. Verwende:

python scripts/build_result.py --case /input/case.json --out /app/output/result.json --status partial --note "run gestartet"

Schritt 1 – Das Papier-Inventar extrahieren

python scripts/extract_paper.py --pdf <paper.pdf> \
    --out /app/work/paper_pages.json \
    --figdir /app/work/figs --extract-images

Gibt seitenweisen Text, einen Index der Abbildungs-/Tabellenbeschriftungen mit Seitenzahlen und eingebettete Abbildungsbilder (s{n}_img{i}.png) aus. Wenn es mit Code 3 beendet wird (kein Python-PDF-Backend), verwenden Sie stattdessen das Container-Tool pdf-text-tool / pdf-render-tool und schreiben dasselbe JSON-Format selbst – die nachfolgenden Schritte lesen nur dieses JSON.

Schritt 2 – Die Vorlage analysieren

python scripts/analyze_template.py --pptx <template.pptx> --out /app/work/template_map.json

Erzeugt das Layout-Inventar und eine rollen_map (Titel / Abschnitt / Inhalt / Zwei_Spalten / Abbildung). Lesen Sie es: Überprüfen Sie, ob die rollen_map Ihrer Interpretation der Vorlage entspricht (Namen können in lokalisierten Vorlagen irreführend sein); überschreiben Sie bei Bedarf die layout-Felder des Präsentationsplans pro Folie. Wenn die Vorlage eine Startpräsentation ist (slide_count > 0), werden vorhandene Folien über edit_slide_index im Plan bearbeitet.

Schritt 3 – Den narrativen Kern entwerfen (Agentenurteil)

Lesen Sie die extrahierten Seiten (Zusammenfassung, Einleitung, Ergebnistabellen, Fazit) und schreiben Sie die vier Elemente des narrative im Präsentationsplan:

  • problem – was die Arbeit angreift, mit einem wörtlichen Zitat;
  • methode – die Kernidee in einem Satz, mit Abbildungs-/Abschnittsverweisen;
  • ergebnisse – die Schlagzahlen MIT Einheiten und der Tabelle, aus der sie stammen;
  • einschränkungen – bevorzugen Sie den Abschnitt zu Einschränkungen der Arbeit; falls nicht vorhanden, geben Sie dies explizit an und kennzeichnen Sie vom Vortragenden abgeleitete Einschränkungen als solche.

Regeln für Zitate: kopieren Sie wörtlich aus paper_pages.json (korrigieren Sie nur PDF-Zeilenumbrüche); behalten Sie die Seitenzahl bei; paraphrasieren Sie niemals innerhalb eines quote-Felds.

Schritt 4 – Den seitenweisen Präsentationsplan schreiben (Agentenurteil)

Erstellen Sie /app/work/deck_plan.json gemäß references/deck-plan-schema.md. Wichtige Regeln:

  • eine Behauptung pro Folie (ein vollständiger Satz, keine Themenüberschrift);
  • 3–5 Aufzählungspunkte pro Inhaltsfolie, jeweils ≤ ~90 Zeichen, damit die automatische Schriftgrößenanpassung nicht unter 16pt fällt;
  • jede Folie hat ≥1 Beleg-Eintrag (Verweis + Seite + Zitat);
  • Abbildungen: verweisen Sie auf die extrahierte Bilddatei und die Abbildungsbezeichnung der Arbeit; überprüfen Sie, ob das Bild tatsächlich diese Abbildung zeigt, bevor Sie es einbetten;
  • Notizen müssen Informationen hinzufügen (Übergänge, Betonung, Fragen&Absicherung), niemals Aufzählungspunkte wiederholen;
  • Folienbudget: (Pflichtseiten) Titel, Problem, Methodenkern, Methodendetail, Hauptergebnisse, Einschränkungen/Erkenntnisse – dann optionale Seiten (Trainingsrezept, Generalisierung, Ablationen) bis max_folien erreicht ist. Wenn die Arbeit zu viele Abbildungen hat, bevorzugen Sie die, auf denen die Behauptungen basieren, und verweisen Sie auf die übrigen im Text.

Schritt 5 – Die Präsentation zusammenstellen

python scripts/assemble_deck.py --plan /app/work/deck_plan.json \
    --map /app/work/template_map.json --out /app/output/<case_id>.pptx \
    --max-slides <aus case.json>

Schreibt Text in Folienplatzhalter (niemals in die des Layouts), behält das Vorlagendesign, fügt Bilder in Bildplatzhalter mit seitenverhältnistreuem Zuschnitt ein, verkleinert Schriftarten in 2-PT-Schritten (Mindestgröße 12pt), um Platz zu schaffen, und schreibt Notizen. Wenn es mit einer Fehlermeldung zur Folienanzahl fehlschlägt, kürzen Sie den Plan – verwenden Sie nicht --allow-overflow, es sei denn, der Fall erlaubt dies explizit.

Schritt 6 – Prüfen und rendern

python scripts/check_deck.py --deck /app/output/<case_id>.pptx \
    --plan /app/work/deck_plan.json --max-slides <N> --out /app/work/check_report.json

Beheben Sie jeden fail und die meisten warn-Einträge, indem Sie den Plan bearbeiten (nicht die pptx) und Schritt 5 erneut ausführen – der Plan ist die einzige Quelle der Wahrheit. Exportieren Sie dann die PDF-Vorschau mit dem Container office-renderer (lokal: soffice --headless --convert-to pdf) und überprüfen Sie: Seitenanzahl, vorhandene Titel, Bilder auf den richtigen Seiten.

Schritt 7 – result.json finalisieren

python scripts/build_result.py --case /input/case.json \
    --plan /app/work/deck_plan.json --check /app/work/check_report.json \
    --pptx /app/output/<case_id>.pptx --pdf /app/output/<case_id>_preview.pdf \
    --render-info /app/work/render_info.json --changes /app/work/changes.json \
    --out /app/output/result.json --status complete

Ausnahmebehandlung (reale Pfade)

SituationErkennungAktion
Kein Python-PDF-Backendextract exit 3Verwende pdf-text-tool / pdf-render-tool; gleiches JSON-Format
Verschlüsseltes/beschädigtes PDFextract Warnungen/AusnahmeGebe Unsicherheit in result.json an; fahre mit den geparsten Seiten fort
Arbeit hat keine expliziten EinschränkungenNarrativschrittSage dies auf der Folie; kennzeichne abgeleitete Einschränkungen mit [Lesart des Vortragenden]
Abbildung kann nicht extrahiert werdenfigdir für diese Seite leerRendere den Abbildungsbereich mit pdf-render-tool oder verweise textuell darauf + Hinweis auf Unsicherheit
Extrahiertes Bild ist nicht die zitierte AbbildungBild↔Beschriftungs-KonfliktNicht einbetten; auf textuelle Referenz zurückfallen
Vorlage hat kein benötigtes Layoutrollen_map nullsNächstgelegenes Layout verwenden + Warnung in result.json
Folienanzahl überschreitet LimitAssembler-Fehler 4Plan gemäß Prioritätenordnung aus Schritt 4 kürzen
Textüberlauf bei 12pt-Mindestgrößecheck_deck fail/warnAufzählungspunkte kürzen (Agent bearbeitet Plan)
Notizen würden Folientext wiederholencheck_deck warnNotizen umschreiben, um Übergänge/F&A-Informationen hinzuzufügen
PDF-Export nicht verfügbarRenderer-Fehlerpptx liefern + expliziten null für Vorschau + Grund

Ausgabevertrag

/app/output/result.json enthält: case_id, status, quelle, einschränkungen, ausgabe_vertrag (jedes Feld aus case.json, null + grund wenn nicht vorhanden), ergebnisse (pptx/pdf-Pfade), narrativ, folien_beleg_map (pro Folie Behauptung + Belege), zusammenfassung_qualitätsprüfungen, rendern informationen, änderungen und unsicherheit. Siehe das Beispiel in examples/example-deck-plan.md.

Umfang und Grenzen

Im Umfang: Narrativextraktion, Seitenstrukturierung, Belegzuordnung, Vorlagenanpassung, Notizenerstellung, Rendern-Prüfung. Außerhalb des Umfangs: Neuerstellung von Abbildungen, wissenschaftliche Qualitätsbewertung der Arbeit selbst, Textverfeinerung über die Größe von Folienhinaus. Das Skill nimmt eine englische ML-artige Arbeit an; Beschriftungs-Regexe decken Figure N: / Fig. N: / Table N: ab und lokalisierte Varianten benötigen manuelle Indexkorrekturen (in Änderungen festhalten).

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.

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.

slides-genedit

Generate and edit academic presentation decks from research material. Two routes: (1) generate a new deck from a paper/notes under fixed audience, duration and slide-count constraints, with per-slide claims, verbatim-number evidence mapping, speaker notes, and a rendered PDF preview; (2) source-preserving edits of an existing starting deck - inventory it, apply only the requested local changes, and prove untouched slides stayed byte-identical. Use when asked to turn research material into slides, or to modify/compress/re-audience an existing deck without breaking it.

Verwandte Skills