Communitygithub.com

Präsentation-Bericht

Verwandelt einen technischen Bericht, eine Thesis oder ein Projekt in einen Vortrag und eine Folienpräsentation, überprüft und poliert vorhandene Folien oder ein Vortragsskript und bereitet Probelauf, Durchführung und Fragerunde vor – inklusive Thesis-Verteidigungen, Projektstatus-Vorträgen, Konferenzvorträgen und Kurzstatements (3–10 Minuten). Erstellt Präsentationen in asciidoctor-reveal.js (AsciiDoc) oder LaTeX Beamer mit PlantUML-Diagrammen und Sprechernotizen und prüft sie mit einem Deck-Statistik-Skript. Verwende dies immer, wenn jemand bittet, Folien, ein Deck, eine Präsentation oder einen Vortrag aus einem Bericht oder Ergebnissen zu erstellen, Folien oder Sprechernotizen zu überprüfen, zu kritisieren oder zu verbessern, einen Vortrag auf N Minuten zu kürzen, eine Verteidigung oder ein Status-Update zu planen oder sich auf Fragen nach einem Vortrag vorzubereiten.

Was ist Präsentation-Bericht?

Diese Fähigkeit (Skill) unterstützt KI-Agenten dabei, aus technischen Berichten, Thesen oder Projektergebnissen professionelle Präsentationen zu erstellen, zu überprüfen und zu optimieren. Sie eignet sich für verschiedene Anlässe wie Thesis-Verteidigungen, Projektstatus-Updates, Konferenzvorträge und Kurzstatements. Der Skill basiert auf der Methodik von Hering/Heyne und führt den Agenten durch einen strukturierten Prozess: Zieldefinition und Rahmenanalyse, Auswahl des relevanten Materials, dramaturgische Gliederung des Vortrags, Folienentwurf und schließlich die Erstellung des fertigen Decks in asciidoctor-reveal.js (AsciiDoc) oder LaTeX Beamer. Dabei werden automatisch Sprechernotizen und PlantUML-Diagramme erzeugt. Ein integriertes Statistik-Skript (`deck_stats.py`) prüft die Folien auf Überladung, fehlende Überschriften, Einhaltung der Zeitvorgabe und andere Qualitätskriterien. Zusätzlich können bestehende Präsentationen oder Skripte systematisch reviewt werden, mit konkreten Verbesserungsvorschlägen nach Schweregrad. Der Skill ist für Entwickler und technische Autoren gedacht, die mit diesen Tools arbeiten, und wird über die Kommandozeile in Verbindung mit einem KI-Agenten wie Claude Code genutzt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/larsw/report-writing-skills/tree/HEAD/skills/report-presentation

In Ihrer bevorzugten KI fragen

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

Dokumentation

Technische Präsentationen

Ein Vortrag ist eine Neuschöpfung, nicht der vorgelesene Bericht. Ein Bericht erreicht den Kopf; ein Vortrag erreicht auch den Bauch. Leser wählen ihr Tempo und ihre Distanz (30–40 cm); ein Zuhörer sieht jede Folie für Sekunden, aus 10 m Entfernung, während er gleichzeitig zuhört. Monate Arbeit passen nicht in 20 Minuten: Der Vortrag bietet einen wohlgewählten „Blick durchs Schlüsselloch“, den jeder Zuhörer verfolgen und behalten kann.

Die Methode folgt H. Hering (mit K.-G. Heyne), How to Write Technical and Scientific Reports (3. Aufl., Springer 2025), Kap. 5.

Entscheiden Sie, um welche Aufgabe es sich handelt:

  • Erstellen eines Vortrags/Decks aus einem Bericht oder Material → Abschnitte 1–5
  • Überprüfen eines vorhandenen Decks oder Skripts → Abschnitt 6
  • Proben, Vortragen, Fragen beantworten → references/delivery.md
  • Kurzstatement (3–10 Min., oft unvorbereitete Folien) → references/delivery.md, „Kurzstatement“

1. Rahmen und Ziel (zuerst aufschreiben)

