Deck Generator

Documents

deck-generator

Deck Generator is an Agent Skill for documents published in the ericosiu/ai-marketing-skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Generate professional presentations with AI-generated images. Use when asked to create a deck, presentation, pitch deck, or slides. Supports style presets (whiteboard, corporate, minimalist, etc). Uses Imagen 4.0 API for image generation and Google Slides API for assembly. Produces full decks from markdown content specs in minutes.

View on GitHub ↗

QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

Open your project in Codex.
Copy and paste the prompt below.
Review files and risks before approving any action.

Prompt to paste

Inspect the Agent Skill at https://github.com/ericosiu/ai-marketing-skills/blob/HEAD/deck-generator/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/deck-generator, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Deck Generator

Generate complete presentations where every slide is an AI-generated image in a consistent visual style.

Quick Start

Read the content spec (user provides slide content or a markdown file)
Read references/styles.md to pick or customize a visual style
Run scripts/generate-deck.py with content + style

Workflow

Step 1: Content Spec

Accept slide content in any format. Normalize to this structure per slide:

Title: Bold headline
Body: Key points, stats, or narrative
Visual cues: Icons, diagrams, layouts described in words

If user provides a markdown file with --- separators, parse each section as a slide. If user provides a topic only, generate 10-14 slides following standard deck structures.

Step 2: Style Selection

Available style presets:

Style	Description
`whiteboard`	Hand-drawn sketch on white. Black ink, orange accents.
`corporate`	Navy/white/gold. Clean sans-serif. Professional.
`minimalist`	Pure white, electric blue accent. Maximum negative space.
`dark-tech`	Near-black background, neon green. Terminal aesthetic.
`playful`	Bright pastels, rounded shapes. Modern startup vibe.
`editorial`	Black/white with red spot color. Magazine aesthetic.

Default: whiteboard. User can specify any preset or describe a custom style.

Step 3: Generate

# Set your API key
export GEMINI_API_KEY="your-gemini-api-key"

# Run the generator
python3 scripts/generate-deck.py \
  --content slides.json \
  --style whiteboard \
  --title "Deck Title" \
  [--output-dir ./output] \
  [--aspect 16:9]

The script:

Generates each slide image via Imagen 4.0 API
Saves all images to the output directory
Optionally creates a Google Slides presentation (requires Google Slides API credentials)
Returns paths to all generated images

Step 4: Review & Iterate

To regenerate individual slides:

python3 scripts/generate-deck.py \
  --content slides.json \
  --style whiteboard \
  --slides 3,7 \
  --output-dir ./output

Key Details

Cost: ~4 cents per image. A 14-slide deck costs roughly 56 cents in API calls.
Speed: ~2 minutes for 14 slides.
API: Imagen 4.0 via Google's Generative Language API
Auth: Set $GEMINI_API_KEY environment variable
Aspect ratios: 16:9 (default), 1:1, 4:3, 3:4, 9:16
Image models: imagen-4.0-generate-001 (best quality), imagen-4.0-fast-generate-001 (faster)

Content JSON Format

[
  {"name": "01-title", "prompt": "Title slide: 'Your Deck Title' with company logo placeholder"},
  {"name": "02-problem", "prompt": "Problem slide showing frustrated marketer staring at dashboard with declining metrics"},
  {"name": "03-solution", "prompt": "Solution slide: AI agent workflow diagram with 3 connected boxes"}
]

Google Slides Integration (Optional)

To automatically create a Google Slides presentation, set up Google Slides API credentials:

export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account.json"
python3 scripts/generate-deck.py \
  --content slides.json \
  --style whiteboard \
  --title "My Deck" \
  --google-slides \
  --google-account [email protected]