# Markdown To Storyboard

Convert markdown content into a structured storyboard CSV for slide decks, video...

- Repository: https://github.com/dp-archive/archive (1107 stars)
- Category: Documents
- License: Apache-2.0
- Last updated: 2026-03-04
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add dp-archive/archive --skill markdown-to-storyboard -g -a claude-code -y`
Codex: `npx skills add dp-archive/archive --skill markdown-to-storyboard -g -a codex -y`
Cursor: `npx skills add dp-archive/archive --skill markdown-to-storyboard -g -a cursor -y`
Gemini CLI: `npx skills add dp-archive/archive --skill markdown-to-storyboard -g -a gemini-cli -y`

## Description

Convert markdown content into a structured storyboard CSV for slide decks, video scripts, or any sequential visual media. Use when the user wants to plan a presentation, break down an article into slides, create a shot list, or generate a scene-by-scene outline from text. Triggers: "plan slides", "create storyboard", "break this into slides", "plan presentation", "outline this as a deck", "article to slides", "text to storyboard".

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Markdown to Storyboard

Convert any markdown text into a structured storyboard CSV, the universal handoff format
for downstream tools (slide builders, video editors, image generators).

## Workflow

### 1. Analyze the Source Markdown

Read the markdown and identify:
- Title and subtitle
- Section headings (H2/H3) → natural slide boundaries
- Key arguments / data points / quotes per section
- Narrative arc: setup → development → climax → conclusion

### 2. Ask User Preferences

Prompt for (defaults in parentheses):
- **Slide count** (auto: 8, 15 based on content length, ~1 slide per 150, 300 words)
- **Audience** (general)
- **Tone** (professional)
- **Language** (same as source)

If user declines to specify, use defaults and proceed.

### 3. Assign Slide Types and Layouts

Available `slide_type` values:

| Type | Purpose | Typical layout |
|------|---------|---------------|
| `cover` | Opening slide | `full_bg` |
| `toc` | Table of contents (optional, 12+ slides) | `center_text` |
| `section` | Chapter divider | `center_text` |
| `content` | Core information | `left_img_right_text` or `top_img_bottom_text` |
| `quote` | Key quote or statistic | `full_bg` |
| `data` | Chart / number-driven | `two_column` |
| `summary` | Closing recap | `center_text` or `left_img_right_text` |
| `end` | Thank-you / Q&A / CTA | `full_bg` |

Available `layout` values:
`full_bg`, `left_img_right_text`, `top_img_bottom_text`, `center_text`, `two_column`

### 4. Write the Image Prompt for Each Slide

For each slide, write an `image_prompt` (English, regardless of content language) that:
- Describes a **concrete scene**, not an abstract concept
- Includes a **style keyword** consistent across all slides (e.g. "flat vector illustration, soft pastel palette")
- Specifies composition hints matching the layout (e.g. "wide shot, negative space on the right" for `left_img_right_text`)
- Cover and end slides get more dramatic / visually impactful prompts

### 5. Draft Speaker Notes

The rest: https://github.com/dp-archive/archive/blob/HEAD/seed_skills/markdown-to-storyboard/SKILL.md