feicaiclub/video-spec-builder

video-spec-builder is a skill you install into AI coding tools like Codex or Claude Code. Its purpose is to help you turn a vague video idea into a precise written script, one shot at a time, before any rendering happens. The problem it addresses is the gap between having a rough idea for a video and knowing exactly what every moment of that video should look and feel like. The tool works as a conversational guide inside your AI assistant. You say something like "I want to make a three-minute product demo" and it takes over, asking you a series of focused questions: who the audience is, where the video will be posted, what the single most important message is, what visual material you already have. Anywhere your answer is vague it asks again until you give something specific enough to actually build from. The end product is a file called video-spec.md, which is a shot-by-shot script with timing for each segment. That file is then handed to a separate tool called HyperFrames, which renders the script into video. The two tools are designed to work in sequence: video-spec-builder handles the planning stage, HyperFrames handles the production stage. Installation uses a command-line tool called skills, installed with a single npx command. You can install the skill for a single project folder or globally across all your projects with a -g flag. Node.js version 18 or newer is required. The README is candid about what HyperFrames can and cannot do at the rendering stage, since the script is only as useful as the renderer's capabilities. HyperFrames works well for text animation, captions, charts, layout, and transitions, but cannot generate original illustrations, live-action footage, or photorealistic images. The repository is MIT-licensed. A Chinese-language version of the README is also available.