Skill Tracer
Skills › Scientific Agent Skills › scientific-slides › presentation_workflow.md

presentation_workflow.md

200 lines · skills/scientific-slides/references/presentation_workflow.md at 5f2bc03

Open on GitHub

Most marks come from matching words in the file, so treat them as pointers.

1# Presentation Development Workflow
2
3The six stages from planning through final preparation, with the checks that belong at
4each stage.
5
6Treat the section ranges below as planning options, not additive time budgets.
7Choose one concrete allocation whose sum includes transitions, buffer, and any in-slot
8Q&A. The [timing guide](../assets/timing_guidelines.md) gives checked 5-, 15-, and
945-minute budgets; rehearsal, not slide count, determines whether the deck fits.

Presentation Development Workflow

The six stages from planning through final preparation, with the checks that belong at each stage.

Treat the section ranges below as planning options, not additive time budgets. Choose one concrete allocation whose sum includes transitions, buffer, and any in-slot Q&A. The timing guide gives checked 5-, 15-, and 45-minute budgets; rehearsal, not slide count, determines whether the deck fits.

Raw lines 1 to 10
11## Workflow for Presentation Development

Workflow for Presentation Development

Raw lines 11 to 12
13### Stage 1: Planning (Before Creating Slides)
15**Define Context**:
161. What type of talk? (Conference, seminar, defense, etc.)
172. How long? (Duration in minutes)
183. Who is the audience? (Specialists, general, mixed)
194. What's the venue? (Room size, A/V setup, virtual/in-person)
205. What happens after? (Q&A, discussion, networking)
22**Research and Literature Review** (Use research-lookup skill):
231. **Search for background literature**: Find 5-10 key papers establishing context
242. **Identify knowledge gaps**: Use research-lookup to find what's unknown
253. **Locate comparison studies**: Find papers with similar methods or results
264. **Gather supporting citations**: Collect papers supporting your interpretations
275. **Build reference list**: Create .bib file or citation list for slides
286. **Note key findings to cite**: Document specific results to reference
30**Develop Content Outline**:
311. Identify 1-3 core messages
322. Select key findings to present
333. Choose essential figures (typically 3-6 for 15-min talk)
344. Plan narrative arc with proper citations
355. Allocate time by section
37**Example Outline for 15-Minute Talk**:
38```
391. Title (30 sec)
402. Hook: Compelling problem (60 sec) [Cite 1-2 papers via research-lookup]
413. Background (90 sec) [Cite 3-4 key papers establishing context]
424. Research question (45 sec) [Cite papers showing gap]
435. Methods overview (2 min)
446-8. Main result 1 (3 min, 3 slides)
459-10. Main result 2 (2 min, 2 slides)
4611-12. Result 3 or validation (2 min, 2 slides)
4713-14. Discussion and implications (2 min) [Compare to 2-3 prior studies]
4815. Conclusions (45 sec)
4916. Acknowledgments (15 sec)
51NOTE: Use research-lookup to find papers for background (slides 2-4)
52and discussion (slides 13-14) BEFORE creating slides.
53```

Stage 1: Planning (Before Creating Slides)

Define Context:

  1. What type of talk? (Conference, seminar, defense, etc.)
  2. How long? (Duration in minutes)
  3. Who is the audience? (Specialists, general, mixed)
  4. What's the venue? (Room size, A/V setup, virtual/in-person)
  5. What happens after? (Q&A, discussion, networking)

Research and Literature Review (Use research-lookup skill):

  1. Search for background literature: Find 5-10 key papers establishing context
  2. Identify knowledge gaps: Use research-lookup to find what's unknown
  3. Locate comparison studies: Find papers with similar methods or results
  4. Gather supporting citations: Collect papers supporting your interpretations
  5. Build reference list: Create .bib file or citation list for slides
  6. Note key findings to cite: Document specific results to reference

Develop Content Outline:

  1. Identify 1-3 core messages
  2. Select key findings to present
  3. Choose essential figures (typically 3-6 for 15-min talk)
  4. Plan narrative arc with proper citations
  5. Allocate time by section

