feicaiclub

feicaiclub / video-spec-builder

Public

video-spec-builder —— 把我想做个视频逼成一份精确到秒的分镜脚本 video-spec.md,交给 HyperFrames 渲染。一条命令装到 Claude Code / Cursor / Codex:npx skills add feicaiclub/video-spec-builder

16
4
89% credibility
Found May 19, 2026 at 36 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
JavaScript
AI Summary

video-spec-builder is a planning tool that works like having a film director in your pocket. When you tell it you want to make a video, it asks you questions until your vague idea becomes a detailed, timed script. It focuses on the hard part — figuring out what you actually want — then hands off your script to HyperFrames, which renders it into a finished video. The repository also includes a visual component library showing 69 design elements (charts, diagrams, UI mockups, flowcharts) in a SpaceX-inspired style, serving as a reference for what your AI tutorial videos can look like.

How It Works

1
💡 You have an idea for a video

You've got a vague idea for a video — maybe a product demo, a tutorial, or a company intro — but you're not sure how to turn it into something real.

2
📦 You install the skill

You add this tool to your AI assistant with a simple command. Now whenever you talk about making videos, it jumps in to help you plan.

3
🎬 Your AI becomes a film director

You say 'I want to make a video' and your assistant starts asking questions — who is this for, how long, what's the key message? It won't let you skip the important details.

4
Two paths to get started
✨
Start from scratch

Answer questions about your video idea until you have a complete, timed script

✏️
Revise what exists

Point out one thing to change and the assistant checks if it affects other parts of your script

5
📄 You get your shot-by-shot script

After a conversation with your AI, you receive a detailed script showing every shot, how long it lasts, and what appears on screen — all in a file you can open and edit.

6
🎥 You render your video

Hand your script to HyperFrames, the rendering tool that turns your written plan into a finished video with text, motion, and transitions.

🎉 Your video is ready

The fuzzy idea in your head is now a polished video you can share — built from a script you helped write and a style you chose.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 36 to 16 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is video-spec-builder?

video-spec-builder is a skill for AI coding assistants that turns vague video concepts into production-ready shot-by-shot scripts. You tell it something like "I want to make a product demo" and it interrogates you with questions until the fuzzy idea becomes a precise `video-spec.md` file with timing, transitions, and shot descriptions. Built in JavaScript, it installs via the `skills` CLI and runs inside Codex, Claude Code, or Cursor. The output feeds into HyperFrames, a companion renderer that turns the script into actual video from HTML. It also ships with "Spec Mono," a complete dark theme system inspired by SpaceX and Grok aesthetics, covering 69 video component patterns.

Why is it gaining traction?

The hook is the interrogation loop. Most tools assume you already know what you want on screen. video-spec-builder refuses vague inputs like "premium feel" or "high impact" and pushes you to describe actual shots and motion. It catches gaps you didn't know existed: missing transitions, uneven pacing, assets you haven't prepared. For developers already living in Claude Code or Codex, it feels natural to just say "I want to make a video" and have an AI director take the wheel. The bundled theme system is a nice bonus if you want that sharp, geometric, SpaceX-meets-Grok look without starting from scratch.

Who should use this?

Developers creating product videos, tutorials, or social content who want to script in plain language before rendering. Teams already using Codex or Claude Code get the smoothest experience. If you're making videos where text overlays, charts, UI mockups, and clean transitions matter, the Spec Mono theme gives you a head start. It's less useful if you need illustration-heavy or live-action content, since HyperFrames renders from HTML only.

Verdict

With only 16 stars, this is early-stage software. The credibility score of 0.899% reflects that low adoption and limited community feedback. No test coverage is visible, and the documentation leans on the original README without a dedicated docs site. That said, the core idea is solid and the workflow between spec-builder and HyperFrames is well thought out. If you're in the Codex/Claude Code ecosystem and want to script videos programmatically, it's worth a try. Just don't bet a production pipeline on it until it has more traction and a test suite.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.