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

• 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

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

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

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.

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

• 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

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

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

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

NN-slide-[slug].png

• NN

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

• slug

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

• 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.