Agent skill

Storyboard

by godot-fun in godot-fun/gai

Turns user materials into a shot-by-shot storyboard with bilingual narration (Chinese + English VO, both required) and AI video prompts per shot.

MITAuto-check passedMedia & Creative

Install Storyboard

skills CLI
$ npx skills add godot-fun/gai --skill storyboard -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install godot-fun/gai storyboard --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/godot-fun/gai.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/storyboard .claude/skills/storyboard && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
storyboard
GitHub stars
183
Token cost
~1.7k tokens
SKILL.md length
789 words
Files
1
Skills in repo
36
Repo updated
First seen
Licence
MIT

At a glance

Turns user materials into a shot-by-shot storyboard with bilingual narration (Chinese + English VO, both required) and AI video prompts per shot.

  • Works in 2 steps: Narration per shot — Chinese and English… → Video prompt per shot — ready for i2v /…
  • Gives a target path (especially .md)
  • SKILL.md covers Inputs, Delivery, Workflow and Output format (required), plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Storyboard is an agent skill from godot-fun/gai. Turns user materials into a shot-by-shot storyboard with bilingual narration (Chinese + English VO, both required) and AI video prompts per shot. When the user gives a target path (especially .md), write the full storyboard there — do not only print it in chat. Style and duration are free. Use when the user asks for storyboard, shot list, narration, VO script, AI video prompts, image-to-video prompts, or a video plan from images/clips/copy.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Comics and storyboards, AI video generation and Text to speech and voice. The repository describes itself as: A lightweight AI agent and skill workflow framework built with Godot. The licence is MIT.

When your agent uses it

  • Gives a target path (especially .md)
  • Write the full storyboard there — do not only print it in chat
  • The user asks for storyboard
  • AI video prompts

Example prompts

  • “Use the storyboard skill to turn user materials into a shot-by-shot storyboard with bilingual narration (Chinese + English VO, both required) and AI…”
  • “/storyboard”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Narration per shot — Chinese and English (both required unless user opts out)
  2. Video prompt per shot — ready for i2v / t2v

What it can do on your machine

Read from SKILL.md and the folder at commit 6394686. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Storyboard loads about 1.7k tokens when it runs. Until then it costs about 114 tokens; SKILL.md has 789 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~114
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from godot-fun/gai at commit 6394686, republished under its MIT licence (© godot-fun). 789 words, ~1,652 tokens.

