alterlab-scientific-slides

$npx mdskill add AlterLab-IEU/AlterLab-Academic-Skills/alterlab-scientific-slides

Builds scientific slide decks for conferences, seminars, and defenses.

  • Creates PowerPoint and LaTeX Beamer presentations for research talks.
  • Uses python-pptx for PowerPoint and pdflatex for Beamer output.
  • Provides slide structure, design templates, and timing guidance.
  • Delivers slide decks with visual validation via PDF/PNG conversion.

SKILL.md

.github/skills/alterlab-scientific-slidesView on GitHub ↗
---
name: alterlab-scientific-slides
description: Builds slide decks for research talks in PowerPoint and LaTeX Beamer, providing slide structure, design templates, timing guidance, and visual validation. Use when making conference presentations, seminar talks, research presentations, thesis-defense slides, or any scientific talk deck. Part of the AlterLab Academic Skills suite.
allowed-tools: Read Write Edit Bash
license: MIT
compatibility: PowerPoint output uses python-pptx; LaTeX Beamer output needs a LaTeX distribution (pdflatex); slide-to-image validation helpers convert decks to PDF/PNG
metadata:
    skill-author: AlterLab
    version: "1.0.0"
---

# Scientific Slides

## Overview

Scientific presentations are a critical medium for communicating research, sharing findings, and engaging with academic and professional audiences. This skill provides comprehensive guidance for creating effective scientific presentations, from structure and content development to visual design and delivery preparation.

**Key Focus**: Oral presentations for conferences, seminars, defenses, and professional talks.

**CRITICAL DESIGN PHILOSOPHY**: Scientific presentations should be VISUALLY ENGAGING and RESEARCH-BACKED. Avoid dry, text-heavy slides at all costs. Great scientific presentations combine:
- **Compelling visuals**: High-quality figures, images, diagrams (not just bullet points)
- **Research context**: Proper citations from research-lookup establishing credibility
- **Minimal text**: Bullet points as prompts, YOU provide the explanation verbally
- **Professional design**: Modern color schemes, strong visual hierarchy, generous white space
- **Story-driven**: Clear narrative arc, not just data dumps

**Remember**: Boring presentations = forgotten science. Make your slides visually memorable while maintaining scientific rigor through proper citations.

## When to Use This Skill

This skill should be used when:
- Preparing conference presentations (5-20 minutes)
- Developing academic seminars (45-60 minutes)
- Creating thesis or dissertation defense presentations
- Designing grant pitch presentations
- Preparing journal club presentations
- Giving research talks at institutions or companies
- Teaching or tutorial presentations on scientific topics

## Slide Generation with Nano Banana Pro

**This skill uses Nano Banana Pro AI to generate stunning presentation slides automatically.** There are two workflows depending on output format:

- **PDF workflow (default, recommended)** — generate each slide as a complete image, then combine into a PDF. Most visually stunning; best for conference/business/general talks.
- **PPT workflow** — generate visuals only (`--visual-only`), then build editable slides with the PPTX skill. Best for company templates and editable decks.

Full step-by-step protocol (planning, formatting-consistency rules, citation/figure-attachment handling, example commands) is in `references/nano_banana_workflows.md`.

**Key conventions (apply to every prompt):**
- **Default author is "AlterLab"** unless another name is specified.
- Define a **FORMATTING GOAL** (colors, typography, layout) and repeat it in every prompt; **always `--attach` the previous slide** for visual continuity.
- Include **citations** directly in the prompt text so they render on the slide; before results slides, list `figures/`/`results/` and `--attach` the actual data figures.

### Environment Setup (required)

```bash
export OPENROUTER_API_KEY='your_api_key_here'
# Get key at: https://openrouter.ai/keys
```

The `generate_slide_image.py` script reads `OPENROUTER_API_KEY` (or accepts `--api-key`); a `.env` in the working dir or a parent also works. The image and quality-review models default to Google Gemini image/vision models routed through OpenRouter and can be overridden with `ALTERLAB_IMAGE_MODEL` / `ALTERLAB_REVIEW_MODEL`. Refinement is capped at 2 iterations. Full script options and prompt-writing templates are in `references/scripts_and_prompts.md`.

### Minimal example

```bash
# Title slide (establishes style — default author: AlterLab)
python scripts/generate_slide_image.py "Title slide: 'Your Research Title'. Conference name, AlterLab. FORMATTING GOAL: [color scheme], minimal professional design, no decorative elements." -o slides/01_title.png

# Content slide (attach previous for consistency, include citations)
python scripts/generate_slide_image.py "Slide titled 'Why This Matters'. Three key points with simple icons. CITATIONS: (Smith et al., 2023; Jones et al., 2024). FORMATTING GOAL: Match attached slide style exactly." -o slides/02_intro.png --attach slides/01_title.png

# Combine to PDF
python scripts/slides_to_pdf.py slides/*.png -o presentation.pdf
```

If a diagram or figure would aid comprehension, invoke the **alterlab-scientific-schematics** skill (diagrams) or **alterlab-generate-image** skill (images). Figures are optional — add them only where they improve clarity.

## Core Workflow

