tyrealq Q-Presentations
Generate slide deck images from content with layout-driven overlay safety and smart logo branding. Built on baoyu-slide-deck.
If in plan mode: write a brief plan — "Run q-presentations skill: analyze content, confirm style/audience preferences, generate outline and prompts, generate slide images, overlay logo, merge to PPTX/PDF." — then exit plan mode immediately. Do NOT attempt content analysis, image generation, or file merging while plan mode is active.
Script Directory
Agent execution instructions:
- Determine this SKILL.md file's directory path as
SKILL_DIR. - Script path =
${SKILL_DIR}/scripts/<script-name>.
| Script | Purpose |
|---|---|
scripts/gen_slide.py |
Generate slide images via GPT Image 2 (default) or Gemini |
scripts/overlay_logo.py |
Apply Dr. Q logo overlay |
scripts/merge-to-pptx.ts |
Merge slides into PowerPoint (Bun/TS) |
scripts/merge-to-pdf.ts |
Merge slides into PDF (Bun/TS) |
Dependencies
Install: pip install openai google-genai Pillow python-dotenv | Bun runtime (via npx -y bun, Node.js 18+).
Default image model is gpt-image-2 (requires OPENAI_API_KEY). Set IMAGE_MODEL=gemini or pass --model gemini to gen_slide.py to use gemini-3-pro-image-preview (requires GEMINI_API_KEY).
References
- references/options.md — CLI options, usage examples, and partial workflows
- references/workflow_detailed.md — full 10-step workflow with substeps and commands
- references/analysis-framework.md — content analysis for presentations
- references/outline-template.md — outline structure and format
- references/modification-guide.md — edit, add, delete slide workflows
- references/content-rules.md — content and style guidelines
- references/design-guidelines.md — audience, typography, colors, visual elements
- references/layouts.md — layout catalog, overlay-safe policy, fallback rules
- references/base-prompt.md — base prompt for image generation
- references/dimensions/presets.md — preset-to-dimension mapping
- references/styles/*.md — per-style specifications
- references/config/preferences-schema.md — EXTEND.md structure
Core Principles
- Each slide self-explanatory (designed for reading and sharing, not only presenting)
- Flow clear in scroll view; context present on each slide
- Consistent style across the full deck
- Never include photorealistic images of prominent individuals
- Never include placeholder slides for author/date metadata
Style System
16 presets available (default: blueprint). Full specs in references/dimensions/presets.md and references/styles/*.md.
Workflow
Full step details: references/workflow_detailed.md
| Step | Action | Key references |
|---|---|---|
| 0 | Skill announcement | — |
| 1 | Analyze content, load EXTEND.md preferences | references/analysis-framework.md, references/config/preferences-schema.md |
| 2 | Confirm style, audience, video overlay, logo | references/options.md |
| 3 | Generate outline with layout selection | references/outline-template.md, references/layouts.md |
| 4 | Review outline (conditional) | — |
| 5 | Generate per-slide prompts | references/base-prompt.md, references/content-rules.md |
| 6 | Review prompts (conditional) | — |
| 7 | Generate slide images | scripts/gen_slide.py |
| 7.5 | Logo overlay | scripts/overlay_logo.py |
| 8 | Merge to PPTX/PDF | scripts/merge-to-pptx.ts, scripts/merge-to-pdf.ts |
| 9 | Output summary | — |
For editing existing decks: references/modification-guide.md. For audience and visual hierarchy: references/design-guidelines.md.
File Management
Output directory: slide-deck/{topic-slug}/ containing source-{slug}.{ext}, outline.md, prompts/ (numbered .md files), numbered slide .png files, {topic-slug}.pptx, and {topic-slug}.pdf.
Language Handling
Detection priority: --lang flag > EXTEND.md > user conversation language > source content language. All user-facing responses use the user's preferred language; technical names remain in English.
Scope
Include: Slide deck generation from content with logo branding and video-overlay-aware layouts. Exclude: Slide editing in PowerPoint, animation, speaker notes.
Checklist
- Style and audience confirmed with user
- Layout selection compatible with video_overlay_side
- Logo overlay applied (or explicitly set to none)
- PPTX and PDF outputs generated
- Output summary displayed to user