undefined

**Step 2: Generate Each Slide**

Use the `generate_slide_image.py` script to create each slide.

**CRITICAL: Formatting Consistency Protocol**

To ensure unified formatting across all slides in a presentation:

1. **Define a Formatting Goal** at the start of your presentation and include it in EVERY prompt:
   - Color scheme (e.g., "dark blue background, white text, gold accents")
   - Typography style (e.g., "bold sans-serif titles, clean body text")
   - Visual style (e.g., "minimal, professional, corporate aesthetic")
   - Layout approach (e.g., "generous white space, left-aligned content")

2. **Always attach the previous slide** when generating subsequent slides using `--attach`:
   - This allows Nano Banana Pro to see and match the existing style
   - Creates visual continuity throughout the deck
   - Ensures consistent colors, fonts, and design language

3. **Default author is "K-Dense"** unless another name is specified

4. **Include citations directly in the prompt** for slides that reference research:
   - Add citations in the prompt text so they appear on the generated slide
   - Use format: "Include citation: (Author et al., Year)" or "Show reference: Author et al., Year"
   - For multiple citations, list them all in the prompt
   - Citations should appear in small text at the bottom of the slide or near relevant content

5. **Attach existing figures/data for results slides** (CRITICAL for data-driven presentations):
   - When creating slides about results, ALWAYS check for existing figures in:
     - The working directory (e.g., `figures/`, `results/`, `plots/`, `images/`)
     - User-provided input files or directories
     - Any data visualizations, charts, or graphs relevant to the presentation
   - Use `--attach` to include these figures so Nano Banana Pro can incorporate them:
     - Attach the actual data figure/chart for results slides
     - Attach relevant diagrams for methodology slides
     - Attach logos or institutional images for title slides
   - When attaching data figures, describe what you want in the prompt:
     - "Create a slide presenting the attached results chart with key findings highlighted"
     - "Build a slide around this attached figure, add title and bullet points explaining the data"
     - "Incorporate the attached graph into a results slide with interpretation"
   - **Before generating results slides**: List files in the working directory to find relevant figures
   - Multiple figures can be attached: `--attach fig1.png --attach fig2.png`

**Example with formatting consistency, citations, and figure attachments:**

```bash

**IMPORTANT: Before creating results slides, always:**
1. List files in working directory: `ls -la figures/` or `ls -la results/`
2. Check user-provided directories for relevant figures
3. Attach ALL relevant figures that should appear on the slide
4. Describe how Nano Banana Pro should incorporate the attached figures

**Prompt Template:**

Include these elements in every prompt (customize as needed):

**Step 3: Combine to PDF**

```bash

undefined

undefined

**Step 2: Build PowerPoint with PPTX Skill**

Use the PPTX skill's html2pptx workflow to create slides that include:
- Generated images from step 1
- Title and body text added separately
- Professional layout and formatting

See `document-skills/pptx/SKILL.md` for complete PPTX creation documentation.

---

undefined

**Options:**
- `-o, --output`: Output file path (required)
- `--attach IMAGE`: Attach image file(s) as context for generation (can use multiple times)
- `--visual-only`: Generate just the visual/figure, not a complete slide
- `--iterations`: Max refinement iterations (default: 2)
- `--api-key`: OpenRouter API key (or set OPENROUTER_API_KEY env var)
- `-v, --verbose`: Verbose output

**Attaching Reference Images:**

Use `--attach` when you want Nano Banana Pro to see existing images as context:
- "Create a slide about this data" + attach the data chart
- "Make a title slide with this logo" + attach the logo
- "Combine these figures into one slide" + attach multiple images
- "Explain this diagram in a slide" + attach the diagram

**Environment Setup:**
```bash
export OPENROUTER_API_KEY='your_api_key_here'

undefined

undefined

**Options:**
- `-o, --output`: Output PDF path (required)
- `--dpi`: PDF resolution (default: 150)
- `-v, --verbose`: Verbose output

**Tip:** Name slides with numbers for correct ordering: `01_title.png`, `02_intro.png`, etc.

---

Title slide:
"Title slide for a medical research presentation. Title: 'Advances in Cancer Immunotherapy'. Subtitle: 'Clinical Trial Results 2024'. Professional medical theme with subtle DNA helix in background. Navy blue and white color scheme."

Content slide:
"Presentation slide titled 'Key Findings'. Three bullet points: 1) 40% improvement in response rate, 2) Reduced side effects, 3) Extended survival outcomes. Include relevant medical icons. Clean, professional design with green and white colors."

Diagram slide:
"Presentation slide showing the research methodology. Title: 'Study Design'. Flowchart showing: Patient Screening → Randomization → Treatment Groups (A, B, Control) → Follow-up → Analysis. CONSORT-style flow diagram. Professional academic style."

"Flowchart showing machine learning pipeline: Data Collection → Preprocessing → Model Training → Validation → Deployment. Clean technical style, blue and gray colors."

"Conceptual illustration of cloud computing with servers, data flow, and connected devices. Modern flat design, suitable for business presentation."

"Scientific diagram of cell division process showing mitosis phases. Educational style with labels, colorblind-friendly colors."

python scripts/generate_schematic.py "your diagram description" -o figures/output.png

undefined

**Advantages**:
- Most visually impressive results
- Fast creation (describe and generate)
- No design skills required
- Consistent, professional appearance
- Perfect for general audiences

**Best for**:
- Conference talks
- Business presentations
- General scientific talks
- Pitch presentations

undefined

**Step 3: Systematic Inspection**

Check each slide for:
- **Text overflow**: Text cut off at edges
- **Element overlap**: Text overlapping images or other text
- **Font sizes**: Text too small (<18pt)
- **Contrast**: Insufficient contrast between text and background
- **Layout issues**: Misalignment, poor spacing
- **Visual quality**: Pixelated images, poor rendering

**Step 4: Document Issues**

Create issue log:

**Step 5: Apply Fixes**

Make corrections to source files:
- PowerPoint: Edit text boxes, resize elements
- Beamer: Adjust LaTeX code, recompile

**Step 6: Re-Validate**

Repeat Steps 1-5 until no critical issues remain.

**Stopping Criteria**:
- No text overflow
- No inappropriate overlaps
- All text readable (≥18pt equivalent)
- Adequate contrast (≥4.5:1)
- Professional appearance

undefined

**Manual Validation Checklist**:
- [ ] Slide count appropriate for duration
- [ ] Title slide complete (name, affiliation, date)
- [ ] Clear narrative flow
- [ ] One main idea per slide
- [ ] Font sizes ≥18pt (preferably 24pt+)
- [ ] High contrast colors
- [ ] Figures large and readable
- [ ] No text overflow or element overlap
- [ ] Consistent design throughout
- [ ] Slide numbers present
- [ ] Contact info on final slide
- [ ] Backup slides prepared
- [ ] Tested on projector (if possible)

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.

undefined

**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

undefined

**slides_to_pdf.py** - Combine slide images into PDF:
```bash

undefined

python scripts/validate_presentation.py presentation.pdf --duration 15

**pdf_to_images.py**:
```bash
python scripts/pdf_to_images.py presentation.pdf output/slide --dpi 150

undefined