Agent skill

Promo Storyboard

by kangarooking in kangarooking/promo-creator-skills

宣传片逐镜头分镜脚本。根据创意简报生成每个 Shot 的 7 维画面描述和详细 HyperFrames 提示词,是整条视频质量的关键。当用户确认 brief 后自动进入。

MITAuto-check passedMedia & Creative

Install Promo Storyboard

skills CLI
$ npx skills add kangarooking/promo-creator-skills --skill promo-storyboard -a claude-code

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

GitHub CLI
$ gh skill install kangarooking/promo-creator-skills promo-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/kangarooking/promo-creator-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/promo-storyboard .claude/skills/promo-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
promo-storyboard
GitHub stars
102
Used in
1 other repo
Token cost
~1.3k tokens
SKILL.md length
276 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

宣传片逐镜头分镜脚本。根据创意简报生成每个 Shot 的 7 维画面描述和详细 HyperFrames 提示词,是整条视频质量的关键。当用户确认 brief 后自动进入。

  • Works in 5 steps: 背景层 — 底色、渐变、纹理、图片 → 主体层 — 产品截图、数据、核心元素 → 文字层 — 标题/副标题/标注的位置、字号、颜色、字重 → …
  • Tasks that involve Comics and storyboards
  • SKILL.md covers 定位, 7 维 Shot Brief 模板, 画面描述写作规范 and 叙事结构模板, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Promo Storyboard is an agent skill from kangarooking/promo-creator-skills. 宣传片逐镜头分镜脚本。根据创意简报生成每个 Shot 的 7 维画面描述和详细 HyperFrames 提示词,是整条视频质量的关键。当用户确认 brief 后自动进入。

Its SKILL.md is about 1.3k 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 and Motion graphics. It works with HeyGen. The repository describes itself as: 产品宣传视频创作 Skills:从产品判断、分镜、素材、HyperFrames 剪辑到 BGM 设计的完整 Agent 工作流. The licence is MIT.

When your agent uses it

  • Tasks that involve Comics and storyboards
  • Tasks that involve Motion graphics

Example prompts

  • “/promo-storyboard”

Workflow steps

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

  1. 背景层 — 底色、渐变、纹理、图片
  2. 主体层 — 产品截图、数据、核心元素
  3. 文字层 — 标题/副标题/标注的位置、字号、颜色、字重
  4. 动画层 — 每个元素如何入场、运动、退场
  5. 时间层 — 什么时候出现、持续多久、和其他元素的先后关系

What it can do on your machine

Read from SKILL.md and the folder at commit 2d23af9. 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

Promo Storyboard loads about 1.3k tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 276 words of instructions outside code blocks.

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

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 kangarooking/promo-creator-skills at commit 2d23af9, republished under its MIT licence (© kangarooking). 276 words, ~1,277 tokens.

