agentleFS
TobiasBlaskTobiasBlask/open-paper-machine/skills/presentation-engine/SKILL.md

presentation-engine

Skill18 starsChanged 7 months agoMITView on GitHub

Activate when the user needs to create conference presentation slides from a completed paper. Extracts key content, designs a slide structure, generates slide content with speaker notes, and produces a presentation-ready markdown file. Supports IS/CS conference formats (15-20 min presentations).

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 5 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈5

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    After paper acceptance at a conference

    line 32
  2. Distinctive:

    Read the paper and extract:

    line 46
  3. Distinctive:

    All limitations (pick the 2 most honest ones)

    line 62
  4. Distinctive:

    Remove slides 6 (method detail), 11 (results 4), and merge 12-13.

    line 95
  5. Distinctive:

    Add: deeper literature context, method details, additional findings, more discussion, interactive elements.

    line 99

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Orchestration Log: When this skill is activated, append a log entry to outputs/orchestration_log.md:

### Skill Activation: Presentation Engine
**Timestamp:** [current date/time]
**Actor:** AI Agent (presentation-engine)
**Input:** [paper source], target format: [conference talk / workshop / poster]
**Output:** presentation.md with [N] slides + speaker notes

Presentation Engine

Core Principle

A conference presentation is NOT a paper read aloud. It's a persuasion exercise: convince the audience in 15-20 minutes that your research matters, your method is sound, and your findings are interesting. This engine transforms a paper into a focused, visually driven presentation with clear narrative flow.

When to Activate

  • User says "create slides", "make a presentation", "conference talk"
  • User says "prepare presentation for [venue]", "slide deck"
  • After paper acceptance at a conference
  • User runs /generate-slides

Prerequisites

  • draft.md or latex/paper.tex exists (complete paper)
  • figures/ directory with generated figures (optional but recommended)

Step 1: EXTRACT Key Content

From Each Section

Read the paper and extract:

SectionExtractMax Slides
Title/AbstractTitle, authors, affiliations, 1-sentence summary1
IntroductionMotivation hook, gap, RQ(s)2-3
Theoretical BackgroundKey theory/framework, 1-2 core concepts1-2
MethodologyMethod name, key design choices, data summary2-3
Results/FindingsTop 3-5 findings, key tables/figures4-6
DiscussionKey implications (2-3), limitations (1-2)2-3
ConclusionMain takeaway, future directions1

What to Leave Out

  • Detailed literature review (one framework slide is enough)
  • Methodological minutiae (sampling details, coding tables)
  • All limitations (pick the 2 most honest ones)
  • Roadmap paragraph
  • Most of the related work

Step 2: DESIGN Slide Structure

Standard Conference Talk (15-20 min, 15-18 slides)

## Slide Structure

1. **Title Slide** — Title, authors, affiliations, venue, date
2. **Motivation** — Why should the audience care? (practical hook)
3. **Problem / Gap** — What don't we know? What's missing?
4. **Research Question(s)** — Clear, prominent, memorable
5. **Theoretical Lens** — Key framework (1 visual if possible)
6. **Method Overview** — Approach in 3-5 bullet points + visual
7. **[Method Detail]** — Optional: sample, process, timeline
8. **Results 1** — First major finding (with figure/table)
9. **Results 2** — Second major finding
10. **Results 3** — Third major finding (or synthesis)
11. **[Results 4]** — Optional: additional finding or robustness
12. **Discussion: What This Means** — Interpretation of findings
13. **Implications** — For theory AND practice (split or combined)
14. **Limitations & Future** — Honest, brief, forward-looking
15. **Conclusion / Takeaway** — One memorable message
16. **Thank You / Q&A** — Contact info, paper reference

Short Talk (10 min, 10-12 slides)

Remove slides 6 (method detail), 11 (results 4), and merge 12-13.

Workshop / Seminar (30-45 min, 25-30 slides)

Add: deeper literature context, method details, additional findings, more discussion, interactive elements.


