Introduction¶
When producing short dramas or promotional videos using AI video tools, the bottleneck is often not the generation itself, but the storyboard prompts. You need to break the script down into shots, clearly defining character appearances, scene lighting, and camera movements within each shot, while ensuring consistency across shots. Manually breaking down shots, copying and pasting, and maintaining character settings in spreadsheets is slow and often leads to “character drift” or lighting shifts in subsequent shots. This article introduces the Agent Skill “Script to Video Prompts” on SkillHub, which hands over the script input to an Agent to produce storyboard prompts directly usable in AI video tools shot-by-shot.
What is this¶
“Script to Video Prompts” (@cyinfo/script-to-video-prompts) is an enterprise Skill published by Chuyun Technology on SkillHub. It is currently at version 1.0.1 and categorized under content-creation. It targets the workflow of “script in, storyboard prompts out”: after parsing the script text, it automatically identifies character appearances, scene lighting, and camera rhythm, generating prompts shot-by-shot. It also includes built-in consistency checks to reduce the drift of character appearance and lighting between shots. The tags indicate requires_api_key=false, meaning using this Skill itself does not require additional API Key configuration.
SkillHub Page: https://www.skillhub.cn/skills/cyinfo/script-to-video-prompts
Metadata and Description Entry: https://api.skillhub.cn/cyinfo/script-to-video-prompts
Core Features¶
The following capabilities are based on the official introduction and the SkillHub page description; details that have not been independently verified are not expanded upon here.
- Script Formats: Supports common script file formats such as TXT, Word, PDF, and FDX.
- Storyboard Prompt Generation: Outputs prompts shot-by-shot that are directly usable in AI video tools, covering elements such as character appearance, scene lighting, and camera movement rhythm.
- Consistency Checks: Performs built-in validation during generation, aiming to reduce issues such as character “drift” and sudden lighting changes between shots.
- Export: Supports one-click export to Markdown, JSON, and Excel, facilitating integration with subsequent editing, batch processing, or team collaboration workflows.
The Skill has a rating of 100000 and 1282 downloads on SkillHub (statistics are based on the SkillHub page display).
Installation and Activation¶
This Skill follows the standard SkillHub SKILL.md installation method. The installation guide provided on the official page is: refer to the SkillHub installation documentation and install the coordinates @cyinfo/script-to-video-prompts.
Install SkillHub CLI (if not already installed)¶
First, confirm if skillhub exists on your local machine:
command -v skillhub && skillhub --version
If not installed, you can use the official installation script (full installation includes CLI and default Skills):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
To install only the CLI:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
Install “Script to Video Prompts”¶
When installing, you must use --dir to point to the actual skills directory read by your current Agent; otherwise, it defaults to installing to ./skills/, which the Agent may not be able to load.
skillhub install @cyinfo/script-to-video-prompts --dir <your Agent skills directory>
Common Agent skills paths (from SkillHub installation documentation):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/or.agents/skills/in the project directory
After installation, refresh or restart according to your client’s requirements so the new Skill is recognized. The official page does not list separate steps for Cursor and Codex CLI differences; the installation command is the same except for the skills directory.
Typical Usage¶
Official materials do not provide fixed example scripts or complete conversation logs, but the reproducible workflow is as follows:
- In an Agent with this Skill enabled, upload or paste a script (TXT / Word / PDF / FDX).
- Clarify the goal: e.g., storyboards for a short drama, shot lists for a product promo, or specify a camera style you wish to emphasize (if script information is insufficient, you and the Agent collaborate to complete the constraints).
- Have the Agent generate AI video prompts shot-by-shot following the Skill’s instructions and trigger the consistency check steps.
- Export to Markdown, JSON, or Excel as needed, and import the prompts for each shot into your preferred AI video tool.
Specific prompt templates and shot-splitting rules are written in the SKILL.md within the Skill package; the Agent executes according to this file after installation. This article does not repeat field names not listed on public pages.
Use Cases and Notes¶
Who is it for
- Pre-production for short dramas and micro-shorts: needing a quick transition from script to storyboard prompt tables.
- Product promos and brand films: where shot counts are controllable and consistency of characters and lighting is required.
- Creators using AI video as the primary workflow: hoping to reduce time spent on manual shot breakdown and repeated description of character appearances.
Things to Note
- Script quality and format affect recognition results; official explanations are not provided for scenarios like scanned PDFs. If parsing fails, you need to use a cleaner text version on the Agent side.
- Consistency checks can reduce the risk of character drift and lighting jumps, but cannot replace your spot-checking and re-generation during the final production stage.
- Ratings and download counts come from SkillHub display and change over time; refer to the values seen on the SkillHub page before installation.
Conclusion¶
“Script to Video Prompts” consolidates script parsing, storyboard prompt writing, and consistency constraints into a single Skill. It is suitable for teams or individuals who have incorporated AI video into their production chain but are still slowed down by storyboard copywriting. Installation and instructions are subject to SkillHub:
- https://www.skillhub.cn/skills/cyinfo/script-to-video-prompts
- https://api.skillhub.cn/cyinfo/script-to-video-prompts