tyrealq/q-skills/q-presentations

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:

1. Determine this SKILL.md file's directory path as SKILL_DIR.
2. Script path = ${SKILL_DIR}/scripts/<script-name>.

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

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.