Step 3: GENERATE Slide Content

Format: Markdown Slides

Generate slides in Marp-compatible markdown format:

---
marp: true
theme: academic
paginate: true
---

# [Paper Title]
## [Subtitle if applicable]

**[Author 1]**, [Author 2], [Author 3]
[Affiliation(s)]
[Venue] — [Date]

---

# Motivation

[Striking opening statement or statistic]

- [Key trend 1]
- [Key trend 2]
- [Key challenge]

> "[Compelling quote or statistic]" — [Source]

<!-- speaker notes:
Open with the practical relevance. Spend 1 minute here.
Make the audience feel the problem before you state the RQ.
-->

---

# The Gap

What we **know**: [established knowledge, 2-3 points]

What we **don't know**: [specific gap]

Why it **matters**: [consequence of the gap]

<!-- speaker notes:
Transition from what we know to what's missing.
Emphasize why this gap matters for both theory and practice.
-->

---

# Research Question

> **RQ: [Research Question]**

[1-2 sentences contextualizing the question]

<!-- speaker notes:
Pause after showing the RQ. Let the audience read it.
This is the anchor of your entire talk.
-->

---

Slide Design Principles

For each slide:

  • One idea per slide — never more
  • Maximum 5-6 bullet points — prefer 3-4
  • Maximum 7 words per bullet — use fragments, not sentences
  • One figure or table per slide — large, readable
  • Speaker notes for every slide — 2-5 sentences of what to say

Figure Integration

For figures from the paper:

  • Reference existing figures/fig_*.png files
  • Recommend which figures work on slides (some are too detailed)
  • Suggest simplifying complex figures for presentation

Step 4: GENERATE Speaker Notes

Speaker Note Template per Slide Type

For Motivation slides:

Open with [the hook]. Pause for effect.
Key message: [what the audience should feel/understand].
Transition: "This brings us to the question of..."
Time: ~1 minute

For Results slides:

Present [finding]. Point to [specific part of figure/table].
Explain what this means: [interpretation in plain language].
Connect to RQ: "This tells us that [answer to RQ aspect]."
If asked about [likely question]: [prepared answer].
Time: ~2 minutes per result slide

For Discussion slides:

Summarize: "So what does this mean?"
Key implication: [most important takeaway].
Compare to prior work: "Unlike [Author], we find [contrast/extension]."
Time: ~2 minutes

Step 5: SAVE Output

Output Files

FileContent
presentation/presentation.mdMarp-compatible slide deck with speaker notes
presentation/speaker_notes.mdStandalone speaker notes (for rehearsal)
presentation/slide_outline.mdSlide-by-slide outline (for quick reference)
presentation/figures/Presentation-optimized figures (if modified)

Checkpoint

🎤 PRESENTATION READY
━━━━━━━━━━━━━━━━━━━━
Paper: "[Title]"
Format: [Conference talk / Workshop / Seminar]
Slides: [N] slides (~[N] minutes estimated)

Structure:
  1-3:   Introduction & Motivation
  4-5:   Theory & Method
  6-10:  Results
  11-14: Discussion & Implications
  15-16: Conclusion & Q&A

📁 Saved: presentation/

→ Review slides and speaker notes
→ Rehearse with speaker notes (target: [N] min)
→ Render with Marp: marp presentation.md --pdf

Error Recovery

  • Paper too long for slot: Prioritize ruthlessly. Focus on 2-3 findings, not all.
  • No figures in paper: Generate simple visuals for key findings via figure-engine.
  • Multiple RQs: Dedicate 1 slide to listing all RQs, then focus the talk on answering the most important one.
  • Paper is in German, talk in English (or vice versa): Translate key terms, keep framework names in original language.

Integration

ScenarioIntegration
After paper acceptanceNatural next step
Figure-engineGenerate presentation-specific visuals
Writing-engineRefine speaker note language
Submission-enginePresentation deadline tracking

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.