Update to Creative Claw

{
  "name": "creativeclaw-build-film",
  "description": "Produce a complete multi-shot Creative Claw film from planning through an assembled first cut. Use for ads, explainers, music videos, or stories that require several coordinated clips, narration, and approval gates.",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 539
    },
    {
      "relative_path": "references/images/gpt-image-2.md",
      "size_in_bytes": 10996
    },
    {
      "relative_path": "references/images/index.md",
      "size_in_bytes": 456
    },
    {
      "relative_path": "references/images/nano-banana-2.md",
      "size_in_bytes": 8817
    },
    {
      "relative_path": "references/images/nano-banana-pro.md",
      "size_in_bytes": 8779
    },
    {
      "relative_path": "references/images/seedream-5-pro.md",
      "size_in_bytes": 9556
    },
    {
      "relative_path": "references/job-recovery.md",
      "size_in_bytes": 3786
    },
    {
      "relative_path": "references/media-assembly.md",
      "size_in_bytes": 3876
    },
    {
      "relative_path": "references/platform-upload.md",
      "size_in_bytes": 1416
    },
    {
      "relative_path": "references/video/gemini-omni.md",
      "size_in_bytes": 9538
    },
    {
      "relative_path": "references/video/index.md",
      "size_in_bytes": 1823
    },
    {
      "relative_path": "references/video/minimax-h3-max.md",
      "size_in_bytes": 9097
    },
    {
      "relative_path": "references/video/other-models.md",
      "size_in_bytes": 4257
    },
    {
      "relative_path": "references/video/recipe-character-scene.md",
      "size_in_bytes": 2966
    },
    {
      "relative_path": "references/video/recipe-product-ad.md",
      "size_in_bytes": 2998
    },
    {
      "relative_path": "references/video/recipe-source-edit.md",
      "size_in_bytes": 2620
    },
    {
      "relative_path": "references/video/reference-production.md",
      "size_in_bytes": 7381
    },
    {
      "relative_path": "references/video/review.md",
      "size_in_bytes": 1909
    },
    {
      "relative_path": "references/video/seedance-2-5.md",
      "size_in_bytes": 12711
    },
    {
      "relative_path": "references/video/seedance-mini.md",
      "size_in_bytes": 1480
    },
    {
      "relative_path": "references/video/ugc-paths.md",
      "size_in_bytes": 2923
    },
    {
      "relative_path": "references/video/wan-3.md",
      "size_in_bytes": 8665
    },
    {
      "relative_path": "references/workflow-basics.md",
      "size_in_bytes": 7159
    }
  ],
  "skill_md_contents": "---\nname: creativeclaw-build-film\ndescription: \"Produce a complete multi-shot Creative Claw film from planning through an assembled first cut. Use for ads, explainers, music videos, or stories that require several coordinated clips, narration, and approval gates.\"\n---\n\n# Build Film\n\nRead [video model selection](references/video/index.md), then only the selected model's guide. Model families are covered locally, with live-schema guidance for additional models; do not load every guide or require a sibling model skill. Read [reference production](references/video/reference-production.md) before preparing media and [Review/Auto handling](references/video/review.md) before submission.\n\nRead [shared execution guidance](references/workflow-basics.md) once per task before using tools. It covers existing authorization, model discovery, optional cost checks, imports, and recovery.\n\nRun a stateful, multi-shot production with explicit approvals. Use `creativeclaw-generate-video` for a single clip and `creativeclaw-plan-video` when the user wants planning only.\n\nFor worked production flows, read only the relevant recipe: [product ad](references/video/recipe-product-ad.md), [consistent Character scene](references/video/recipe-character-scene.md), or [source edit and extension](references/video/recipe-source-edit.md). These explain asset preparation, shot prompting, assembly and output checks, without authorizing extra paid drafts.\n\n## Reference-first production\n\nStrongly recommend image preparation before video: reuse the user's media, develop shot-appropriate references with creativeclaw-generate-image, and prefer at least three complementary images where the video model supports them. Read [image model selection](references/images/index.md) and only the chosen image guide, plus [the reference-first workflow](references/video/reference-production.md) for approval, Character sheets, audio-first control and cross-shot continuity. Existing references count; do not force extra paid assets, exceed model limits or ignore an explicit direct-generation request.\n\nUse the video's Review card as the single approval of its exact references and settings, without a duplicate chat approval. Honor separately requested earlier checkpoints and consent requirements. Review does not gate earlier image/audio charges. For connected clips, reuse stable visual/audio anchors and request dialogue, ambience and effects without independently generated music per shot.\n\n## 1. Create and plan\n\n1. Use `list_film_projects` and `get_film_project` to resume an existing project when appropriate; otherwise call `create_film_project` with the name, brief, Character IDs, theme, and target duration.\n2. Follow `creativeclaw-plan-video` to create the script, shot list, model plan, and storyboard.\n3. Save stable shot IDs and patch the project with `update_film_project`. Do not replace approved fields accidentally.\n4. Honor script and storyboard review stages, including approval already given or explicit instructions to proceed through them. Advance `drafting`, `script_ok`, and `storyboard_ok` truthfully; do not repeat approval questions.\n\n## 2. Establish timing and audio\n\nFor narration-driven production, generate or reuse speech with `creativeclaw-generate-voiceover` before locking shot durations. Use returned alignment/timestamps or inspected duration. Do not add separate narration to native-dialogue clips unless requested. Avoid music generated independently inside each clip. Require a consistent shared voice/ambience plan and reference anchors for connected shots. Use `creativeclaw-generate-music` once for a requested continuous project score or song and `creativeclaw-generate-sound-effects` for ambience, Foley, and effects. Establish a supported assembly method before creating tracks that need layering.\n\nWhen the user asks about cost or supplies a budget, estimate supported planned generations and total them; identify processing costs excluded by `estimate_generation`. Do not add another approval gate for authorized production.\n\n## 3. Generate shots\n\n1. Keep storyboard and reference approval state truthful. In Review mode, prepare each shot request for approval without claiming it is rendering; mark rendering only after the applicable approval and actual submission. Honor a separately requested storyboard checkpoint.\n2. For each shot, read the selected local model guide, check current parameters, and call `generate_video` with the approved prompt, model and duration. Use a clean `image_url` for literal-frame animation or ordered references for reference-guided composition, not both.\n3. Maintain Character and product continuity through approved canonical anchors. Build identity into literal start frames before animation, or bind identity in a supported reference-only request. `character_id` does not automatically add a second visual reference.\n4. On `approval_required`, retain the Recovery Job ID and pause that shot until the user submits it. Resolve submitted jobs needed for assembly with `check_job`, inspect every clip, and write each approved `clipUrl` back to its shot.\n\n## 4. Combine audio and clips\n\nUse the narration prepared for timing. Read [media-assembly.md](references/media-assembly.md) before combining tracks or clips. The film assembler can optionally overlay one project-level `audioUrl`; it does not automatically mix every shot's `audioUrl`.\n\nWhen per-shot narration or dialogue is required, use `merge_media({ operation: \"merge_audio_video\" })` to mux the approved audio into each shot clip before saving that final `clipUrl`. Alternatively, merge an approved full-length narration track and set it with `update_film_project({ id, audio_url })` before assembly. Preserve individual shot updates with `patch_shots`.\n\n## 5. Assemble and approve\n\n1. Verify that every intended shot has an approved `clipUrl` in order.\n2. Call `assemble_film` with `mode: \"connect\"` by default. It preserves every clip and reports target-duration overage as a warning. Use `mode: \"cut_end\"` only when the user wants the fully assembled output trimmed at `targetDurationS`.\n3. Resolve the queued job with `check_job`. Only the completed URL is the first cut; completion saves `assembledUrl` and `preview_ok`. Verify playback order, full duration, and audio.\n4. When the user requests opening or closing bookends, use `creativeclaw-add-video-intro-outro` after the first cut exists. That workflow may offer HTML-rendered cards, but it must not call `render_html_video` unless the user explicitly chooses HTML/HyperFrames/code-driven rendering.\n5. Do not imply that assembly adds transitions, captions, sound design, or per-shot audio mixing. If those are required, create the needed processed clips with exposed tools before assembly.\n6. Set `preview_ok` when the first cut exists. Set `final` only after the user has reviewed and approved it.\n\n## Recovery\n\nResume from saved project state rather than regenerating approved media. If a shot fails or has a quality issue, report the problem and propose a repair. Require explicit authorization before another generation attempt for that shot; approval of the film or storyboard alone does not authorize replacement takes. After an authorized replacement succeeds, patch only that shot's URL. Do not restart the full film. Never claim completion from queued job IDs.\n"
}