video-spec-builder

Transform vague video briefs into standardized shot-by-shot video-spec.md files.

883|105|Updated May 16, 2026
One-click install
npx skills add https://github.com/feicaiclub/video-spec-builder --skill video-spec-builder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: video-spec-builder
Source: https://github.com/feicaiclub/video-spec-builder/tree/main
Command: npx skills add https://github.com/feicaiclub/video-spec-builder --skill video-spec-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and templates (resource) and examples (resource) and spec-mono (resource) components.

What problem does it solve?

The Skill helps content creators, marketing teams, and product demos transform vague video ideas into clear, executable shot-by-shot scripts by guiding a Socratic questioning process and outputting standardized video-spec.md ready for rendering.

Core Features & Use Cases

  • Socratic discovery: prompts deep, lens-focused questions to elicit concrete shots, timing, and transitions.
  • Structured output: produces a ready-to-render video-spec.md with shot-by-shot details and scene metadata.
  • Cross-purpose use cases: for product demos, marketing videos, tutorials, and internal communications.
  • Template-driven design: leverages templates and a bundled design system to ensure visual consistency.

Quick Start

Describe your video idea in plain language and the Skill will generate a complete video-spec.md ready for rendering.

Frequently Asked Questions about video-spec-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a vague video idea into a shot-by-shot script?

A standardized video-spec.md is needed to define concrete shots, timing, and scene metadata before rendering marketing demos or educational explainers. It provides downstream renderers like HyperFrames with executable structure, ensuring visual consistency and accurate scene composition.

What's the best way to plan a product explainer video for different platforms?

You can create a video-spec.md for various purposes including marketing demos, product explainers, tutorials, and internal communications. The template-driven design ensures visual consistency and structured scene metadata across different video types and durations.

How do I generate a video spec ready for HyperFrames rendering?

To generate a video spec for HyperFrames, provide a plain language description of your video brief. The system processes it through Socratic discovery to produce a ready-to-render video-spec.md containing shot-by-shot details and scene metadata.

Do I need a detailed storyboard before creating video specifications?

You do not need a detailed storyboard beforehand. The system utilizes a Socratic discovery process, prompting deep questions to help elicit concrete shots, timing, and transitions directly from your vague video brief, effectively building the storyboard for you.

Can I use this for both marketing demos and educational videos?

Yes, you can use it for marketing demos, product explainers, educational videos, and internal communications. It guides planning across platforms and durations, ensuring the final video-spec.md maintains visual consistency through a bundled template-driven design system.