shot-designer

Convert a screenplay into a timestamped storyboard with image and video prompts.

5|2|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/tangffntr/novel-asset-prompt --skill shot-designer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shot-designer
Source: https://github.com/tangffntr/novel-asset-prompt/tree/main/.opencode/skills/shot-designer
Command: npx skills add https://github.com/tangffntr/novel-asset-prompt --skill shot-designer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the heavy lifting of converting a screenplay into a clear, timestamped storyboard with prompts, saving time in pre-visualization and planning.

Core Features & Use Cases

  • Generates time-stamped storyboard data from a script, including image_prompt and video_prompt placeholders.
  • Reads project assets, script_readable.md, and project metadata to produce consistent outputs and asset tagging.
  • Produces a storyboard.json with timing, shots, scenes, and assets ready for handoff to Seedance or downstream tools.

Quick Start

Provide a script and assets.json to generate a complete, timestamped storyboard with prompts.

Frequently Asked Questions about shot-designer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a screenplay into a timestamped storyboard?

Creating a timestamped storyboard requires a script_readable.md file, an assets.json file, and project metadata. The skill validates frontmatter schemas and outputs a structured JSON storyboard for video production workflows.

How does automatic storyboard generation handle scene timing and assets?

It reads the script and assets.json to synchronize scene timing, dialogues, and asset tagging. This ensures the resulting storyboard.json maintains consistent timing and asset references throughout the video production pipeline.

Can I generate image and video prompts directly from a script?

The skill outputs a storyboard.json file containing image_prompt and video_prompt placeholders for every shot. These prompts are derived from the script's scenes and dialogues to guide downstream visualization tools.

Does storyboard generation work with downstream video production tools?

The output storyboard.json is designed for seamless handoff to Seedance and other downstream video production tools. It delivers structured shot data, timing, and prompts required for pre-visualization and planning.

What do I need to prepare before generating a storyboard from a script?

You must provide a script_readable.md file, an assets.json file, and project metadata. These inputs are required to validate frontmatter schemas and produce a complete, timestamped storyboard with accurate asset tagging.

What are the limitations of automating storyboard creation from a screenplay?

The skill is limited to processing scripts with valid frontmatter schemas and predefined assets.json structures. It does not generate assets itself but relies on existing project metadata to produce the timestamped storyboard output.