Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Video Spec Builder · feicaiclub | DecimalAI

design mediaby feicaiclub

Video Spec Builder

feicaiclub/video-spec-builder

Source feicaiclub/video-spec-builder ↗License MIT

当用户说想做一个视频、宣传片、产品演示、动画短片、抖音/YouTube 内容，或者说要改分镜、调节奏、换镜头、调字幕、加配音、改转场时使用。通过苏格拉底式追问收集视频需求，主动激发渲染层的全部能力（TTS / 字幕 / 3D / shader / 音频反应等），输出标准化的 video-spec.md 用于渲染。

SkillScore87Maintained

Automatic

Marketing & Content pack

Last verified 8/15/2026

What it changes

Passed 19 of 22 test cases with the skill, and 6 of 22 without it.

Without skill26%

With skill87%

Checks it passed that the model alone missed

Declines writing executable rendering code.
Asks the user to choose which file to update.
Inquires whether a 3D model asset is available.

and 16 more in the full report

15 fixed5 passed either way2 still failing1 broke

Pass-rate lift: +61 pp
Tokens: +292%
Agent turns: 0%
Response time: -2%

Model gemini-3.6-flashMeasured 8/15/2026v120 of 23 cases passed with skill · 22 comparable

Tokens, turns and time describe resource use, not a dollar price.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/feicaiclub-video-spec-builder/SKILL.md https://app.decimal.ai/s/feicaiclub-video-spec-builder/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add feicaiclub-video-spec-builder, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/feicaiclub-video-spec-builder/ and pins it in .decimal/skills.lock

decimalai skills add feicaiclub-video-spec-builder

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/feicaiclub-video-spec-builder/SKILL.md https://app.decimal.ai/s/feicaiclub-video-spec-builder/SKILL.md

Raw file: /s/feicaiclub-video-spec-builder/SKILL.md ↗ · machine-readable summary at /s/feicaiclub-video-spec-builder.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

One of 15 test cases the skill fixed. Same model, same prompt, with and without the skill.

1 of 15

Prompt

I want to update my video spec. In my project directory, there is `promo-video-spec.md` and `feature-storyboard.md`. Please proceed with updating.

What was checked, without and with the skill
Checked	Without skill	With skill
Lists both detected files.	Passed	Passed
Asks the user to choose which file to update.	Missed	Passed

case-20 · gemini-3.6-flash · 8/15/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md348 lines10 files

[任务] 0-1 模式：通过深入对话收集视频需求，主动告知可用能力（用户往往不知道能做什么），用直白甚至刺耳的追问逼用户在镜头粒度上想清楚，输出包含分镜表的 video-spec.md。

**迭代模式**：用户对已有 video-spec.md 提出修改（换镜头/改节奏/换音乐/调字幕/换配色）时，通过追问帮用户想清楚变更，检测与现有 spec 的冲突，更新 `video-spec.md`。

[启动检查] 1. 扫描项目目录查找 video-spec 文档： - 精确匹配：video-spec.md - 模糊匹配：*video-spec*.md、*分镜*.md、*storyboard*.md - 找到 1 个 → 迭代模式（read references/workflow-iteration.md） - 找到多个 → 列出文件名问用户"你要改的是哪个？" - 没找到 → 0-1 模式（read references/workflow-0-1.md） 2. 检查项目根目录有没有 design.md / DESIGN.md（自定义主题文件；视觉风格阶段才用到，启动时不强制）

[第一性原则]

[能力优先]
    用户提出的每个需求，你的第一反应是"渲染层能不能做得更好"。
    告诉用户能做什么时，说"它能让画面变成什么样"，不说技术名字。

    - 用户说"加段旁白" → 主动问"要不要我直接帮你生成 AI 配音，省得你录？30 秒搞定，
                          不过会有点'课件感'，没有真人那种小停顿和情绪"
    - 用户说"加字幕" → 主动问"字幕要整句一起跳出来，像看电影那种安静呈现？
                          还是一个字一个字蹦，像 Karpathy 推文那种讲到哪个词亮哪个？"
    - 用户说"想要 3D 感" → 主动问"你想要 Apple 发布会那种产品 360° 真实旋转的沉浸感？
                          还是 Stripe 文档那种卡片飘过的轻盈感？前者更震撼但你得有 3D 模型"
    - 用户说"配乐想有节奏感" → 主动问"要不要让画面跟着鼓点跳？像 DJ 打碟那种，
                          鼓一响元素就缩放、字就抖，跟音乐同呼吸"
    - 用户没主动提某个能力 → 对照 [能力对照表] 主动告知能做什么（说画面，不说技术）
    - 做不到的事 → 直接说做不到，不要假装能做

[视觉风格的处理]
    用户一旦定下视觉主题，该主题的颜色 / 字体 / 字重 / 动效 / 间距 / 圆角全部跟着定下来，
    别再回头追问这些维度。但**定下来之前**，主题本身是开放的，2 条路径任选。

    - 没定主题前：2 条路径开放（8 个 HyperFrames 预设 / 用户自定义 design.md）
    - 定了之后：该主题的全部细节跟着定下来
    - 不要追问已被主题定下来的维度（如选了 Swiss Pulse 后不要再问"用什么字体"）
    - 只问可调维度：accent 色覆盖 / 装饰层密度 / 组件白黑名单

Track record

Benchmark

19 / 22

test cases passed, vs 6 / 22 without

Adoption

Users: 0
Times used: 0

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v8 — 10/22/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

feicaiclub / video-spec-builder

SKILL.md

View on GitHub ↗

License MITImported 8/3/2026Version v1Bundled 9 files

More skills from the same source and nearby in the registry, with their headline benchmark lift.