Slide Deck Generator

Transform content into professional slide deck images with flexible style options.

Usage

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

Script Directory

Important: All scripts are located in the

scripts/

Agent Execution Instructions:

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

   SKILL_DIR

2. Script path =

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

3. Replace all

   ${SKILL_DIR}

   in this document with the actual path

Script Reference:

scripts/merge-to-pptx.ts

scripts/merge-to-pdf.ts

Options

--style <name>

--audience <type>

--lang <code>

--slides <number>

--outline-only

Style Gallery

blueprint

chalkboard

notion

bold-editorial

corporate

dark-atmospheric

editorial-infographic

fantasy-animation

intuition-machine

minimal

pixel-art

scientific

sketch-notes

vector-illustration

vintage

watercolor

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

This deck is designed for reading and sharing, not live presentation:

• Each slide must be self-explanatory without verbal commentary
• Structure content for logical flow when scrolling
• Include all necessary context within each slide
• Optimize for social media sharing and offline reading

File Management

Output Directory

Each session creates an independent directory named by content slug:

slide-deck/{topic-slug}/
├── source-{slug}.{ext}    # Source files (text, images, etc.)
├── outline.md
├── outline-{style}.md     # Style variant outlines
├── prompts/
│   └── 01-slide-cover.md, 02-slide-{slug}.md, ...
├── 01-slide-cover.png, 02-slide-{slug}.png, ...
├── {topic-slug}.pptx
└── {topic-slug}.pdf

Slug Generation:

1. Extract main topic from content (2-4 words, kebab-case)
2. Example: "Introduction to Machine Learning" →

   intro-machine-learning

Conflict Resolution

If

slide-deck/{topic-slug}/

• Append timestamp:

  {topic-slug}-YYYYMMDD-HHMMSS

• Example:

  intro-ml

  exists →

  intro-ml-20260118-143052

Source Files

Copy all sources with naming

source-{slug}.{ext}

• source-article.md

  (main text content)

• source-diagram.png

  (image from conversation)

• source-data.xlsx

  (additional file)

Multiple sources supported: text, images, files from conversation.

Workflow

Step 1: Analyze Content

1. Save source content (if pasted, save as

   source.md

   )
2. Follow

   references/analysis-framework.md

   for deep content analysis
3. Determine style (use

   --style

   or auto-select from signals)
4. Detect languages (source vs. user preference)
5. Plan slide count (

   --slides

   or dynamic)

Step 2: Generate Outline Variants

1. Generate 3 style variant outlines based on content analysis
2. Follow

   references/outline-template.md

   for structure
3. Save as

   outline-{style}.md

   for each variant

Step 3: User Confirmation

Single AskUserQuestion with all applicable options:

After selection:

• Copy selected

  outline-{style}.md

  to

  outline.md

• Regenerate in different language if requested
• User may edit

  outline.md

  for fine-tuning

If

--outline-only

Step 4: Generate Prompts

1. Read

   references/base-prompt.md

2. Combine with style instructions from outline
3. Add slide-specific content
4. Save to

   prompts/

   directory

Step 5: Generate Images

1. Select available image generation skill
2. Generate session ID:

   slides-{topic-slug}-{timestamp}

3. Generate each slide with same session ID
4. Report progress: "Generated X/N"

Step 6: 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 7: 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

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

References

references/analysis-framework.md

references/outline-template.md

references/modification-guide.md

references/content-rules.md

references/base-prompt.md

references/styles/<style>.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 via session ID

Extension Support

Custom styles and configurations via EXTEND.md.

Check paths (priority order):

1. .awkn-skills/awkn-slide-deck/EXTEND.md

   (project)

2. ~/.awkn-skills/awkn-slide-deck/EXTEND.md

   (user)

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