kinema-sketchboard

Generates pencil-sketch storyboard previz boards and per-second beat timelines for video shots.

131|10|Updated Aug 14, 2026
One-click install
npx skills add https://github.com/chillzhuang/Kinema --skill kinema-sketchboard-chillzhuang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: kinema-sketchboard
Source: https://github.com/chillzhuang/Kinema/tree/main/.claude/skills/kinema-sketchboard
Command: npx skills add https://github.com/chillzhuang/Kinema --skill kinema-sketchboard-chillzhuang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Video generation models receive only a single prose prompt per shot, so multi-step actions, camera moves, and timing are often ignored or improvised. This Skill pins down each shot's motion second-by-second before any paid video generation, using a cheap sketch board plus a zero-cost segmented text timeline. ## Core Features & Use Cases - Per-second beat planning: Authors write shots[].sketch.beats (2-3 seconds per beat) that the engine compiles into a segmented timeline injected into the video prompt, with model-specific timestamp formats. - Sketch board generation: sketch gen renders a pencil-sketch grid (one panel per beat) with color-coded arrows for subject motion, camera moves, framing, lighting, and sound, costing about 0.3 CNY per board. - Mutual-exclusion arbitration: Each shot picks exactly one motion guide (sketch, 3D previz, or depth-control video) via sketch use --guide, preventing conflicting motion instructions. - Use Case: Before generating an 8-second fight shot with Seedance, write 3-4 beats with explicit timing, generate one board to verify staging, then run gen-video --dry-run to audit the timeline prompt before spending on real generation. ## Quick Start Ask the agent to write per-second beats for the shots in a chapter and generate a sketch previz board for the first shot to verify the staging before video generation.

Frequently Asked Questions about kinema-sketchboard

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

FAQPage Schema
How do I control action timing in AI video generation prompts?▼

Write per-second beats into the shot's sketch.beats field, allocating 2-3 seconds per beat with one active verb each. The engine compiles them into a segmented timeline injected into the video prompt, which models follow far better than one long prose paragraph.

How many beats should a video shot have?▼

Use 2-3 beats for a 5-second shot, 3-4 beats for 8 seconds, and 5-6 beats only for shots of 12 seconds or longer. Overly dense beats (under 1.2 seconds each) cause the video model to drop most actions entirely.

Can I use sketch boards together with 3D previz or depth control video?▼

No. Sketch boards, 3D previz, and depth-control video are mutually exclusive per shot because all three describe motion to the model. Set the guide explicitly with sketch use --guide sketch|previz|control, or rely on the default arbitration order previz > control > sketch.

Why did my generated video include sketch arrows or pencil styling?▼

The engine injects a style-guard sentence and negative prompt terms whenever a board is attached, stating the board is a storyboard script, not a visual reference. Never hand-edit prompts to bypass this assembly, and regenerate boards flagged as stale after prompt or duration changes.

When should I not generate a sketch board for a shot?▼

Skip boards for ordinary shots where beats plus the text timeline suffice, since each board costs about 0.3 CNY. Reserve boards for complex staging, multi-subject scenes, precise timing, or action sequences, and note that frame-chained chapters require explicit per-shot opt-in to attach boards.