Füllen Sie das Rahmenblatt aus references/talk-planning.md mit dem Benutzer aus, basierend auf dem, was er Ihnen gegeben hat; fragen Sie nur nach, was den Vortrag verändert:

  • Thema und Vortragstitel (kürzer und einprägsamer als der Berichtstitel, dennoch genau)
  • Zielgruppe: wer, Vorkenntnisse, Interessen, Erwartungen, wer entscheidet
  • Anlass und genaues Zeitfenster ohne und mit Diskussion
  • Typ: Lehrvortrag (informieren), Fachvortrag (informieren und beeinflussen), überzeugender Vortrag, Gelegenheitsrede
  • Ziele mit Gewichtungen, z. B. 70 % über Ergebnisse informieren, 20 % Kompetenz zeigen, 10 % Lockerheit und Humor; und der Zweck dahinter (Note, Finanzierung, Entscheidung, Folgeprojekt)
  • Raum, Medien, Remote/Hybrid-Setup; vorherige und nachfolgende Redner
  • Vertraulichkeit: klare Freigaben mit dem Betreuer, Chef oder Kunden (und bei Unternehmen mit der Marketingabteilung) vor externen Vorträgen

2. Material auswählen

Behalten Sie nur, was für diese Zielgruppe und dieses Ziel wesentlich, sinnvoll und repräsentativ ist. Den Rest in eine Reserve (Backup-Folien, „Kann“-Notizen) für übrige Zeit und Fragen. Streichen Sie jeden Exkurs, der hauptsächlich den Autor interessiert.

3. Die Vortragsstruktur erstellen

Distanzieren Sie sich von den Kapiteln des Berichts; nehmen Sie die Position des Publikums ein. Bauen Sie wenige kurze, einprägsame Punkte mit einer Dramaturgie auf:

  • Eröffnen Sie mit etwas, das Spannung erzeugt (eine Frage, ein Problem mit konkreten Konsequenzen, ein markantes Beispiel); schließen Sie, indem Sie es beantworten.
  • Zeitaufteilung etwa 20 % Einleitung / 70 % Hauptteil / 10 % Schluss für einen 20-minütigen Vortrag (4/14/2 Min.). Für 60 Minuten wachsen Einleitung und Schluss unterproportional (8/48/4).
  • Hauptteil für ein gemischtes Publikum (Drittel-Regel), verzahnt, nicht in strengen Blöcken: bekannte Beispiele und Überblick (≈1/3) → neue Erkenntnis auf einem Niveau, das die meisten verfolgen können (≈1/6) → Experten-Details (≈1/3), oft Rückkehr zum allgemeinen Niveau → Zusammenfassung, Schlussfolgerungen, Bewertung, die jeder versteht (≈1/6). Niemand sollte gehen mit dem Gedanken „Das wusste ich alles schon“ oder „Das war zu kompliziert“.
  • Einleitung: Kontakt, Ziel des Vortrags, Ablauf (Strukturfolie), Abgrenzung (was Sie nicht behandeln werden).
  • Schluss: die Kernaussagen nochmals, ein kurzer Ausblick, nichts Neues, ein klares Ende.

Halten Sie es fest im Strukturentwurfsplan (Vorlage in references/talk-planning.md) mit Minutenangaben pro Teil. Ein 135-seitiger Bericht kann zu einer Eröffnungsfrage, einem Hauptpunkt mit drei Unterpunkten und einem Schluss werden.

4. Folien

