kinema-project

Manage multi-episode video projects, chapters, characters, props, and scenes as JSON workspace entities.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill includes references (resource) components.

What problem does it solve? Producing a multi-episode video series with scattered one-off files breaks character, scene, and voice consistency across episodes. This Skill organizes production into a project โ†’ chapter โ†’ character/design hierarchy stored as JSON files, so every episode inherits the same style profile, voice assignments, and design reference sheets. ## Core Features & Use Cases - Project and chapter management: Create series projects with overall design (logline, world, tone, palette), then add chapters that automatically inherit the project's profile, character voices, and design assets. - Character, prop, and scene registries: Maintain text-first design records (appearance, voice prompts, personality, arc, taboos) that drive consistent reference-sheet generation across all episodes. - Novel/screenplay adaptation mode: Import a full manuscript (TXT, EPUB, Fountain, FDX), split it into episodes one-to-one with source chapters, scaffold chapters, and plan shots with a text-first, image-later workflow. - Reference-film study mode: Analyze a local reference video's pacing (cuts per minute, shot durations, silence ratio) to decide shot counts and motion modes without copying its content. - Use Case: You want to adapt a 40-chapter web novel into a short-drama series. Import the manuscript, extract characters and scenes, define one episode per chapter, scaffold all chapters, then review an image-readiness report before spending anything on generation. ## Quick Start Create a new Kinema project for my series, register the main characters with their voice descriptions, and show me the project status.

Frequently Asked Questions about kinema-project

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

FAQPage Schema
How do I create a multi-episode video project with consistent characters?โ–ผ

Create a project with the Kinema CLI, then register characters with appearance, outfit, and voice-prompt fields. New chapters automatically inherit the project's profile, voice table, and design sheets, so style and voices stay consistent across the whole series.

How do I adapt a novel into a multi-episode video series?โ–ผ

Import the manuscript file (TXT, EPUB, Fountain, or FDX) with the adapt command, then extract entities, split episodes one-to-one with source chapters, and scaffold chapters. All steps produce text only; image generation waits for explicit user approval via an image-readiness report.

What file formats does the novel import support?โ–ผ

The import accepts TXT, EPUB, Fountain, and FDX files. EPUB is parsed with standard-library zip and XML tools using its built-in navigation for chapter titles. Encodings including UTF-8, GBK, Big5, and UTF-16 are auto-detected and converted to UTF-8.

Can I edit the project JSON files directly by hand?โ–ผ

No. Character, prop, and scene arrays must be modified through the set commands, which use process locking and reload from disk. Manual edits get silently overwritten by long-running engine tasks or by newer database rows in MySQL mode.

When should I use reference-film study mode?โ–ผ

Use it when you have a local reference video and want to match its pacing. The engine measures cut density, shot durations, and silence ratio so you can decide shot counts and motion modes. The reference never enters generation requests or delivery packages.

Why must scenes be registered as scenes instead of props?โ–ผ

Prop reference sheets use a three-view object layout meant for handheld items, so a place registered as a prop renders incorrectly. Scenes use wide establishing-shot key art. The rule: anything a character can pick up is a prop; anything they walk into is a scene.