# Video Spec Builder

> Build a minimal JSON render spec for the local video pipeline from script lines, still images, or narration assets. Use when the spec artifact must exist before any MP4 render can run.

- Skill: `kiku-jw/video-spec-builder` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add kiku-jw/video-spec-builder`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kiku-jw/video-spec-builder/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: kiku-jw (https://skillmd.com/u/kiku-jw)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kiku-jw/video-spec-builder

---


# Video Spec Builder

## Metadata
- Trigger when: the user has script lines, images, or narration assets and needs a clean render spec before rendering.
- Do not use when: a spec JSON already exists and the real job is running the renderer.

## Skill Purpose

Turn raw video inputs into one minimal, explicit JSON spec that the renderer can execute without guesswork.

## Instructions
1. Gather the smallest honest input mode first: text plus TTS, script plus image backgrounds, or existing narration plus explicit timing. Lock the required asset paths before writing anything.
2. Write a minimal JSON spec with explicit size, fps, voice/input mode, and line structure. Keep the first spec lean instead of anticipating every future tweak.
3. Validate the spec: confirm referenced files exist, required fields are explicit, and the next rendering command is obvious. If the spec is ready, hand off to `$video-render-run`.

## Non-Negotiable Acceptance Criteria
- The spec is minimal but complete enough for the renderer to run.
- Asset paths, timing assumptions, and narration mode are explicit.
- The skill does not render the video itself; it stops at the spec artifact.
- If key assets or timing inputs are missing, the blocker is stated directly.

## Output
- The spec JSON path.
- A short note on the chosen input mode and required assets.
- `Next skill options` (only if needed): `$video-render-run` — render and validate the MP4 from this spec.