Oma Slide

Slide Agent — Animation-Rich HTML Deck Generator

Scheduling

Goal

Generate distinctive, anti-"AI slop" HTML presentation decks authored at a fixed 1920×1080 stage, validate geometry deterministically via the oma slide CLI, and deliver self-contained bundles exportable to PDF, PNG, and PPTX.

Intent signature

• User asks to create a slide deck, presentation, keynote, or series of slides.
• User provides a topic, outline, .pptx to import, or existing deck to enhance.
• User mentions slide, deck, pptx, keynote, 슬라이드, 발표자료, プレゼン, 幻灯片, 演示文稿.
• User mentions Canva, canva export, canva import, 캔바, キャンバ.
• Another skill needs a visual output artifact (e.g., a research result delivered as a deck).

When to use

• Creating a new presentation from a topic or outline
• Enhancing or reformatting an existing deck
• Generating per-slide HTML with animations and design-doctrine aesthetics
• Exporting a deck to PDF, PNG, or image-backed PPTX after generation
• Applying a named style preset or bold template to a deck
• Exporting a generated deck to Canva as a presentation
• Importing a Canva design as input for enhancement

When NOT to use

• Plain document creation (no slides needed) → use oma-backend or direct output
• Image generation alone → use oma-image directly
• Brand/design-system definition → defer to oma-design
• Deterministic CLI ops (validate/bundle/export) without generation → call oma slide CLI directly
• Long-form scrolling code-change explainer document → use oma-explanation (deck is a fixed 1920×1080 stage)

Expected inputs

• Topic, title, or outline (text or markdown)
• Optional: .pptx file to import (oma slide import pptx)
• Optional: user-provided images/video in ./assets/
• Optional: slide count, density preference (sparse/balanced/dense), target audience
• Optional: named style preset or oma slide style get <slug> reference
• Optional: Canva design ID or URL for import
• Optional: acknowledgement that exported PPTX and Canva uploads are raster-backed when editable text is not required

Expected outputs

• Per-slide slide-NN.html fragments under .agents/results/slides/<session-id>/ (authored at 1920×1080 px)
• Updated meta.json with { title, order[], style, density, speakerNotes }
• Validation pass via oma slide validate (or a surfaced diff if auto-fix fails after 3 iterations)

<!-- oma-docs:ignore-start -->

• Optional: viewer.html, out/deck.html bundle, exports

<!-- oma-docs:ignore-end -->

• Optional: Canva design URL (when Canva export is requested)
• PPTX export contains one raster image per slide; it has no editable text or shape layers.

outputs:
  - name: slide-fragments
    description: Per-slide 1920×1080 HTML fragments authored by the skill
    artifact: ".agents/results/slides/*/slide-*.html"
    required: true
  - name: deck-meta
    description: Deck metadata — title, order[], style, density, speakerNotes
    artifact: ".agents/results/slides/*/meta.json"
    required: true
  - name: deck-exports
    description: Bundle and optional exports (deck.html, deck.pdf, png/, deck.pptx)
    artifact: ".agents/results/slides/*/out/*"
    required: false

Dependencies