Download SKILL.mdSave it as .claude/skills/storyboard/SKILL.md (or your agent's skills folder).
name
storyboard
description
Turns user materials into a shot-by-shot storyboard with bilingual narration (Chinese + English VO, both required) and AI video prompts per shot. When the user gives a target path (especially .md), write the full storyboard there — do not only print it in chat. Style and duration are free. Use when the user asks for storyboard, shot list, narration, VO script, AI video prompts, image-to-video prompts, or a video plan from images/clips/copy.

Storyboard

From user materials only, produce:

  1. Narration per shot — Chinese and English (both required unless user opts out)
  2. Video prompt per shot — ready for i2v / t2v

Do not invent product facts, prices, logos, or claims not in the materials. Style and length are agent-chosen from the content (no fixed genre or duration).

Inputs

Any mix of stills, clips, text brief, and constraints. Optional: a delivery file path.

If goal/audience is ambiguous, state one short assumption and proceed. Ask only when a missing fact would make the storyboard unusable.

Delivery

ModeBehavior
User gives a file pathWrite the full storyboard markdown to that path. Chat: short confirm (path, runtime, shot count) only
No pathFull storyboard in chat

Treat a path as the output file when:

  1. User says write to / save as / put in + path
  2. Skill request is paired with one main .md / .txt document
  3. Path is an empty or draft file clearly opened for this output

Rules:

  • Always read the target file first if it exists. Non-empty body = text material; then replace with the full storyboard (keep useful facts in ## Materials / Spine).
  • One doc + images → write to the doc; images are materials only.
  • Explicit output path + separate brief → write only to the output path.
  • Several docs, unclear target → prefer the path next to the skill invoke; if still ambiguous, ask once.
  • User names a directory only → create storyboard.md there.

Workflow

  1. Detect delivery target (file vs chat)
  2. Inventory materials (read delivery file if present)
  3. Infer Visual Style (once for the whole piece)
  4. Design story spine (hook → develop → payoff / CTA)
  5. Break into shots (one clear idea each; duration free) — Shot 01 is the eyeball grab (see Shot 01)
  6. Write bilingual VO + video prompt per shot
  7. Write Assembly (after Spine), then Shots
  8. Consistency pass; deliver in required format
Visual Style (once)

Medium, mood, color/light, camera language, motion energy, aspect (default 16:9). Keep consistent across prompts unless a deliberate style shift is story.

Spine patterns
  • Product → desire/problem → reveal → benefit → close
  • Character → setup → turn → resolution
  • Trailer → hooks and escalating beats
  • Explain → claim → show → reinforce
  • Attention-scarce / fragmented viewing → grab in Shot 01 → develop → payoff / CTA

Spine may note what Shot 01 uses to stop the scroll; that hook is not a summary of the whole piece.

Shot rules
  • One idea per shot; prefer a visible cause of motion
  • Reference still present → i2v (motion relative to that frame)
  • No frame → t2v (full self-contained scene)
  • Respect user aspect; default 16:9
  • No invented logo text, legal claims, or competitor names
Show full SKILL.md (364 more words)Show less
Shot 01 (hook — grab attention)

Attention is fragmented: Shot 01 must catch the eye. It is an opening line that stops the scroll—not a summary of the video, and not necessarily the piece’s main thesis.

  • Prefer a sharp cold open: tension, curiosity, contrast, surprise, or a vivid concrete moment
  • VO + picture work as a hook; soft mood builds, empty atmosphere, or early detail dumps fail here
  • The main argument / product reveal can land in later shots; Shot 01 only needs to pull the viewer in
  • If materials already give a hook line, keep it and amplify — do not invent facts
Narration (bilingual default)
FieldUse
ChineseSpoken Chinese for TTS / record (or (no VO))
EnglishSpoken English for TTS / record (or (no VO))
  • Same idea in both languages (natural spoken, not word-for-word).
  • Length vs duration: Chinese ~3–4 chars/sec; English ~2–3 words/sec. Tighten the side that overruns.
  • Sync on edit: if either VO changes, update the other VO and related fields (Duration, Visual, Camera, Video prompt) in the same edit.
  • User gives one language verbatim → keep it; write a natural equivalent for the other.
  • User asks for only one language → omit the other field.
Video prompts

Self-contained for a generic model. Include: subject + action in time order, camera (frame + move), environment, light/color, motion intensity, continuity anchors.

  • i2v: start with Image-to-video from provided still: … then motion (+ keep composition unless changing)
  • t2v: full scene + Visual Style cues
  • Prefer concrete verbs; avoid named living artists / unlicensed IP not in materials
  • Optional: Avoid: flicker, morphing faces, extra limbs, watermark, text overlay
  • English prompt body unless user requires Chinese

Output format (required)

Section order is fixed: Materials → Visual Style → Spine → Assembly → Shots.

markdown
# Storyboard — [working title]

## Materials
- [asset or note → role]

## Visual Style
- Medium:
- Mood:
- Color / light:
- Camera:
- Motion energy:
- Aspect: [e.g. 16:9]

## Spine
[1–4 sentences: arc + rough total runtime]

## Assembly
[shot order, total runtime, TTS/BGM/stitch notes if obvious]

## Shots

### Shot 01 — [short title — cold open / hook]
- **Duration:** ~Xs
- **Source:** [file / t2v / i2v from …]
- **Visual:** [composition]
- **Camera:** [framing + move]
- **Chinese:** [spoken Chinese, or (no VO)]
- **English:** [spoken English, or (no VO)]
- **Video prompt:**

[full prompt — English preferred]

- **Avoid (optional):** …

### Shot 02 — …
…

Quality bar

  • File path given → full markdown saved there (UTF-8); not chat-only
  • Section order: Spine → Assembly → Shots; every shot has Chinese + English + Video prompt (or user opt-out)
  • VO languages sense-aligned; durations match speak length
  • Shot 01 grabs attention as a cold open (not a thesis summary; no slow-burn open)
  • Facts trace to materials; style coherent; i2v points at the right still
  • No video/image generation APIs unless user separately asks
  • No invented output path when user gave none → chat delivery only

CLI

Copy-paste commands: cli/storyboard.md

© godot-fun, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/storyboard of godot-fun/gai.

Open the folder on GitHubat commit 6394686

Compare with similar skills

Storyboard next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Storyboard compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Storyboard this skillgodot-fun/gai183—~1.7kAutomated safety check: PassMIT
Vibe Scenevericontext/vibeframe175—~1.8kAutomated safety check: PassMIT
Minimax H3 Text Video Promptunknowlei/minimax-h3-opencode-skills122—~2.3kAutomated safety check: PassMIT
Video DirectorJamailar/Beav1.8k—~9.6kAutomated safety check: PassCustom licence
Veo Showreel Production KitBlackBeltTechnology/pi-agent-dashboard315—~1.4kAutomated safety check: PassMIT
Adaptationdanjdewhurst/story-skills2861 repos~3.5kAutomated safety check: NotesMIT

Similar skills

  • Vibe Scene

    vericontext/vibeframe

    Author, repair, render, and inspect VibeFrame scene projects built from STORYBOARD.md and DESIGN.md.

    175 GitHub stars~1.8k tokensUpdated 6 days ago
    Media & CreativeAuto-check passed
  • Minimax H3 Text Video Prompt

    unknowlei/minimax-h3-opencode-skills

    Downstream MiniMax H3 specialist for professional text-to-video (T2VA) prompts using the official three-field format.

    122 GitHub stars~2.3k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • Video Director

    Jamailar/Beav

    Canonical entrypoint for every AI chat request that asks to make, generate, plan, or edit a video, including promotional films, ads, short videos, product videos, reference-image videos…

    1.8k GitHub stars~9.6k tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • Veo Showreel Production Kit

    BlackBeltTechnology/pi-agent-dashboard

    Turn a video timeline + voiceover into a reproducible, sliceable Veo 3.1 prompt package with a consistency anchor and AI storyboard sketches.

    315 GitHub stars~1.4k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Adaptation

    danjdewhurst/story-skills

    This skill should be used when the user asks to "make an audiobook", "narration script", "narrator", "ACX", "Findaway", "pronunciation guide", "how long is the audiobook", "adapt to a screenplay"…

    286 GitHub starsUsed in 1 repo~3.5k tokens
    Media & CreativeAuto-check: notes
  • Narrator AI CLI

    NarratorAI-Studio/narrator-ai-cli-skill

    AI 电影/短剧解说视频自动生成(AI 解说大师 CLI Skill)。当用户需要创建电影解说视频、短剧解说、影视二创、AI 配音旁白视频、film commentary、video narration、drama dubbing、movie narration 时触发。内置电影素材库、BGM、多语种配音、解说模板。通过 narrator-ai-cli 命令行实现:搜片→选模板→选…

    3k GitHub stars~4.5k tokensUpdated 3 mo ago
    Media & CreativeAuto-check passed

More from godot-fun/gai

All 36 skills in this repo
  • AI Text To Speech

    godot-fun/gai

    Zero-shot text-to-speech with voice cloning via IndexTTS2 (index-tts).

    184 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Audio Denoise

    godot-fun/gai

    Reduces background noise in a single audio file using FFmpeg afftdn.

    184 GitHub stars~465 tokensUpdated today
    Auto-check passed
  • Audio Fade

    godot-fun/gai

    Applies fade-in and fade-out at the start and end of a single audio file using FFmpeg.

    184 GitHub stars~652 tokensUpdated today
    Auto-check passed
  • Normalizes a single audio file to consistent LUFS loudness with true-peak limiting using FFmpeg.

    184 GitHub stars~684 tokensUpdated today
    Auto-check passed
  • Standardizes a single audio file to 44100 or 48000 Hz and exports 16-bit PCM WAV using FFmpeg.

    184 GitHub stars~638 tokensUpdated today
    Auto-check passed
  • Audio Split

    godot-fun/gai

    Splits a single audio file into two segments (part 1 before the split point, part 2 after) using FFmpeg.

    184 GitHub stars~554 tokensUpdated today
    Auto-check passed

Questions about Storyboard

What does Storyboard do?

Turns user materials into a shot-by-shot storyboard with bilingual narration (Chinese + English VO, both required) and AI video prompts per shot. Storyboard is an agent skill from godot-fun/gai. Turns user materials into a shot-by-shot storyboard with bilingual narration (Chinese + English VO, both required) and AI video prompts per shot.

When should I use Storyboard?

Storyboard fits situations like: gives a target path (especially .md); write the full storyboard there — do not only print it in chat; the user asks for storyboard; AI video prompts.

How do I install Storyboard in Claude Code?

Run `npx skills add godot-fun/gai --skill storyboard -a claude-code`. Or copy the skill folder (.agents/skills/storyboard in godot-fun/gai) into .claude/skills/storyboard in your project. Claude Code loads it when a task matches its description.

How do I install Storyboard in Codex?

Run `npx skills add godot-fun/gai --skill storyboard -a codex`. Or copy the skill folder (.agents/skills/storyboard in godot-fun/gai) into .agents/skills/storyboard in your project. Codex loads it when a task matches its description.

Can I use Storyboard in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add godot-fun/gai --skill storyboard -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/storyboard, .gemini/skills/storyboard, .github/skills/storyboard and .opencode/skills/storyboard in your project.

What does Storyboard need to run?

SKILL.md names no scripts, command-line tools or credentials: Storyboard is instructions for the agent only.

Does Storyboard access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Storyboard safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Storyboard use?

Storyboard is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Storyboard use?

About 1.7k tokens (SKILL.md is roughly 6.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Storyboard?

Skills that share tags, products or a category with Storyboard: Vibe Scene (vericontext/vibeframe, 175 stars), Minimax H3 Text Video Prompt (unknowlei/minimax-h3-opencode-skills, 122 stars), Video Director (Jamailar/Beav, 1.8k stars) and Veo Showreel Production Kit (BlackBeltTechnology/pi-agent-dashboard, 315 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Storyboard?

godot-fun (a GitHub organization) maintains it in godot-fun/gai, which has 183 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on October 10, 2026.

Source: godot-fun/gai on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.