video-spec-builder

A director skill: it interviews you about a video idea and turns it into a second-by-second shot script for HyperFrames

Skill

Low risk

We rate an entry low when it mostly gives the agent instructions and reference material.

Why this level

  • The skill is instructions and templates that produce a text file
All reasons and checks

feicaiclub/video-spec-builder

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/video-spec-builder

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Run in a terminal in the project folder

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

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add feicaiclub/video-spec-builder --skill video-spec-builder -a cursor -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add feicaiclub/video-spec-builder --skill video-spec-builder -a github-copilot -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add feicaiclub/video-spec-builder --skill video-spec-builder -a codex -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add feicaiclub/video-spec-builder --skill video-spec-builder -a gemini-cli -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add feicaiclub/video-spec-builder --skill video-spec-builder -a cline -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add feicaiclub/video-spec-builder --skill video-spec-builder -a roo -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

A fork of Roo Code, same .roo folders.

Run in a terminal in the project folder

npx skills add feicaiclub/video-spec-builder --skill video-spec-builder -a opencode -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

You will need: Node.js

Checked against the repository on Sep 25, 2026, commit 9e73275.

Text for your agent

Install the skill: npx skills add feicaiclub/video-spec-builder. Then tell the agent you want to make a video and answer its questions.

Other ways from the author
npx skills add feicaiclub/video-spec-builder

Installs into Claude Code, Cursor and Codex.

This is third-party code. Review the repository files before installing.

What it does

The skill acts as a director during video prep. You say you want to make a video, and it asks questions: who it is for, how long, the one line the viewer should walk away with, which shot carries the weight. Where an answer is vague, it does not let you skip and pins down the details. The output is a video-spec.md file with a second-by-second shot script that you can hand to HyperFrames to render. The skill is agent-agnostic and installs with one command in Claude Code, Cursor or Codex.

Who it is for. For video makers, marketers and SMM specialists who struggle to turn a video idea into a concrete script.

Good fit when

  • You have a video idea but no clear script
  • You need a second-by-second shot list before rendering
  • You are preparing a video for HyperFrames rendering

Not a fit when

  • The script is already done and needs no work
  • You need a finished video file, not a spec

Example request

I want to make a short video about our product, help me build a second-by-second shot script

Limitations

The skill only prepares the video spec; it does not render anything: the finished video-spec.md goes to HyperFrames. Output quality depends on your answers to its questions. It is instructions for an agent, not a standalone program.

How to disable. Remove the video-spec-builder skill folder from your agent's skills directory.

Security check

  • The skill is instructions and templates that produce a text file

README in short

The README argues the hard part of a video is not rendering but figuring out what you actually want to shoot. The skill takes over that stage: it asks about audience, length, the core message and the key shot, refusing to let vague spots pass. The result is a precise video-spec.md handed to HyperFrames. Install is one skills add command, with examples, templates and references. MIT licensed.

FAQ

Does the skill make the video itself?

No, it prepares a video-spec.md; HyperFrames does the rendering.

Which agents does it work with?

It is agent-agnostic and skills.sh compatible, installing into Claude Code, Cursor and Codex.

Editors’ pick

Skills and CLI from HeyGen: the agent writes HTML compositions and renders them into MP4 videos, captions, motion graphics and decks

SkillMedium risk53.9KRepository stars

Blender MCP

MCP for Blender

Editors’ pick

An MCP server and Blender addon: the agent creates and edits objects, materials and scenes, pulls assets and runs Python in Blender

MCP serverHigh risk29.5KRepository stars
Editors’ pick

Official Remotion skills for making videos in React: compositions, animation, captions, maps and rendering

SkillLow risk4.8KRepository stars

Agentic video studio for Claude Code, Cursor and Codex: script, voiceover, images, stock footage, music, subtitles and render

WorkflowMedium risk61.8KRepository stars
Foxx AIvideo-spec-builder

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.