Lesen Sie references/slide-design.md, bevor Sie Folien schreiben. Das Wesentliche:

  • „Weniger ist mehr.“ 5–7 Elemente pro Folie; Stichworte, keine Sätze (die abschließende Zusammenfassungsfolie darf kurze Aussagen verwenden).
  • Jede Überschrift gibt die Botschaft der Folie in gesprochener Sprache („Integrierte Absaugung entfernt 90 % der Dämpfe“) an und ordnet sich eindeutig dem aktuellen Strukturpunkt zu.
  • Visualisieren statt schreiben; Abbildungen aus dem Bericht für die Projektion umgestalten: weniger Elemente, dickere Linien, viel größere Beschriftungen. Niemals eine Berichts- oder Zeitschriftenabbildung unverändert einfügen.
  • Text nicht kleiner als etwa 1/30 der Folienhöhe (≈ 18 pt auf einer klassischen Folie); serifenlos; höchstens zwei Schriftgrößen pro Folie; Farbe sparsam und immer mit Bedeutung; schwarz auf weiß am lesbarsten; farbiger Text benötigt die 1,5-fache Größe.
  • Kein Ballast, der auf jeder Folie wiederholt wird: kein Vortragstitel, Name, Datum, Zähler „Folie x von y“, lange Fußzeilen. Eine kleine Foliennummer ist in Ordnung.
  • Dritte Rahmenfolien: Titelbild; Strukturfolie mit Inhaltsstichworten (nicht „Einleitung / Hauptteil / Zusammenfassung / Danke“); Abschlussfolie, die zur Diskussion einlädt (Schlüsselbild, Kontaktdaten). „Danke“ und „Fragen?“ werden gesagt, nicht gezeigt.
  • Halten Sie das Publikum orientiert: Zeigen Sie die Struktur bei Übergängen erneut an, mit hervorgehobenem aktuellem Punkt.
  • Animation nur für schrittweisen Aufbau von Listen oder Prozessen; niemals dekorative Bewegungen oder Sound.
  • Markieren Sie überspringbare Folien (Reserve) im Voraus.

5. Das Deck erstellen (asciidoctor-reveal.js oder Beamer)

Verwenden Sie das Format, in dem der Benutzer arbeitet: asciidoctor-reveal.js für AsciiDoc-Projekte, LaTeX Beamer, wenn der Bericht in LaTeX vorliegt oder ein PDF-Deck benötigt wird (bei Unklarheit nachfragen).

  • reveal.js: references/revealjs-asciidoc.md: ein == Abschnitt pro Folie, [.notes] Sprechernotizen auf jeder Inhaltsfolie, [%step] für Aufbauten, PlantUML-Diagramme mit foliengerechten Schriftgrößen, ein benutzerdefiniertes CSS mit der Hervorhebungsklasse für Strukturfolien.
  • Beamer: references/beamer.md: ein frame pro Folie mit einer Botschaftsüberschrift, \note{…} Sprechernotizen, Overlays für Aufbauten, \AtBeginSection + \tableofcontents[currentsection] für die Strukturfolie, Navigationssymbole und wiederholte Fußzeilen ausgeschaltet.

Schreiben Sie in beiden Formaten die Sprechernotizen als Stichworte, nicht als Volltext, gekennzeichnet mit MUSS / SOLLTE / KANN (was gesagt werden muss, was bei Zeitknappheit gestrichen werden kann, was Reserve ist) und mit einem „erledigt bis mm:ss“-Kontrollpunkt an jedem Strukturelement.

Überprüfen Sie es dann:

python3 scripts/deck_stats.py deck.adoc --minutes 20      # Verzeichnis dieses Skills
python3 scripts/deck_stats.py talk.tex --minutes 20       # Beamer: frames, \frametitle, \note, Backup nach \appendix

Es listet pro Folie die sichtbaren Wörter, Elemente und Notizen auf, schätzt die Sprechzeit aus den Notizen (130 Wörter/Min. Standard) und kennzeichnet überladene Folien, Sätze auf Folien, fehlende Überschriften, „Danke“-/„Fragen?“-Folien, generische Tagesordnungspunkte und Folien ohne Notizen. Passen Sie an, bis die geplante Zeit unter dem Slot liegt (Live-Vorträge dauern länger als die Notizen vermuten lassen) und jede Markierung entweder behoben oder eine bewusste Entscheidung ist (eine kurze, dichte Expertenfolie kann beabsichtigt sein).

Liefern Sie: die Deck-Datei (und benutzerdefiniertes CSS), das Rahmenblatt und den Strukturentwurfsplan, die Zeittabelle sowie eine Liste der Reservefolien. Empfehlen Sie einen vollständigen, zeitgesteuerten Probedurchlauf mit einem Zuhörer (siehe references/delivery.md).