Example Outline for 15-Minute Talk:

1. Title (30 sec)
2. Hook: Compelling problem (60 sec) [Cite 1-2 papers via research-lookup]
3. Background (90 sec) [Cite 3-4 key papers establishing context]
4. Research question (45 sec) [Cite papers showing gap]
5. Methods overview (2 min)
6-8. Main result 1 (3 min, 3 slides)
9-10. Main result 2 (2 min, 2 slides)
11-12. Result 3 or validation (2 min, 2 slides)
13-14. Discussion and implications (2 min) [Compare to 2-3 prior studies]
15. Conclusions (45 sec)
16. Acknowledgments (15 sec)

NOTE: Use research-lookup to find papers for background (slides 2-4) 
and discussion (slides 13-14) BEFORE creating slides.
Raw lines 13 to 54
Names a skill research-lookup :22
55### Stage 2: Design and Creation
57**Choose Implementation Method**:
59**Option A: PowerPoint (PptxGenJS or python-pptx)**
601. Read `assets/powerpoint_design_guide.md`
612. Choose approach (programmatic or template-based)
623. Create master slides with consistent design
634. Build presentation following outline
65**Option B: LaTeX Beamer**
661. Read `references/beamer_guide.md`
672. Select appropriate template from `assets/`
683. Customize theme and colors
694. Write content in LaTeX
705. Compile to PDF
72**Design Considerations** (Make It Visually Appealing):
73- **Select MODERN color palette**: Match your topic (biotech=vibrant, physics=sleek, health=warm)
74 - Use the topic-based palettes in `assets/powerpoint_design_guide.md` (Teal & Coral, Bold Red & Orange, Deep Purple & Magenta, etc.)
75 - NOT just default blue/gray themes
76 - 3-5 colors with high contrast
77- **Choose clean fonts**: Sans-serif, large sizes (24pt+ body)
78- **Plan visual elements**: What images, diagrams, icons for each slide?
79- **Create varied layouts**: Mix full-figure, two-column, text-overlay (not all bullets)
80- **Design section dividers**: Visual breaks with striking graphics
81- **Plan animations/builds**: Control information flow for complex slides
82- **Add visual interest**: Background images, color blocks, shapes, icons

Stage 2: Design and Creation

Choose Implementation Method:

Option A: PowerPoint (PptxGenJS or python-pptx)

  1. Read assets/powerpoint_design_guide.md
  2. Choose approach (programmatic or template-based)
  3. Create master slides with consistent design
  4. Build presentation following outline

Option B: LaTeX Beamer

  1. Read references/beamer_guide.md
  2. Select appropriate template from assets/
  3. Customize theme and colors
  4. Write content in LaTeX
  5. Compile to PDF

Design Considerations (Make It Visually Appealing):

  • Select MODERN color palette: Match your topic (biotech=vibrant, physics=sleek, health=warm)
  • Use the topic-based palettes in assets/powerpoint_design_guide.md (Teal & Coral, Bold Red & Orange, Deep Purple & Magenta, etc.)
  • NOT just default blue/gray themes
  • 3-5 colors with high contrast
  • Choose clean fonts: Sans-serif, large sizes (24pt+ body)
  • Plan visual elements: What images, diagrams, icons for each slide?
  • Create varied layouts: Mix full-figure, two-column, text-overlay (not all bullets)
  • Design section dividers: Visual breaks with striking graphics
  • Plan animations/builds: Control information flow for complex slides
  • Add visual interest: Background images, color blocks, shapes, icons