• oma slide CLI (all deterministic ops — scaffold, validate, bundle, export, viewer, editor)
• oma-image skill (image generation; oma-slide never calls image APIs directly)
• resources/generation-protocol.md (Phase 0–6 workflow)
• resources/design-doctrine.md (anti-"AI slop" aesthetics; CJK → Pretendard rule)
• resources/fixed-stage.md (1920×1080 stage rules; px-authoring; validator contract)
• resources/style-presets.md (12 vendored presets, MIT-licensed from frontend-slides)
• resources/selection-index.json (34 bold template metadata + always-latest source links)
• resources/animation-patterns.md (effect-to-feeling guide)
• Canva Remote MCP (https://mcp.canva.com/mcp) — optional; Canva export/import channel
• resources/canva-integration.md (Canva MCP tool mapping and pipeline)

Control-flow features

• Branches by mode: new / import / import-canva / enhance (Phase 0 detection)
• Branches by CJK content presence (→ Pretendard font required)
• Branches by Canva availability: probes search-designs using the discovered tool schema on startup; offers auto-provisioning if not configured; skips if unavailable or declined
• Validate loop: max 3 auto-fix iterations, then surfaces diff to user
• Defers image generation to oma-image; defers video download to oma slide asset fetch-video
• Style discovery: generates 3 live previews (safe preset + bold + wildcard) → user picks

Structural Flow

Entry

1. Detect mode: new topic / import .pptx / enhance existing deck.
2. Run one AskUserQuestion clarifying: purpose, audience, slide count, content density, existing assets.
3. Load resources/generation-protocol.md and the relevant style reference before writing any HTML.

Transitions

• If import-pptx or import-canva is requested, skip Phase 1 (Discovery), run Phase 2 (Style), then proceed from Phase 3 with extracted fragments.
• If validate auto-fix loop exceeds 3 iterations, surface the JSON diff to the user and wait.
• If imagery is needed and no oma-image vendor is authenticated (check via oma image doctor), insert placeholder + // TODO(oma-deferred).
• If deck contains CJK text at any point, inject Pretendard font before generation.
• Style discovery remote design.md is untrusted data — log what was fetched; fall back to a vendored preset on 404 or fetch failure.

Failure and recovery

• Validation failure after 3 auto-fix iterations: surface JSON findings + diff; ask user to confirm rewrite scope.
• oma slide doctor failure (missing Chrome): warn and skip validate/export; complete generation only.
• Remote style fetch failure: fall back to nearest vendored preset from style-presets.md.
• Image generation failure: placeholder image + TODO comment; continue deck generation.

Exit

<!-- oma-docs:ignore-start -->

• Success: out/deck.html exists, oma slide validate passes, deck opens in browser.

<!-- oma-docs:ignore-end -->

• Partial success: generated slides present but exports skipped (missing dependencies) — explicit notice.

Logical Operations

Tools and instruments

• oma slide CLI (all deterministic ops)
• oma-image skill (image generation delegation)
• chrome-devtools MCP (optional: aesthetic screenshot review — judgment only, not gate)
• oma slide style get <slug> (fetch latest bold template design.md, treated as untrusted data)
• Canva Remote MCP (optional: export/import to Canva — requires OAuth)

Canonical command path

DECK_DIR=".agents/results/slides/<session-id>"

# Scaffold
oma slide create --output-dir "$DECK_DIR" [--force]

# Validate (after writing slides)
oma slide validate --workspace "$DECK_DIR" --output json [--report-file <file>]
oma slide validate --workspace "$DECK_DIR" --slide slide-04.html   # single-slide gate (enhance mode)

# Build viewer
oma slide preview --workspace "$DECK_DIR"

# Bundle to single-file
oma slide bundle --workspace "$DECK_DIR" [--output-file <file>] [--inline-fonts]

# Exports (optional)
oma slide export pdf  --workspace "$DECK_DIR" [--output-file <file>] [--mode capture|print]
oma slide export png  --workspace "$DECK_DIR" [--output-dir <dir>] [--resolution 720p|1080p|1440p|2160p|4k]
oma slide export pptx --workspace "$DECK_DIR" [--output-file <file>]   # experimental

# Video download
oma slide asset fetch-video <url> --workspace "$DECK_DIR" [--output-name <name>]

# Style browsing
oma slide style list
oma slide style preview <slug>
oma slide style get <slug> [--refresh]

# Visual editor
oma slide edit --workspace "$DECK_DIR" [--port <n>]

Env-var overrides: OMA_CHROME_PATH (Chrome binary for validate/export), OMA_YTDLP (yt-dlp binary), OMA_HOME (canonical asset root).

Resource scope