6. Überprüfung eines vorhandenen Decks oder Skripts

  1. Besorgen Sie sich den Rahmen: Zielgruppe, Slot, Ziel. Ohne diesen ist Folienfeedback Rätselraten.
  2. Führen Sie deck_stats.py aus (AsciiDoc- oder Beamer-Decks) oder extrahieren Sie den Folientext (.pptx/PDF) und zählen Sie dieselben Dinge durch Lesen.
  3. Überprüfen Sie den Vortrag als Ganzes: Ist er eine Neuschöpfung oder das Berichtsinhaltsverzeichnis auf Folien? Eröffnungsspannung und beantwortete Frage? Zeitaufteilung 20/70/10? Drittel-Regel-Mix (zu oberflächlich für Experten oder zu viel Fachjargon für den Rest)? Theorie zuerst und Beispiele spät (ein häufiger Fehler)? Zwischenzusammenfassungen? Reservematerial? Klarer Abschluss?
  4. Überprüfen Sie jede Folie anhand von references/slide-design.md.
  5. Berichten Sie nach Schweregrad (kritisch: passt nicht in den Slot, falsches Publikumsniveau, keine Botschaft; schwerwiegend: überladene oder unleserliche Folien, Berichtsabbildungen unverändert, fehlende Strukturorientierung; geringfügig: Stildetails). Geben Sie für jeden Folienbefund die Foliennummer/den Titel und eine konkrete Umformulierung (neue Überschrift, Kürzung einer Liste, umgestaltete Abbildungsbeschreibung). Für eine bewertende Beurteilung eines gehaltenen Vortrags verwenden Sie das Bewertungsformular in references/delivery.md.

Individual skills in this repo

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

report-copyedit

Copyedit and line-edit technical and scientific writing (reports, theses, lab reports, papers, specifications, design docs, technical documentation) for clarity, precision, consistent terminology and correct notation, without changing the technical content. Use this whenever someone asks to copyedit, proofread, line-edit, tighten, simplify, polish the language of, improve the readability or flow of, or "fix the English in" a technical text, AsciiDoc, LaTeX or Markdown file; to make terms, units, abbreviations, hyphenation or capitalization consistent; or to build a style sheet from an existing draft. For a whole-document pre-submission review (structure, figures, references, checklist) use report-review instead.

report-drafting

Draft the content of technical and scientific reports - introduction, state of the art, methods/test setup, results, discussion, summary/conclusions, abstract, appendices - together with their figures, tables, PlantUML diagrams, charts, formulas, computations and citations, in AsciiDoc, LaTeX or plain prose. Use this whenever someone asks to write, draft, expand, or turn notes, data, measurements, code or bullet points into a section of a report, thesis, lab report, design report, project report or technical documentation; to create or improve a figure, diagram, chart, caption, table or evaluation/decision matrix for one; to set up equations or a load calculation; or to add citations and a reference list - even if they just say "write up these results".

report-outline

Plan a technical or scientific report before and while drafting it - analyze the assignment, write and test title variants, condense the core message into one sentence, grow a 4-point then 10-point then detailed outline, pick a structure pattern for the report type (lab/test report, design report, project report, thesis, manual, research paper), and set up a style sheet and an AsciiDoc or LaTeX skeleton. Use this whenever someone is starting or reorganizing a report, thesis, lab report, design report, project report or technical documentation and asks for an outline, structure, table of contents, chapter plan, section order, working title or title ideas, or asks "how should I organize this?" - and also to check an existing outline or ToC for logic (lone subsections, unequal siblings, vague headings).

report-review

Review a technical or scientific report, thesis, lab report, design report or technical document as a whole before submission or release - structure and logic, completeness, clarity for a reader without project knowledge, figures and tables, citations and reference list, formulas and notation, terminology consistency, cross-references, open TODO markers and output quality - using a mechanical AsciiDoc/LaTeX linter plus a checklist, and produce a prioritized findings report with concrete fixes. Use this whenever someone asks to review, check, audit, assess, give feedback on, "look over", or do a final/pre-submission/QA pass on a report or thesis (AsciiDoc, LaTeX, Markdown, PDF or Word), asks "is this ready to hand in?", or wants supervisor-style feedback on a draft chapter.

Verwandte Skills