Raw lines 55 to 83
84### Stage 3: Content Development
86**Populate Slides** (Visual-First Strategy):
871. **Start with visuals**: Plan which figures, images, diagrams for each key point
882. **Use research-lookup extensively**: Find 8-15 papers for proper citations
893. **Create visual backbone first**: Add all figures, charts, images, diagrams
904. **Add minimal text as support**: Bullet points complement visuals, don't replace them
915. **Design section dividers**: Visual breaks with images or graphics (not just text)
926. **Polish title/closing**: Make visually striking, include contact info
937. **Add transitions/builds**: Control information flow
95**VISUAL CONTENT REQUIREMENTS** (Make Slides Engaging):
96- **Images**: Use high-quality photos, illustrations, conceptual graphics
97- **Icons**: Visual representations of concepts (not decoration)
98- **Diagrams**: Flowcharts, schematics, process diagrams
99- **Figures**: Simplified research figures with LARGE labels (18-24pt)
100- **Charts**: Clean data visualizations with clear messages
101- **Graphics**: Visual metaphors, conceptual illustrations
102- **Color blocks**: Use colored shapes to organize content visually
103- Target: MINIMUM 1-2 strong visual elements per slide
105**Scientific Content** (Research-Backed):
106- **Citations**: Use research-lookup EXTENSIVELY to find relevant papers
107 - Introduction: Cite 3-5 papers establishing context and gap
108 - Background: Show key prior work visually (not just cite)
109 - Discussion: Cite 3-5 papers for comparison with your results
110 - Use author-year format (Smith et al., 2023) for readability
111 - Citations establish credibility and scientific rigor
112- **Figures**: Simplified from papers, LARGE labels (18-24pt minimum)
113- **Equations**: Large, clear, explain each term (use sparingly)
114- **Tables**: Minimal, highlight key comparisons (not data dumps)
115- **Code/Algorithms**: Use syntax highlighting, keep brief
117**Text Guidelines** (Less is More):
118- Bullet points, NEVER paragraphs
119- 3-4 bullets per slide (max 6 only if essential)
120- 4-6 words per bullet (shorter than 6×6 rule)
121- Key terms in bold
122- Text is SUPPORTING ROLE, visuals are stars
123- Use builds to control pacing

Stage 3: Content Development

Populate Slides (Visual-First Strategy):

  1. Start with visuals: Plan which figures, images, diagrams for each key point
  2. Use research-lookup extensively: Find 8-15 papers for proper citations
  3. Create visual backbone first: Add all figures, charts, images, diagrams
  4. Add minimal text as support: Bullet points complement visuals, don't replace them
  5. Design section dividers: Visual breaks with images or graphics (not just text)
  6. Polish title/closing: Make visually striking, include contact info
  7. Add transitions/builds: Control information flow

VISUAL CONTENT REQUIREMENTS (Make Slides Engaging):

  • Images: Use high-quality photos, illustrations, conceptual graphics
  • Icons: Visual representations of concepts (not decoration)
  • Diagrams: Flowcharts, schematics, process diagrams
  • Figures: Simplified research figures with LARGE labels (18-24pt)
  • Charts: Clean data visualizations with clear messages
  • Graphics: Visual metaphors, conceptual illustrations
  • Color blocks: Use colored shapes to organize content visually
  • Target: MINIMUM 1-2 strong visual elements per slide

Scientific Content (Research-Backed):

  • Citations: Use research-lookup EXTENSIVELY to find relevant papers
  • Introduction: Cite 3-5 papers establishing context and gap
  • Background: Show key prior work visually (not just cite)
  • Discussion: Cite 3-5 papers for comparison with your results
  • Use author-year format (Smith et al., 2023) for readability
  • Citations establish credibility and scientific rigor
  • Figures: Simplified from papers, LARGE labels (18-24pt minimum)
  • Equations: Large, clear, explain each term (use sparingly)
  • Tables: Minimal, highlight key comparisons (not data dumps)
  • Code/Algorithms: Use syntax highlighting, keep brief

Text Guidelines (Less is More):

  • Bullet points, NEVER paragraphs
  • 3-4 bullets per slide (max 6 only if essential)
  • 4-6 words per bullet (shorter than 6×6 rule)
  • Key terms in bold
  • Text is SUPPORTING ROLE, visuals are stars
  • Use builds to control pacing
