q-presentations — AI-Powered Slide Deck Generator

Usage

/q-presentations path/to/content.md
/q-presentations path/to/content.md --style sketch-notes
/q-presentations path/to/content.md --audience executives
/q-presentations path/to/content.md --lang zh
/q-presentations path/to/content.md --slides 10
/q-presentations path/to/content.md --outline-only
/q-presentations  # Then paste content

Script Directory

1. Determine this SKILL.md file's directory path as

   SKILL_DIR

2. Script path =

   ${SKILL_DIR}/scripts/<script-name>

scripts/gen_slide.py

scripts/overlay_logo.py

scripts/merge_slides.py

scripts/merge-to-pptx.ts

scripts/merge-to-pdf.ts

Options

--style <name>

custom

--audience <type>

--lang <code>

--slides <number>

--outline-only

--prompts-only

--images-only

--regenerate <N>

--regenerate 3

--regenerate 2,5,8

--logo <position>

--video-overlay <side>

Style System

Presets

blueprint

chalkboard

corporate

minimal

sketch-notes

watercolor

dark-atmospheric

notion

bold-editorial

editorial-infographic

fantasy-animation

intuition-machine

pixel-art

scientific

vector-illustration

vintage

Style Dimensions

references/dimensions/*.md

Auto Style Selection

sketch-notes

chalkboard

blueprint

vector-illustration

intuition-machine

minimal

notion

corporate

bold-editorial

dark-atmospheric

editorial-infographic

fantasy-animation

pixel-art

scientific

vintage

watercolor

blueprint

Design Philosophy

• Each slide self-explanatory without verbal commentary
• Logical flow when scrolling
• All necessary context within each slide
• Optimized for social media sharing

references/design-guidelines.md

• Audience-specific principles
• Visual hierarchy
• Content density guidelines
• Color and typography selection
• Font recommendations

references/layouts.md

Organic Positioning Principle

references/organic-positioning.md

• Per-slide

  // VISUAL

  paragraphs describe where content IS using natural spatial words
• Never include a global

  ## CONTENT PLACEMENT

  section in prompts
• Never mention empty space, reserved zones, or percentages
• Never tell the image generator what NOT to put somewhere
• Background spec in

  STYLE_INSTRUCTIONS

  is 1-2 lines max — never add Uniformity sub-sections or per-slide background reminders
• The less you say about the background, the more consistent it will be

File Management

Output Directory

slide-deck/{topic-slug}/
├── source-{slug}.{ext}
├── outline.md
├── prompts/
│   └── 01-slide-cover.md, 02-slide-{slug}.md, ...
├── 01-slide-cover.png, 02-slide-{slug}.png, ...
├── {topic-slug}.pptx
└── {topic-slug}.pdf

intro-machine-learning

Language Handling

1. --lang

   flag (explicit)
2. EXTEND.md

   language

   setting
3. User's conversation language (input language)
4. Source content language

• Questions and confirmations
• Progress reports
• Error messages
• Completion summaries

Workflow

Slide Deck Progress:
- [ ] Step 0: Skill announcement (first run only)
- [ ] Step 1: Setup & Analyze
  - [ ] 1.1 Load preferences
  - [ ] 1.2 Analyze content
  - [ ] 1.3 Check existing
- [ ] Step 2: Confirmation (Round 1 + optional Round 2 + q-presentations questions)
- [ ] Step 3: Generate outline
- [ ] Step 4: Review outline (conditional)
- [ ] Step 5: Generate prompts
- [ ] Step 6: Review prompts (conditional)
- [ ] Step 7: Generate images
- [ ] Step 7.5: Logo overlay
- [ ] Step 8: Merge to PPTX/PDF
- [ ] Step 9: Output summary

Flow

Announce → Input → Preferences → Analyze → [Check Existing?] → Confirm (1-2 rounds + positioning) → Outline → [Review?] → Prompts → [Review?] → Images → Logo → Merge → Complete

Step 0: Skill Announcement

q-presentations — AI-powered slide deck generator Built on the foundation of baoyu-slide-deck by baoyu, extended with organic content positioning, smart logo branding, and video-overlay-aware layout.

Ready to create your next presentation.

Step 1: Setup & Analyze

# Check project-level first
test -f .q-skills/q-presentations/EXTEND.md && echo "project"

# Then user-level
test -f "$HOME/.q-skills/q-presentations/EXTEND.md" && echo "user"

.q-skills/q-presentations/EXTEND.md

$HOME/.q-skills/q-presentations/EXTEND.md

references/config/preferences-schema.md

1. Save source content (if pasted, save as

   source.md

   )
   • Backup rule: If

     source.md

     exists, rename to

     source-backup-YYYYMMDD-HHMMSS.md

2. Follow

   references/analysis-framework.md

   for content analysis
3. Analyze content signals for style recommendations
4. Detect source language
5. Determine recommended slide count
6. Generate topic slug from content

test -d "slide-deck/{topic-slug}" && echo "exists"

analysis.md

Step 2: Confirmation

Round 1 (Always) — same as baoyu

1. Style: Recommended preset vs alternatives vs custom dimensions
2. Audience: General / Beginners / Experts / Executives
3. Slide Count: Recommended vs fewer vs more
4. Review Outline: Yes (recommended) / No
5. Review Prompts: Yes (recommended) / No

Round 2 (Only if "Custom dimensions" selected)

q-presentations Questions (Always)

header: "Video"
question: "Where will the video overlay appear in post-production?"
options:
  - label: "Right side (Recommended)"
    description: "Content anchors left/center-left"
  - label: "Left side"
    description: "Content anchors center-right/right"
  - label: "Bottom"
    description: "Content anchors upper area"
  - label: "None"
    description: "Content centered freely, no video overlay"

header: "Logo"
question: "Logo placement?"
options:
  - label: "Top-right (Recommended)"
    description: "Dr. Q logo at top-right corner"
  - label: "Bottom-right"
    description: "Dr. Q logo at bottom-right corner"
  - label: "None"
    description: "No logo overlay"

video_overlay_side

content_anchor

logo_position

Step 3: Generate Outline

• If preset selected → Read

  references/styles/{preset}.md

• If custom dimensions → Read dimension files from

  references/dimensions/

  and combine

1. Follow

   references/outline-template.md

   for structure
2. Build STYLE_INSTRUCTIONS from style or dimensions
3. Apply confirmed audience, language, slide count
4. CRITICAL — Organic Positioning (see

   references/organic-positioning.md

   ):
   • Background in STYLE_INSTRUCTIONS: ONE concise line (Color + Texture). Use "flat" and "edge to edge" for uniformity. No Uniformity sub-section.
   • Per-slide

     // VISUAL

     paragraphs: Describe where content IS using natural spatial words based on the content anchor direction. Never mention empty space, reserved zones, or percentages.
5. Add metadata to outline header:

   **Content Anchor**: [left/right/top/center]
   **Video Overlay**: [right/left/bottom/none]
   **Logo**: [top-right/bottom-right/none]

6. Save as

   outline.md

• If

  --outline-only

  , stop here
• If

  skip_outline_review

  is true → Skip Step 4, go to Step 5
• Otherwise → Continue to Step 4

Step 4: Review Outline (Conditional)

Step 5: Generate Prompts

1. Read

   references/base-prompt.md

2. For each slide in outline:
   • Extract STYLE_INSTRUCTIONS from outline (not from style file again)
   • Add slide-specific content
   • If

     Layout:

     specified, include layout guidance from

     references/layouts.md

   • CRITICAL — Organic Positioning: Copy Background line from STYLE_INSTRUCTIONS exactly (1-2 lines). Do NOT expand into verbose uniformity paragraphs. Do NOT add per-slide "Background must be..." sentences. Do NOT add lists of what to avoid.
3. Save to

   prompts/

   directory
   • Backup rule: If prompt file exists, rename to backup

• If

  --prompts-only

  , stop here
• If

  skip_prompt_review

  is true → Skip Step 6, go to Step 7
• Otherwise → Continue to Step 6

Step 6: Review Prompts (Conditional)

Step 7: Generate Images

--images-only

--regenerate N

1. For each slide:
   • Backup rule: If image file exists, rename to backup
   • Generate image using Python script:
     bash

     python ${SKILL_DIR}/scripts/gen_slide.py <prompt-file> <output-png>

   • Report progress: "Generated X/N" (in user's language)
2. Auto-retry once on failure before reporting error
3. Generate sequentially

Step 7.5: Logo Overlay

python ${SKILL_DIR}/scripts/overlay_logo.py <slide-deck-dir> --position <logo-position> --style <style-name>

• Position comes from Step 2 logo placement answer

• --style

  flag enables auto-invert for dark background styles (technical, storytelling, chalkboard, dark-atmospheric, etc.)
• If logo placement is "none", add

  --skip

  flag

Step 8: Merge to PPTX and PDF

python ${SKILL_DIR}/scripts/merge_slides.py <slide-deck-dir>

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 9: Output Summary

Slide Deck Complete!

Topic: [topic]
Style: [preset name or custom dimensions]
Content Anchor: [direction]
Video Overlay Zone: [side]
Logo: [position]
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

Partial Workflows

--outline-only

--prompts-only

--images-only

--regenerate N

Slide Modification

Quick Reference

--regenerate N

references/modification-guide.md

File Naming

NN-slide-[slug].png

• NN

  : Two-digit sequence (01, 02, ...)

• slug

  : Kebab-case from content (2-5 words, unique)

References

references/analysis-framework.md

references/outline-template.md

references/organic-positioning.md

references/modification-guide.md

references/content-rules.md

references/design-guidelines.md

references/layouts.md

references/base-prompt.md

references/dimensions/*.md

references/dimensions/presets.md

references/styles/<style>.md

references/config/preferences-schema.md

Notes

• Image generation: 10-30 seconds per slide
• Auto-retry once on generation failure
• Use stylized alternatives for sensitive public figures
• Maintain style consistency across all slides
• Step 2 confirmation required — do not skip
• Never include photorealistic images of prominent individuals
• Never include placeholder slides for author name, date, etc.

Extension Support