1. **Plan** — define talk type, duration, audience, venue. Use the **research-lookup** skill to gather 8-15 papers for citations and outline the narrative arc (Hook → Context → Gap → Approach → Results [40-50% of time] → Implications → Closure).
2. **Choose implementation** — Nano Banana Pro PDF (default), PowerPoint via PPTX skill, or LaTeX Beamer (math-heavy).
3. **Build visual-first** — every slide needs a strong visual; text is supporting (3-4 bullets, 4-6 words, 24-28pt body / 36-44pt titles). Modern palette, high contrast (7:1 preferred), 40-50% white space.
4. **Validate visually** — convert to images with `pdf_to_images.py`, inspect for overflow/overlap/small fonts/contrast, iterate until clean. Run `validate_presentation.py --duration N` for slide-count-vs-duration, file-size, and (PPTX-only) font-size/bullet-count checks. Contrast is judged visually from the images, not by the script.
5. **Practice** — 3-5 times with a timer (~1 slide/min), set checkpoints, never skip conclusions.

## Routing — where to look

| You need… | Go to |
|-----------|-------|
| Full Nano Banana Pro PDF/PPT workflow, formatting-consistency protocol, citation & figure-attachment rules, worked command examples | `references/nano_banana_workflows.md` |
| Script options (`generate_slide_image.py`, `slides_to_pdf.py`, `validate_presentation.py`, `pdf_to_images.py`), env setup, prompt-writing templates, external tools | `references/scripts_and_prompts.md` |
| Capability detail: structure, design principles, data-viz for slides, talk-type guidance, implementation options, visual-review steps, timing, validation checklist | `references/core_capabilities.md` |
| End-to-end 6-stage development process, integration with other skills, common pitfalls (content/design/timing) | `references/development_workflow.md` |
| Deep dives on structure | `references/presentation_structure.md` |
| Deep dives on slide design | `references/slide_design_principles.md` |
| Adapting figures for slides | `references/data_visualization_slides.md` |
| Talk-type specifics (conference/seminar/defense/grant/journal-club) | `references/talk_types_guide.md` |
| LaTeX Beamer reference | `references/beamer_guide.md` |
| Visual review/iteration workflow | `references/visual_review_workflow.md` |

**Assets:** Beamer templates (`assets/beamer_template_{conference,seminar,defense}.tex`), `assets/powerpoint_design_guide.md`, `assets/timing_guidelines.md`.

## Key Principles

1. **Visual-First Design** — every slide needs a strong visual element; avoid text-only slides.
2. **Research-Backed** — use research-lookup to find 8-15 papers, cite 3-5 in intro and 3-5 in discussion.
3. **Modern Aesthetics** — contemporary palette matching topic, not default themes.
4. **Minimal Text** — 3-4 bullets, 4-6 words each (24-28pt), let visuals tell the story.
5. **Structure** — follow the story arc, spend 40-50% on results.
6. **High Contrast** — 7:1 preferred for professional appearance.
7. **Timing** — practice 3-5 times, ~1 slide/minute, never skip conclusions.

**Remember:** Boring = Forgotten. Combine compelling visuals with research-backed context — slides are visual support, not a replacement for your talk.

More from AlterLab-IEU/AlterLab-Academic-Skills