Raw lines 84 to 124
125### Stage 4: Visual Validation
127**Generate Images**:
128```bash
129# PowerPoint decks: export to PDF first (Beamer already produces one)
130soffice --headless --convert-to pdf presentation.pptx
132# Convert PDF to images
133python scripts/pdf_to_images.py presentation.pdf review/slides
134```
136**Systematic Review**:
1371. View each slide image
1382. Check against issue checklist
1393. Document problems with slide numbers
1404. Test readability from distance (view at 50% size)
142**Common Issues to Fix**:
143- Text extending beyond boundaries
144- Figures overlapping with text
145- Font sizes too small
146- Poor contrast
147- Misalignment
149**Iteration**:
1501. Fix identified issues in source
1512. Regenerate PDF/presentation
1523. Convert to images again
1534. Re-inspect
1545. Repeat until clean

Stage 4: Visual Validation

Generate Images:

# PowerPoint decks: export to PDF first (Beamer already produces one)
soffice --headless --convert-to pdf presentation.pptx

# Convert PDF to images
python scripts/pdf_to_images.py presentation.pdf review/slides

Systematic Review:

  1. View each slide image
  2. Check against issue checklist
  3. Document problems with slide numbers
  4. Test readability from distance (view at 50% size)

Common Issues to Fix:

  • Text extending beyond boundaries
  • Figures overlapping with text
  • Font sizes too small
  • Poor contrast
  • Misalignment

Iteration:

  1. Fix identified issues in source
  2. Regenerate PDF/presentation
  3. Convert to images again
  4. Re-inspect
  5. Repeat until clean
Raw lines 125 to 155
Runs code python scripts/pdf_to_images.py :133
156### Stage 5: Practice and Refinement
158**Practice Schedule**:
159- Run 1: Rough draft (will run long)
160- Run 2: Smooth transitions
161- Run 3: Exact timing
162- Run 4: Final polish
163- Run 5+: Maintenance (day before, morning of)
165**What to Practice**:
166- Full talk with timer
167- Difficult explanations
168- Transitions between sections
169- Opening and closing (until flawless)
170- Anticipated questions
172**Refinement Based on Practice**:
173- Cut slides if running over
174- Expand explanations if unclear
175- Adjust wording for clarity
176- Mark timing checkpoints
177- Prepare backup slides

Stage 5: Practice and Refinement

Practice Schedule:

  • Run 1: Rough draft (will run long)
  • Run 2: Smooth transitions
  • Run 3: Exact timing
  • Run 4: Final polish
  • Run 5+: Maintenance (day before, morning of)

What to Practice:

  • Full talk with timer
  • Difficult explanations
  • Transitions between sections
  • Opening and closing (until flawless)
  • Anticipated questions

Refinement Based on Practice:

  • Cut slides if running over
  • Expand explanations if unclear
  • Adjust wording for clarity
  • Mark timing checkpoints
  • Prepare backup slides
Raw lines 156 to 178
179### Stage 6: Final Preparation
181**Technical Checks**:
182- [ ] Multiple copies saved (laptop, cloud, USB)
183- [ ] Works on presentation computer
184- [ ] Adapters/cables available
185- [ ] Backup PDF version
186- [ ] Tested with projector (if possible)
188**Content Final**:
189- [ ] No typos or errors
190- [ ] All figures high quality
191- [ ] Slide numbers correct
192- [ ] Contact info on final slide
193- [ ] Backup slides ready
195**Delivery Prep**:
196- [ ] Notes prepared (if using)
197- [ ] Timer/phone ready
198- [ ] Water available
199- [ ] Business cards/handouts
200- [ ] Comfortable with material (3+ practices)

Stage 6: Final Preparation

Technical Checks:

  • [ ] Multiple copies saved (laptop, cloud, USB)
  • [ ] Works on presentation computer
  • [ ] Adapters/cables available
  • [ ] Backup PDF version
  • [ ] Tested with projector (if possible)

Content Final:

  • [ ] No typos or errors
  • [ ] All figures high quality
  • [ ] Slide numbers correct
  • [ ] Contact info on final slide
  • [ ] Backup slides ready

Delivery Prep:

  • [ ] Notes prepared (if using)
  • [ ] Timer/phone ready
  • [ ] Water available
  • [ ] Business cards/handouts
  • [ ] Comfortable with material (3+ practices)
Raw lines 179 to 200