Video Spec Builder

This is a video specification builder that turns vague requests into frame-by-frame production specs. It works through Socratic questioning to pin down exactly what you want: shot duration, transitions, audio reactivity, TTS voiceover, subtitle timing, 3D elements, shader effects. The core trick is that it actively tells you what the rendering layer can do (Three.js scenes, audio-driven animations, kinetic typography, chroma keying) because most people don't know what's possible. It outputs a structured video-spec.md with a full shot list, locks down visual themes (either from eight HyperFrames presets or a custom design.md), and refuses to accept fuzzy adjectives like "high-end" or "techy" until you describe actual visual decisions. Built for iteration, not just greenfield specs.

skills.sh installs: 3.9K
GitHub stars: 1.1K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add feicaiclub/video-spec-builder --skill video-spec-builder --agent claude-code

Installs into .claude/skills of the current project.

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（自定义主题文件；视觉风格阶段才用到，启动时不强制）

[第一性原则]

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

SKILL.md on GitHub

Details

Repository: github.com/feicaiclub/video-spec-builder
Categories: Game Development, Generative Media
First seen: Jul 14, 2026

Video Spec Builder

Install

Files

Details

Recommended