SkillDescription
alterlab-abm-mesaBuilds agent-based models of social systems with Mesa 3 — the current AgentSet API (model.agents.shuffle_do('step'), auto-assigned unique_id, mandatory super().__init__(seed=...)), cell spaces (mesa.discrete_space OrthogonalMooreGrid / classic mesa.space grids), the DataCollector, batch_run parameter sweeps, and SolaraViz — for emergence, segregation, diffusion, opinion dynamics, and cooperation models. It uses the Mesa 3.x API (the old mesa.time schedulers like RandomActivation are removed) and treats the model as a generative theory to be validated, not just run. Use when the request mentions an agent-based model, Mesa, simulating interacting agents, or emergent macro behavior from micro rules. For discrete-event (queueing/process) simulation prefer alterlab-simpy; for reinforcement learning prefer alterlab-stable-baselines3. Part of the AlterLab Academic Skills suite.
alterlab-academic-careerPrepares academic career documents and professional-development materials for faculty and researchers. Use when drafting academic CVs, research statements, teaching philosophies, diversity statements, faculty-position cover letters, tenure dossiers, promotion narratives, academic portfolios, or mentorship statements, and when planning conference-networking strategy, building academic web presence, setting up ORCID profiles, or understanding impact metrics. Part of the AlterLab Academic Skills suite.
alterlab-accreditation-aolScaffolds program-level Assurance-of-Learning (AoL) documentation for AACSB (2020 Standard 5) and ABET (Criterion 3 Student Outcomes, Criterion 4 Continuous Improvement) accreditation — program learning outcomes / competency goals, curriculum-to-outcome mapping matrices, direct- and indirect-assessment plans, rubric design, and closing-the-loop continuous-improvement narratives — and validates the structure of an outcome-mapping matrix with scripts/aol_matrix.py. Use when the user needs AACSB or ABET assurance-of-learning material, a program-learning-outcomes set, a curriculum/outcome map or coverage matrix, a direct/indirect assessment plan, a closing-the-loop report, or accreditation self-study text. For single-course design or course rubrics prefer alterlab-teaching-design; for post-award grant reports prefer alterlab-grant-reporting. Part of the AlterLab Academic Skills suite.
alterlab-adaptyvSubmits and tracks protein-testing experiments on the Adaptyv Bio Foundry cloud lab (wet-lab validation), and optimizes protein sequences before submission with computational tools (NetSolP, SoluProt, SolubleMPNN, ESM). Use when designing proteins that need wet-lab validation - binding/affinity screening, expression testing, thermostability, or fluorescence assays - or when submitting experiments to the Foundry API, browsing the target catalog, tracking experiment status, retrieving results, or pre-screening sequences for solubility/expression. Triggers on "Adaptyv", "Foundry API", "cloud lab", "biolayer interferometry / BLI", "wet-lab validation". Part of the AlterLab Academic Skills suite.
alterlab-aeonRuns time series machine learning with the aeon library — classification, regression, clustering, forecasting, anomaly detection, segmentation, and similarity search via scikit-learn compatible APIs. Use when working with temporal data, sequential patterns, or time-indexed observations (univariate or multivariate) that need specialized algorithms beyond standard ML approaches. Part of the AlterLab Academic Skills suite.
alterlab-akademik-tesvikComputes the annual Turkish academic-incentive (akademik teşvik) score for Devlet (state) university öğretim elemanı (academic staff) from a classified activity list, applying the verified Akademik Teşvik Ödeneği Yönetmeliği (2018/11834) Faaliyet Hesaplama Tablosu headline puanları (Proje 20, Araştırma 15, Yayın 30, Patent 30, Atıf 30, Tebliğ 20, Ödül 20) with the k (author-count), p (Q1 1/Q2 0.8/Q3 0.5/Q4 0.25), and r (project-role) coefficients via türü puanı = Σ(faaliyet oranları) × headline (MADDE 8/2), then enforcing the per-type headline ceilings, the 100 cap (MADDE 8/3), and the net-30 payment gate (MADDE 10/3) in a deterministic scripts/tesvik_score.py. Use when the user wants to calculate akademik teşvik puanı, check the en az 30 (net-30) threshold, apply TABLO 4 ceilings, or estimate teşvik eligibility; keeps its coefficients separate from doçentlik scoring. For doçentlik point eligibility prefer alterlab-docentlik-eligibility. Part of the AlterLab Academic Skills suite.
alterlab-alpha-vantageAccesses real-time and historical stock market data, forex rates, cryptocurrency prices, commodities, economic indicators, and 50+ technical indicators via the Alpha Vantage API (requires a free API key from alphavantage.co). Use when fetching stock prices (OHLCV), company fundamentals (income statement, balance sheet, cash flow), earnings, options data, market news/sentiment, insider transactions, GDP, CPI, treasury yields, gold/silver/oil prices, Bitcoin/crypto prices, forex exchange rates, or calculating technical indicators (SMA, EMA, MACD, RSI, Bollinger Bands). Part of the AlterLab Academic Skills suite.
alterlab-alphafoldPredict protein 3D structures with AlphaFold2 via ColabFold — MMseqs2-accelerated MSAs, monomer and AlphaFold2-Multimer complex folding, and confidence-based validation (pLDDT, pTM/ipTM, PAE). Use when folding a protein sequence or complex from FASTA, generating a predicted structure with confidence metrics, ranking models, or checking self-consistency of a design. For co-folding a protein WITH a small-molecule ligand or predicting binding affinity prefer alterlab-boltz; for antibody–antigen or one-FASTA multi-entity complexes prefer alterlab-chai; to LOOK UP an already-computed structure prefer alterlab-alphafold-db; for ESM embeddings or inverse folding prefer alterlab-esm. Part of the AlterLab Academic Skills suite.
alterlab-alphafold-dbAccess the AlphaFold DB of 200M+ AI-PREDICTED protein structures — retrieve models by UniProt accession, download PDB/mmCIF files, and analyze prediction confidence metrics (pLDDT, PAE). Use when a UniProt ID needs a computationally predicted 3D structure or when no experimental structure exists, for homology modeling, protein engineering, or structure-based drug discovery; for EXPERIMENTALLY determined structures (X-ray, cryo-EM, NMR) prefer alterlab-pdb, and for protein sequences, annotations, or accession ID mapping prefer alterlab-uniprot instead. Part of the AlterLab Academic Skills suite.
alterlab-anndataBuild, slice, concatenate, read, and write AnnData annotated data matrices (obs, var, X, layers, obsm, uns) — the scverse data STRUCTURE, not an analysis pipeline. Use when creating or wrangling .h5ad/zarr files, managing cell and gene annotations, concatenating batches, or handling layers/obsm/backed-mode; for the QC, normalization, clustering, UMAP, and differential-expression analysis pipeline prefer alterlab-scanpy instead, and for RNA velocity from spliced/unspliced layers prefer alterlab-scvelo instead. Part of the AlterLab Academic Skills suite.