Paper Slide Deck

Step 5: Image Generation Method Selection

Before generating images, ask user to choose generation method:

Use AskUserQuestion with options:

Based on selection:

Option 1: Gemini API (Python)

1. Verify API key: Check GOOGLE_API_KEY or GEMINI_API_KEY environment variable
2. Run generation script:

   python ${SKILL_DIR}/scripts/generate-slides.py <slide-deck-dir> --model gemini-3-pro-image-preview

Script Features:

• Auto-installs google-genai package if missing
• Retry logic with exponential backoff (3 retries)
• Skips already-generated slides (> 10KB)
• Supports custom model via --model flag
• Outputs to slides/ subdirectory

Troubleshooting:

• If server disconnection errors occur, script auto-retries
• For persistent failures, re-run the script (it skips completed slides)
• Check API quota if many failures occur

Option 2: Gemini Web Skill

1. Consent Check: Read consent file at:

   • Windows: $APPDATA/baoyu-skills/gemini-web/consent.json
   • macOS: ~/Library/Application Support/baoyu-skills/gemini-web/consent.json
   • Linux: ~/.local/share/baoyu-skills/gemini-web/consent.json

2. If no consent or version mismatch, display disclaimer and ask:

   ⚠️ DISCLAIMER: This uses a reverse-engineered Gemini Web API (NOT official).
   Risks: May break anytime, no support, possible account risk.

3. For each slide, run:

   npx -y bun ${GEMINI_WEB_SKILL_DIR}/scripts/main.ts \
     --promptfiles prompts/01-slide-cover.md \
     --image 01-slide-cover.png \
     --sessionId slides-{topic-slug}-{timestamp}

   Where GEMINI_WEB_SKILL_DIR = path to baoyu-danger-gemini-web skill directory.

4. Proxy support: If user is in restricted network, prepend:

   HTTP_PROXY=http://127.0.0.1:7890 HTTPS_PROXY=http://127.0.0.1:7890

Step 5.5: Process IMAGE_SOURCE (Automatic Figure Extraction)

For academic presentations, IMAGE_SOURCE metadata was auto-populated in Step 2 based on figure detection from Step 1.

Automatic Execution:

1. Parse outline to identify slides with Source: extract

2. Create figures directory: mkdir -p figures

3. For each extract slide, automatically:

   • Read the Figure number, Page, and Caption from metadata
   • Run figure extraction script:

     npx -y bun ${SKILL_DIR}/scripts/extract-figure.ts \
       --pdf source-paper.pdf \
       --page <page-number> \
       --output figures/figure-<N>.png

   • Run template application script:

     npx -y bun ${SKILL_DIR}/scripts/apply-template.ts \
       --figure figures/figure-<N>.png \
       --title "<slide-headline>" \
       --caption "Figure <N>: <caption-text>" \
       --output <NN>-slide-<slug>.png

   • Report: "Extracted: Figure N → slide NN"

4. For slides with Source: generate (or no IMAGE_SOURCE):

   • Proceed to Step 6 for AI generation

Note: Source PDF must be saved as source-paper.pdf in output directory.

Troubleshooting:

• If figure detection missed a figure: manually add // IMAGE_SOURCE block to outline
• If wrong figure mapped: edit the Figure: and Page: values in outline
• If extraction fails: check PDF page number (1-indexed)

PyMuPDF Fallback for Page Extraction: If extract-figure.ts fails with "Image or Canvas expected" error (common with complex PDFs), use PyMuPDF:

import fitz
doc = fitz.open("source-paper.pdf")
page = doc[page_num - 1]  # 0-indexed
mat = fitz.Matrix(3, 3)  # 3x scale for high resolution
pix = page.get_pixmap(matrix=mat)
pix.save(f"extracted/page-{page_num}.png")

Then apply template using apply-template.ts.

Step 6: Generate Images

1. Use selected method from Step 5
2. Skip slides already processed in Step 5.5 (those with Source: extract)
3. Generate session ID: slides-{topic-slug}-{timestamp}
4. Generate each remaining slide with same session ID
5. Report progress: "Generated X/N"
6. Auto-retry once on generation failure

Step 7: Merge to PPTX and PDF

npx -y bun ${SKILL_DIR}/scripts/merge-to-pptx.ts <slide-deck-dir>
npx -y bun ${SKILL_DIR}/scripts/merge-to-pdf.ts <slide-deck-dir>

Step 8: Output Summary

Slide Deck Complete!

Topic: [topic]
Style: [style name]
Location: [directory path]
Slides: N total

- 01-slide-cover.png ✓ Cover
- 02-slide-intro.png ✓ Content
- ...
- {NN}-slide-back-cover.png ✓ Back Cover

Outline: outline.md
PPTX: {topic-slug}.pptx
PDF: {topic-slug}.pdf

Slide Modification

See references/modification-guide.md for:

• Edit single slide workflow
• Add new slide (with renumbering)
• Delete slide (with renumbering)
• File naming conventions

Image Generation Dependencies

Gemini API (Option 1 - Recommended)

Requires:

• GOOGLE_API_KEY or GEMINI_API_KEY environment variable
• Python 3.8+ with pip
• google-genai package (auto-installed by script)

Model: gemini-3-pro-image-preview (default)

Gemini Web Skill (Option 2)

Requires:

• baoyu-danger-gemini-web skill installed at .claude/skills/baoyu-danger-gemini-web
• Google Chrome browser with logged-in Google account
• User consent for reverse-engineered API disclaimer

PDF Figure Extraction

Requires:

• Primary: pdfjs-dist npm package (use legacy build for Node.js)
• Fallback: pymupdf Python package (more reliable for complex PDFs)
• canvas npm package for apply-template.ts

References

Notes

Image Generation

• Nano Banana Pro API: Recommended. Stable, reliable, requires API key
• Gemini Web: No API key needed, but uses reverse-engineered API with account risk
• Generation time: 10-30 seconds per slide
• Auto-retry once on generation failure
• Maintain style consistency via session ID

Content Guidelines

• Use stylized alternatives for sensitive public figures
• Both methods use the same underlying Gemini model for image generation

Extension Support

Custom styles and configurations via EXTEND.md.

Check paths (priority order):

1. .paper-skills/paper-slide-deck/EXTEND.md (project)
2. ~/.paper-skills/paper-slide-deck/EXTEND.md (user)

If found, load before Step 1. Extension content overrides defaults.