Download SKILL.mdSave it as .claude/skills/promo-storyboard/SKILL.md (or your agent's skills folder).
name
promo-storyboard
description
宣传片逐镜头分镜脚本。根据创意简报生成每个 Shot 的 7 维画面描述和详细 HyperFrames 提示词,是整条视频质量的关键。当用户确认 brief 后自动进入。

Promo Storyboard — 逐镜头分镜 & 画面提示词

定位

你是宣传片分镜师。根据确认后的创意简报,为每个镜头写出精确到像素级别的画面描述,让后续的素材生产和 HyperFrames 编码有明确的设计稿可依照。

画面描述的质量 = 最终视频的质量。 模糊的描述 → 模糊的画面。


7 维 Shot Brief 模板

每个镜头必须填满 7 个维度:

markdown
### Shot N: [镜头名称] (Xs-Ys)

| 维度 | 描述 |
|------|------|
| 类型 | 数据冲击 / 痛点展示 / 产品登场 / 功能演示 / 社会证明 / CTA |
| 时长 | X 秒 |
| 目标 | 一句话:这个镜头要让观众理解/感受什么 |
| 画面 | 详细的逐步画面描述(见下方规范) |
| 文字 | 出现的所有文字内容(主标题/副标题/数据/标注) |
| 动效 | 每个元素的入场/运动/退场(具体到 GSAP 级别) |
| 素材 | Pack A(AI 生成)/ Pack B(网络搜索)+ 具体需求 |

画面描述写作规范

写清楚 5 层信息
  1. 背景层 — 底色、渐变、纹理、图片
  2. 主体层 — 产品截图、数据、核心元素
  3. 文字层 — 标题/副标题/标注的位置、字号、颜色、字重
  4. 动画层 — 每个元素如何入场、运动、退场
  5. 时间层 — 什么时候出现、持续多久、和其他元素的先后关系
好的 vs 差的画面描述

❌ 差:

画面:展示产品功能,有动画效果

✅ 好:

画面:纯黑底。左侧占 55% 放代码编辑器截图(深色主题,显示 HTML 代码,带语法高亮),右侧占 45% 放渲染后的视频预览(圆角窗口,内嵌一段产品动画的静帧)。两者之间有一个 2px 宽的品牌色竖线。底部居中显示白色文字 "Write HTML → Get Video",字号 48px,字重 200,字间距 2px。

动效描述规范

每个动效写清楚:

  • 目标元素:哪个元素动
  • 属性变化:从什么值变到什么值
  • 持续时间:多久
  • 缓动函数:哪种 ease
  • 触发时间:第几秒开始
markdown
动效:
1. 代码编辑器:从左侧 slide-in (x: -100% → 0, duration: 0.8s, ease: power2.out, 从 0.3s 开始)
2. 竖线:从上到下 scaleY (0 → 1, duration: 0.4s, ease: power2.out, 从 0.8s 开始)
3. 视频预览:从右侧 slide-in (x: 100% → 0, duration: 0.8s, ease: power2.out, 从 0.5s 开始)
4. 底部文字:fade-in + slide-up (opacity: 0→1, y: 20→0, duration: 0.6s, ease: power2.out, 从 1.2s 开始)

叙事结构模板

标准 60 秒结构
段落时段Shot 数目的
Hook0-5s1抓注意力(震撼数据/反差/痛点)
Problem5-12s1建立共鸣(现状多痛苦)
Product12-22s1-2产品登场(是什么 + 核心价值)
Features22-48s3-4展示能力(每个功能 6-8 秒)
CTA48-60s1行动号召(Star/下载/关注)
标准 90 秒结构
段落时段Shot 数目的
Hook0-5s1抓注意力
Problem5-15s1-2建立共鸣(可以更充分)
Product15-30s2产品登场(拆成概念 + 演示)
Features30-72s4-6展示能力(更多功能)
Social Proof72-82s1数据证明(Star 数/用户数/增长)
CTA82-90s1行动号召

各风格画面特征速查

Apple 发布会风
元素规范
背景纯黑 #000 或深灰 #111,可有微弱径向渐变
主标题白色,字号 72-120px,字重 100-300,居中
副标题rgba(255,255,255,.5),字号 24-32px,字重 300
产品图居中,占画面 50-70%,有微妙光影/辉光
数据超大数字 160-200px,字重 100,居中
转场scale + blur + fade,0.5-0.8s,power2
禁止彩色背景、粗体大字、emoji、圆角卡片、霓虹、3D
瑞士国际主义风
元素规范
背景#fafaf8 浅暖灰,hero 帧可有极细网格点阵
主标题近黑 #0a0a0a,字号 min(6.4vw,11.2vh),字重 200,左对齐
锚点色单一高饱和色(整片只用一个)
灰阶#fafaf8 / #f0f0ee / #d4d4d2 / #737373 / #0a0a0a
卡片直角纯色,无渐变/阴影/圆角
转场语义化动效,每镜头不同 recipe
禁止衬线字体、渐变、阴影、圆角、多色拼贴、大字粗体
赛博科技风
元素规范
背景纯黑 + 微弱扫描线 / 网格
文字等宽字体(JetBrains Mono),终端绿 #00ff41 或品牌色
装饰代码片段、ASCII art、点阵、glitch
动效typewriter、matrix rain、scan line、flicker
禁止圆润字体、柔和渐变、商务感
极简商务风
元素规范
背景纯白 #fff ~ #f5f5f5
主标题黑色,Serif(Playfair Display),字号 64-96px
正文Sans-serif,#666,字号 20-28px
强调一个品牌色做色块/下划线
动效克制 — fade-in、slide-up、轻微 parallax
禁止炫技动画、多色、科技感装饰

Shot 示例(Apple 发布会风 · 60 秒)

markdown
### Shot 1: Hook — 数据冲击 (0-5s)

| 维度 | 描述 |
|------|------|
| 类型 | 数据冲击 |
| 时长 | 5 秒 |
| 目标 | 用一个震撼数字抓住注意力 |
| 画面 | 纯黑底。画面中央超大白色数字 "10,000+" 从 scale 0 弹入。0.8s 后底部出现浅灰小字 "videos rendered this month"。2.5s 后数字变色为品牌蓝 #0066FF。3.5s 后数字和小字同时 fade-out,Logo 从底部 slide-up 入场居中。 |
| 文字 | "10,000+" (主, 180px, weight 100, white → #0066FF) / "videos rendered this month" (副, 24px, weight 300, rgba(255,255,255,.5)) |
| 动效 | 1. 数字: scale(0→1), duration 0.6s, elastic.out(1,0.5), 从 0.3s 开始 / 2. 小字: opacity(0→1) + y(20→0), 0.5s, power2.out, 从 0.8s / 3. 数字变色: color(#fff→#0066FF), 0.3s, power1.inOut, 从 2.5s / 4. 全部退场: opacity(1→0), 0.4s, power2.in, 从 3.5s / 5. Logo: opacity(0→1) + y(40→0), 0.6s, power2.out, 从 4.0s |
| 素材 | Pack A: 生成 Logo 透明背景版 (1:1, PNG) |

### Shot 2: Problem — 痛点展示 (5-12s)

| 维度 | 描述 |
|------|------|
| 类型 | 痛点展示 |
| 时长 | 7 秒 |
| 目标 | 让观众感受到现有方案的复杂和低效 |
| 画面 | 左半屏(55%):一张传统视频编辑软件的复杂界面截图,灰度处理 filter:grayscale(1),占满左侧。右半屏(45%):纯黑底,中央一个大红 × 号,下方白色文字 "Too Complex."。3s 后左侧截图开始 scale 缩小并模糊退出。4s 后右侧内容也退出,全屏出现白色文字 "There's a better way." 居中,字号 56px,字重 200。 |
| 文字 | "Too Complex." (32px, weight 400, #ff4444) / "There's a better way." (56px, weight 200, white) |
| 动效 | 1. 截图: slide-in from left (x:-100%→0), 0.8s, power2.out, 从 5.0s / 2. ×号: scale(0→1) stamp, 0.3s, back.out(2), 从 5.5s / 3. "Too Complex": fade-in, 0.4s, 从 5.8s / 4. 左屏退出: scale(1→0.8) + blur(0→8px), 0.6s, 从 9.0s / 5. "better way" 入场: opacity(0→1), 0.8s, power2.out, 从 9.5s |
| 素材 | Pack B: 搜索一张复杂视频编辑软件界面截图(Premiere/AE/DaVinci) |

工作流

  1. 读取确认后的 01-brief.md
  2. 根据风格预设 + 叙事结构生成逐镜头 Shot Brief
  3. 每个 Shot 写满 7 维描述
  4. 标注每个 Shot 的素材来源(Pack A / Pack B)
  5. 输出 02-storyboard.md
  6. [PAUSE] 等用户确认:每个镜头的画面描述

用户可以:

  • 修改画面描述
  • 调整镜头顺序
  • 增删镜头
  • 更换风格

输出文件

outputs/promo-runs/<product>/
  02-storyboard.md      ← 逐镜头分镜(7 维 × N shots)

© kangarooking, 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 promo-storyboard of kangarooking/promo-creator-skills.

Open the folder on GitHubat commit 2d23af9

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in kangarooking/promo-creator-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Promo 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.

Promo Storyboard compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Promo Storyboard this skillkangarooking/promo-creator-skills1021 repos~1.3kAutomated safety check: PassMIT
Hbg Life SimulationMr-funny/hbg-life-simulation141—~5.8kAutomated safety check: PassMIT
SaaS Motion Videotugrawork-creator/saas-motion-kit219—~1.3kAutomated safety check: PassCustom licence
Hyperframes Helperrobonuggets/hyperframes-helper108—~4.3kAutomated safety check: PassCustom licence
Hyperframes Creativewaker240/FullVideoProductionSkill201—~3kAutomated safety check: PassApache-2.0
Edit Videonateherkai/hyperframes-student-kit1.3k—~673Automated safety check: PassCustom licence

Similar skills

  • Hbg Life Simulation

    Mr-funny/hbg-life-simulation

    Create Chinese HBG “模拟人生 / 人生副本” narrative videos with a consistent comic IP, a rapid multi-life opening, continuous natural-speed narration, synchronized short captions, dense static manga…

    141 GitHub stars~5.8k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • SaaS Motion Video

    tugrawork-creator/saas-motion-kit

    Make a promo / motion video for a software product with HyperFrames, using the saas-motion-kit 7-stage process (brief → components → theme → storyboard → build → sound → deliver), the…

    219 GitHub stars~1.3k tokensUpdated 6 days ago
    Media & CreativeAuto-check passed
  • Hyperframes Helper

    robonuggets/hyperframes-helper

    Build agent-friendly motion-graphics videos with Hyperframes (HTML-to-MP4).

    108 GitHub stars~4.3k tokensUpdated 5 mo ago
    Media & CreativeAuto-check passed
  • Hyperframes Creative

    waker240/FullVideoProductionSkill

    Develop video direction, typography, color, visual mechanisms, storyboards, and asset prompts.

    201 GitHub stars~3k tokensUpdated 14 days ago
    Media & CreativeAuto-check passed
  • Edit Video

    nateherkai/hyperframes-student-kit

    Edit a raw talking-head video through transcription, silence trimming, mistake review, visual storytelling, motion graphics, and verified HyperFrames rendering.

    1.3k GitHub stars~673 tokensUpdated 12 days ago
    Media & CreativeAuto-check passed
  • Luxury dark-editorial HyperFrames template for three-page cinematic storyboards, inspired by haute couture title cards and magazine chapter spreads.

    100k GitHub stars~607 tokensUpdated yesterday
    Media & CreativeAuto-check passed

More from kangarooking/promo-creator-skills

  • Promo Creator Skills

    kangarooking/promo-creator-skills

    产品宣传片制作总控 skill pack。用于从产品说明、官网、应用截图或 GitHub 仓库制作 60-90 秒宣传视频,按阶段完成 brief、storyboard、素材、HyperFrames 剪辑、BGM 设计和交付。当用户要做宣传片、产品视频、项目介绍视频、launch video、开源项目 promo、BGM 卡点或真实软件界面宣传片时使用。

    102 GitHub starsUsed in 1 repo~900 tokens
    Auto-check passed
  • Promo Asset Producer

    kangarooking/promo-creator-skills

    宣传片两包素材生产。Pack A 使用当前可用图片生成能力生成产品图、概念图、UI 模拟图或风格补充图;Pack B 使用官网、应用截图、浏览器搜索、GitHub 或开源素材收集真实产品信号。当 storyboard 确认后进入。

    102 GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed
  • Promo Brief

    kangarooking/promo-creator-skills

    产品宣传片创意简报。输入产品说明或 GitHub 链接,自动抓取产品信息,提炼核心卖点,推荐视觉风格和叙事结构。当用户提到"宣传片""promo""产品视频""做个视频介绍""项目宣传"时触发。

    102 GitHub starsUsed in 1 repo~693 tokens
    Auto-check passed
  • Promo Editor

    kangarooking/promo-creator-skills

    使用 HyperFrames 将所有素材按分镜时间码串联,添加文字层、动画、转场,渲染成完整宣传片 MP4。这是整个流程的核心渲染引擎。当素材确认后自动进入。

    102 GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Promo Music Maker

    kangarooking/promo-creator-skills

    为产品宣传片生成高度贴合画面节奏的 BGM 方案与音乐生成 Prompt。读取 brief、storyboard、EDL、DESIGN 或成片,输出音乐风格、BPM、情绪曲线、卡点表、Mureka/Skywork Music Maker 英文 prompt、负面 prompt 和剪辑建议。当用户要“配乐”“BGM”“背景音乐”“音乐 prompt”“卡点”“按转场做音乐”时触发。

    102 GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Promo Workflow

    kangarooking/promo-creator-skills

    产品宣传片制作总控流程。串联 6 个 Skills,按阶段执行并暂停确认。从产品 URL 到带 BGM 成片 MP4 的全自动流水线。当用户提到"做个宣传片""promo""产品视频""项目介绍视频"时触发。

    102 GitHub starsUsed in 1 repo~850 tokens
    Auto-check passed

Works with

Questions about Promo Storyboard

What does Promo Storyboard do?

宣传片逐镜头分镜脚本。根据创意简报生成每个 Shot 的 7 维画面描述和详细 HyperFrames 提示词,是整条视频质量的关键。当用户确认 brief 后自动进入。. Promo Storyboard is an agent skill from kangarooking/promo-creator-skills.

When should I use Promo Storyboard?

Promo Storyboard fits situations like: tasks that involve Comics and storyboards; tasks that involve Motion graphics.

How do I install Promo Storyboard in Claude Code?

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

How do I install Promo Storyboard in Codex?

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

Can I use Promo 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 kangarooking/promo-creator-skills --skill promo-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/promo-storyboard, .gemini/skills/promo-storyboard, .github/skills/promo-storyboard and .opencode/skills/promo-storyboard in your project.

What does Promo Storyboard need to run?

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

Does Promo 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 Promo 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 Promo Storyboard use?

Promo 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 Promo Storyboard use?

About 1.3k tokens (SKILL.md is roughly 5.1k 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 Promo Storyboard?

Skills that share tags, products or a category with Promo Storyboard: Hbg Life Simulation (Mr-funny/hbg-life-simulation, 141 stars), SaaS Motion Video (tugrawork-creator/saas-motion-kit, 219 stars), Hyperframes Helper (robonuggets/hyperframes-helper, 108 stars) and Hyperframes Creative (waker240/FullVideoProductionSkill, 201 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Promo Storyboard?

kangarooking (a GitHub user) maintains it in kangarooking/promo-creator-skills, which has 102 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on May 12, 2026.

Source: kangarooking/promo-creator-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.