asset-preflight-skill

Extracts and finalizes character, scene, and prop asset lists from converted drama scripts.

Updated Aug 12, 2026
One-click install
npx skills add https://github.com/VANTSU-1874/woods-video-studio --skill asset-preflight-skill-vantsu-1874
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: asset-preflight-skill
Source: https://github.com/VANTSU-1874/woods-video-studio/tree/main/template/.agents/skills/asset-preflight-skill
Command: npx skills add https://github.com/VANTSU-1874/woods-video-studio --skill asset-preflight-skill-vantsu-1874

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before any episode-level directing or storyboard work begins, a short-drama production needs a single, consistent inventory of every character, scene, and prop that will require reference images. Doing this manually across dozens of converted scripts leads to duplicated character names, missed recurring props, and inconsistent visual variants. ## Core Features & Use Cases - Sharded Parallel Inventory: Splits all converted episode scripts into groups of five and dispatches parallel asset-analyst sub-agents, each writing a structured chunk JSON with characters, scenes, and props. - Merge and Deduplication Rules: Consolidates chunk results into one canonical list, merging name aliases, rejecting temporary poses or expressions as character variants, and retaining props that participate in causal chains, cross-scene continuity, or repeated on-screen actions. - Finalized Deliverables: Produces a human-readable full-show asset table (全剧资产总表.md) and a machine-readable final-asset-bible.json with firstEpisode, visualKeywords, decision, and mergeNotes per entry, gated by a formal validation step. - Use Case: Given 30 converted episode scripts, run this skill to produce the definitive asset bible that downstream costume/prop prompt writing and per-episode directing will reference. ## Quick Start Ask the assistant to run the full-show asset preflight over all converted scripts in 资产/converted-scripts and produce the finalized asset table and asset bible before any directing work begins.

Frequently Asked Questions about asset-preflight-skill

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

FAQPage Schema
How do I build a consistent character and prop list across many script episodes?

Split the converted scripts into groups of about five episodes and have parallel analyst agents extract characters, scenes, and props into chunk JSON files. A main session then merges aliases, removes invalid variants, and writes one finalized asset bible.

What counts as a character variant versus a temporary state?

Only persistent visual identity changes qualify as variants, such as age stages, costume or uniform changes, disguises, or lasting scars. Temporary poses, expressions, sweat, or actions must be merged back into the base character and handled in directing or storyboard notes.

When should a prop be kept as an asset instead of discarded?

Keep a prop if it joins the main causal chain, is repeatedly used within a continuous action sequence, moves across scenes or spaces, has a distinct visual identity, or must be referenced as the same object later. Excluded candidates need a documented reason in mergeNotes.

Does this skill generate images, prompts, or storyboards?

No. It only produces the finalized asset table and final-asset-bible.json. Prompt batch generation, registry writes, storyboards, and image or video generation are explicitly handled by later stages such as the art-design skill.

Can the sharded analyst agents run in parallel safely?

Yes. Each analyst only reads its assigned episode range and writes its own chunk JSON file, with no shared state, locks, or scheduling duties. Completion is judged solely by whether all expected chunk files exist.