agentleFS
EvoScientistEvoScientist/EvoSkills/skills/academic-slides/SKILL.md

academic-slides

Skill481 starsChanged 45 days agoApache-2.0View on GitHub

Use this skill for creating or refining an academic slide deck and the talk built around it: structuring a conference talk, thesis defense, lab meeting, or paper-to-slides deck; deciding the narrative arc and slide breakdown; improving slide design and visual hierarchy; planning rehearsal, timing, Q&A, and backup slides; or generating the .pptx. Reach for it when the user is shaping the presentation itself. Do not use for writing the paper, producing standalone speaker notes/scripts/transcripts, making posters, creating isolated figures/charts outside a slide deck, or building non-academic presentations.

  • Installs packages

2 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

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

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Before designing any slides, answer these questions clearly:

    line 27
  2. Distinctive:

    Use the outline template at assets/talk-outline-template.md to plan your talk before making any slides.

    line 65
  3. Very specific:

    Use slide-creation.md for practical .pptx creation — color palettes, layout code, charts, tables, figures, and QA workflow.

    line 77
  4. Very specific:

    If you used other EvoSkills earlier in the pipeline, pull these artifacts directly:

    line 98
  5. Distinctive:

    Use related work to BUILD your problem motivation, not to show you have read papers.

    line 130

≈ “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

Academic Slides

A structured approach to creating academic presentation slides and preparing research talks. Covers narrative structure, slide design, visual hierarchy, delivery technique, and Q&A preparation.

When to Use This Skill

  • User wants to create presentation slides for a research talk
  • User asks about structuring an academic presentation
  • User needs to prepare for a conference talk, thesis defense, or lab meeting
  • User wants to design a slide deck from a paper or research project
  • User mentions "slides", "presentation", "talk", "defense", "poster talk"

Before You Start: Three Questions

Before designing any slides, answer these questions clearly:

  1. What works are you presenting? They must share a coherent research direction. If presenting multiple works, they should form a narrative arc — not a disconnected list.
  2. What problems do these works solve in that direction? Each work should map to a specific problem. If you cannot articulate the problem in one sentence, you are not ready to present.
  3. How do you use related work to naturally introduce these problems? Related work is not citation duty. It builds the motivation for YOUR problem. Each related work you mention should advance the audience toward understanding why your approach is needed.

Core Workflow

Step 1: Define scope and audience
Step 2: Draft narrative arc (outline)
Step 3: Design slide structure (section breakdown)
Step 4: Create individual slides (one idea per slide)
Step 5: Build the .pptx file (layouts, figures, charts, QA)
Step 6: Rehearse and time
Step 7: Prepare backup slides (for Q&A)

Step 1: Define Scope and Audience

AudienceAdjust
Domain expertsSkip basics, go deep on method and results
Broad CS / engineeringExplain task context, moderate technical depth
InterdisciplinaryStart from the application, minimize jargon
IndustryLead with impact and demo, light on theory

Rule of thumb: Duration in minutes = approximate slide count. A 20-minute talk needs about 20 slides.

Step 2: Draft Narrative Arc

Use the outline template at assets/talk-outline-template.md to plan your talk before making any slides. The outline forces you to articulate your key takeaway and narrative arc.

Step 3: Design Slide Structure

Break your outline into sections with claim-style headers. See talk-structure.md for two complete talk structures and section-by-section guidance.

Step 4: Create Individual Slides

One idea per slide. Follow the 10 design rules in slide-design.md for visual hierarchy and layout.

Step 5: Build the .pptx File

Use slide-creation.md for practical .pptx creation — color palettes, layout code, charts, tables, figures, and QA workflow.

Dependencies: pip install "markitdown[pptx]" pillow (also listed in requirements.txt at the skill root) for text extraction and QA, plus the Node packages named in the Setup section of slide-creation.md. Install into the environment the user is working in.

Step 6: Rehearse and Time

See references/delivery-and-qa.md for the rehearsal protocol, delivery principles, and Q&A preparation.

Step 7: Prepare Backup Slides

Backup slides go after your "Thank You" slide. They are not part of the talk — they are your safety net for Q&A:

  • Full quantitative comparison table
  • Failure cases (shows honesty and preparation)
  • Additional ablations or analysis
  • Slides addressing anticipated tough questions

Artifact Sources from Other Skills

If you used other EvoSkills earlier in the pipeline, pull these artifacts directly:

Source SkillArtifactUse In Slides
paper-planningStory summary (task → challenge → insight)Motivation slides
paper-planningPipeline figure sketchMethod overview slide
paper-planningExperiment planResults structure
paper-writingFinalized figures and tablesMethod + results slides
paper-reviewAnticipated reviewer concernsBackup Q&A slides

See slide-creation.md for detailed layout patterns using each artifact.


Counterintuitive Presentation Rules

For the 10 design rules (one idea per slide, claim-style titles, max 6 elements, etc.), see slide-design.md. The rules below are higher-level mindset shifts.

1. Your slides are not your paper

A talk is an advertisement, not a lecture. Your goal is to make the audience interested enough to read the paper. Cut 80% of your paper's content. If someone can reconstruct your paper from your slides alone, your slides have too much.

2. Reading and listening compete

Text-heavy slides force the audience to choose between reading your slides and listening to you. They will read — and stop hearing you. When you put text on a slide, you are choosing to be ignored.

3. Enthusiasm > polish

A passionate speaker with rough slides beats a bored speaker with beautiful slides. The audience remembers your energy and clarity, not your color scheme. If you only have time to improve one thing, rehearse more — don't redesign slides.

4. Related work is not citation duty

Use related work to BUILD your problem motivation, not to show you have read papers. Each related work slide should advance the narrative: "This approach solved X, but Y remains open — which is exactly what we address."


Reference Navigation

TopicReference FileWhen to Use
Talk structurestalk-structure.mdOrganizing the narrative arc
Slide designslide-design.mdVisual design and layout rules
Slide creationslide-creation.mdBuilding .pptx files with code
Delivery and Q&Adelivery-and-qa.mdRehearsal, timing, Q&A preparation
Talk outline templatetalk-outline-template.mdStarting a new presentation

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.