← PicsartCONTENT HISTORY

Update to Picsart

Snapshot Nov 11, 2026 · 00:08 UTC · version 2.5.0

Collection source: downloaded plugin package.

WHAT CHANGED

Instructions updated for film-shot-generation

Skill instructions — Now says: `imageUrls`), `film` with the saved assets, their `identityReferences` and views, and `limits` from

Observed in instructions or declared skills. Runtime behavior has not been tested.

Save Picsart and check future changes in Following.

Up to 3 plugins free · no card required.

All fields and original values.

Skill instructions

Before

Nov 7, 2026 · 00:09 UTC

`imageUrls`), `film` with the saved assets and their views, and `limits` from

After

Nov 11, 2026 · 00:08 UTC

`imageUrls`), `film` with the saved assets, their `identityReferences` and views, and `limits` from

Supporting files

Before

Nov 7, 2026 · 00:09 UTC

[{"relative_path":"references/camera.md","size_in_bytes":8524},{"relative_path":"references/realism.md","size_in_bytes":5105},{"relative_path":"references/references.md","size_in_bytes":2565},{"relative_path":"references/repairs.md","siz...

After

Nov 11, 2026 · 00:08 UTC

[{"relative_path":"references/camera.md","size_in_bytes":8800},{"relative_path":"references/realism.md","size_in_bytes":5403},{"relative_path":"references/references.md","size_in_bytes":3456},{"relative_path":"references/repairs.md","siz...

Compare saved observations

Download comparison JSON

SKILL.md text changes

− removed · + added

--- before
+++ after
@@ -147,7 +147,7 @@
    `picsart_film_verify_prompt` already run on that prompt and its `blocks`, against what you pass
    in `verifyWith`: `approved` from the approved board (its lines, never the ones you typed into
    `speech`), `request` with the other arguments you will send to picsart_generate (`generateAudio`,
-   `imageUrls`), `film` with the saved assets and their views, and `limits` from
+   `imageUrls`), `film` with the saved assets, their `identityReferences` and views, and `limits` from
    `picsart_model_params`. Never retype the prompt into verify. A failed check is fixed in the
    inputs and compiled again; a check whose `skipped` names the board, the lines or the reference
    budget has not checked them, so compile again with them before anything is paid. Call
Full technical diff · 2 changed fields

changed /included_files

BEFORE
[
  {
    "relative_path": "references/camera.md",
    "size_in_bytes": 8524
  },
  {
    "relative_path": "references/realism.md",
    "size_in_bytes": 5105
  },
  {
    "relative_path": "references/references.md",
    "size_in_bytes": 2565
  },
  {
    "relative_path": "references/repairs.md",
    "size_in_bytes": 3937
  },
  {
    "relative_path": "references/scene-pictures.md",
    "size_in_bytes": 2695
  },
  {
    "relative_path": "references/seams.md",
    "size_in_bytes": 4262
  },
  {
    "relative_path": "references/seedance.md",
    "size_in_bytes": 5189
  },
  {
    "relative_path": "references/takes.md",
    "size_in_bytes": 2649
  },
  {
    "relative_path": "scripts/keyframes.py",
    "size_in_bytes": 9592
  }
]
AFTER
[
  {
    "relative_path": "references/camera.md",
    "size_in_bytes": 8800
  },
  {
    "relative_path": "references/realism.md",
    "size_in_bytes": 5403
  },
  {
    "relative_path": "references/references.md",
    "size_in_bytes": 3456
  },
  {
    "relative_path": "references/repairs.md",
    "size_in_bytes": 3937
  },
  {
    "relative_path": "references/scene-pictures.md",
    "size_in_bytes": 2855
  },
  {
    "relative_path": "references/seams.md",
    "size_in_bytes": 4262
  },
  {
    "relative_path": "references/seedance.md",
    "size_in_bytes": 6008
  },
  {
    "relative_path": "references/takes.md",
    "size_in_bytes": 2739
  },
  {
    "relative_path": "scripts/keyframes.py",
    "size_in_bytes": 9592
  }
]

changed /skill_md_contents

BEFORE
"---\nname: film-shot-generation\ndescription: Shoot a film's shots as runs - narrowing the video models a film can use, packing shot cards into multi-shot generations, drafting key frames before footage is bought, compiling and verifying every prompt on the server, following the jobs, and routing notes to an edit, an extend or a re-roll. Use when a film's video models are narrowed, or its shots are planned into runs, pictured, generated, checked or repaired. A film the user makes step by step here is carried on by its own use case, which loads this skill when a step needs it.\n---\n\n# Film shots\n\nAuthor every shot on its own; generate them together. The unit of generation is the **run**: as\nmuch of the film as fits one generation at the model's ceiling, scenes included. The model makes\nthe cuts inside it. The cuts it actually made are found and checked against the plan, and the\ntake goes into the cut whole, as generated (film-cutting). Read these\nbefore the step:\n\n| File | Read it before you… |\n|---|---|\n| `references/seams.md` | write how one shot meets the next, or where one run meets the next |\n| `references/camera.md` | choose or write a shot's camera move |\n| `references/realism.md` | write a shot's action, sound and what persists through a run |\n| `references/scene-pictures.md` | make a scene's wide, scene picture or room map |\n| `references/references.md` | put a run's reference images together |\n| `references/takes.md` | check a take's cuts, or judge one |\n| `references/repairs.md` | act on a note about a take |\n| `references/seedance.md` | compile, repair or extend anything on a Seedance model (`seedance-…`); then load the `sd25-pe` skill for Seedance 2.5 or `sd2-pe` for Seedance 2.0 |\n\n## The model\n\nOne video model shoots the whole film, and the runs are packed against its ceiling, so choose it\nbefore the shots are planned.\n\n1. Narrow the video models with `picsart_model_catalog`: `mode: \"video\"`, `purpose: \"generate\"`,\n   `concise: false`. Keep the rows whose `supportedAspectRatios` hold the film's ratio. Edits,\n   extends and upscalers are out. Never filter on `acceptsImage`: the catalog marks models that\n   take reference images as text-to-video (every Seedance), so the filter hides them. A model\n   takes the cast's views when `picsart_model_params` lists `imageUrls` or `startFrame`. A use case\n   or host that names its candidates or the film's model replaces this narrowing; steps 2 and 3\n   still run on what it names.\n2. Read `picsart_model_params` on each model that survives. Keep only those that hold\n   **several cuts inside one generation** at the finish resolution and take enough reference\n   images for a run. Note each one's draft setting (Seedance 2.5's `draft`) or, without one, its\n   lowest resolution: the first batch is shot at it.\n3. For each one kept, find its edit and extend siblings: the `picsart_model_catalog` rows (`concise: false`) from the\n   same provider with `purpose: \"edit\"` that edit or extend a clip. Repairs use them.\n\n## Runs\n\n**Packing.** Read the model's ceiling and accepted durations with `picsart_model_params`; never\nfrom memory. Pack the ordered shots into the fewest runs that fit. A scene change, a climax, a\nclose-up or a hunch that a shot works better alone is not a reason to start a run. Merge adjacent\nruns that fit together, and say which you merged.\n\n**Durations.** A shot's `sec` is its length in the cut. A run's generation length is the sum of its\nshots' `sec`, snapped up to a duration the model accepts. That is the run's `genSec`. The take\nplays whole in the cut and nothing trims it unless the user does, so the prompt describes the\naction from the first frame to the last: no calm beat padded at either end. Inside a run, the\nsilence after a line and a designed tail hold play as screen time.\n\n- The ceiling is a packing limit, not a shot length. Never merge several short actions into one\n  long shot to fill a run.\n- Dramatic shots run three to eight seconds, action shorter. A shot over 8 s carries its reason;\n  over 12 s it is a deliberate long take.\n- A scene of more than 12 s held in one shot gets a recommendation of two to four shots of\n  coverage, with what is lost without it written on its card.\n\n**The cut-by-cut pass.** Walk each scene's neighbouring shots as pairs and write the pair's rule into\nboth blocks (`references/seams.md`). Then four checks on the cards, fixed on the card before\nanything generates:\n\n1. Two shots of the same subject in a row are two sizes apart.\n2. Where a look answers something, the gaze and the thing are on opposite sides of frame.\n3. Screen direction holds through the scene, unless a shot toward or away from camera turns it.\n4. No three shots in a row share both their size and their camera move.\n\n**The run pass.** Give every shot its run and every run its ordered shots, planned cut times (running\nsums of `sec` from zero), generation length, join sentence and ordered references. Planned cuts are\nrequests: the model cuts near them, not on them. If the cards stop fitting the approved plan, or an\nedge falls on a rest, propose the fix; never move an approved edge in silence.\n\nA run that changes a place or a person's state makes later runs wait for its accepted take: their\nframes of the change replace the clean pictures they contradict.\n\n## Key frames\n\nAny video that buys footage, a film or a single generated shot in another kind of video, is first\nseen as stills at its key points, as picsart-video-rules says. Run `scripts/keyframes.py` on the plan's\nbeats: it names each key point (the hook, the turn, the payoff, and the opening of every generated\nbeat), says which of them the user's own footage already shows, and how the video reuses each\nstill. Run it again with the stills before the video is quoted; `ready` stays false until every\ngenerated beat has an approved still.\n\n- A film's scene pictures are its key frames (`references/scene-pictures.md`).\n- Outside a film, make a key frame the way a scene picture is made: at the video's frame, from\n  full-size references. A crop of a screen recording is a low-resolution frame, never a reference.\n- **An approved key frame is used, not thrown away**: it opens its generation as picture 1 of\n  `imageUrls`, or travels as a `FRAME REFERENCE` (`references/references.md`). A still nothing in\n  the video will use is not a key frame.\n\n## Compile and verify\n\nEvery prompt is compiled on the server and passed to `picsart_generate` **verbatim**. The camera,\nlighting and acting language, the house lines and the templates are the compiler's; a paraphrase\nrenders worse. This holds for one shot made for another use case too, such as a screen video's\ngenerated opening: it goes through these steps like a run.\n\n1. **Compile** with `picsart_film_compile_prompt`: `kind` (`run` for a video, `still` or\n   `scene-picture` for a picture, `map`, `edit`), the `model` the prompt is for (its compiler\n   wording follows some models, as `references/seedance.md` says for Seedance), the world's `look`\n   ids (with `look.scheme` and `look.hue` when the setup has them), and what only you can write.\n   On a Seedance model, load the `sd25-pe` skill (Seedance 2.5) or `sd2-pe` (Seedance 2.0) before\n   the first compile of the film and write these inputs by it:\n   - `scene`, `geography` (one line, identical in every prompt of the scene), and `space`:\n     foreground, midground and background, all three named;\n   - `cast`, each with a `tell`, the saved `voice` and its `language`; and `castPresence` whenever someone in\n     `cast` is not in the opening frame: where they are and when and how they enter (\"Tobin is\n     outside; he walks in through the garage door, frame-left, in shot 3\"). The prompt counts\n     every cast member from the first frame, and only this line keeps a latecomer out of it;\n   - `images`: every reference numbered, each with its job;\n   - `shots[]`: `sec`, `subject`, size, arrangement, angle, `fov`, `focus`, `composition`, `move`;\n     `performances` for every person in frame (`action`, `emotion` with the intensity film-story-writing's\n     peak rule sets, `gaze` on a named target); the shot's own `speech`, beside `performances`\n     rather than inside one (`name`, `line`, `delivery`); and the pair's cut rule in its `extra`;\n   - anything more in `extra` or `filmConstraints`, in your own words.\n   - `model`: the id the run will generate with, so a prompt longer than that model takes is\n     refused here, before the plan, not when it runs. The draft and the finish share it: a draft is\n     the same model at its draft setting, and a finish sends the model either no prompt (a draft's\n     `finalizeDraft` handle, an upscale) or this same one again.\n\n   A preset slot you leave empty compiles to a neutral default (a light's direction, the second\n   person from the cast) and `notes` names it: read the notes, and pass the slot only to change it.\n\n   **Pin what the model would re-infer.** It guesses every unstated fact frame by frame, and the\n   glitches come from those guesses. In `extra` and the performances:\n   - a moving mechanism states its fixed geometry once (the hinge side and swing of a door, the\n     grip and stroke of a tool) and every action names its instrument: water pours from the kettle,\n     never \"she pours\" from a bag of beans;\n   - list what may move (people, tools, the camera) and pin the rest still; every spark, smoke or\n     sound has an owner on frame or a cause off it, or the model invents one, usually the nearest\n     person;\n   - one primary action per person per shot; a change of tool is its own written step.\n\n   **Every shot passes its `fov`, `focus` and `composition`**, whether the card's value was seeded\n   or changed: the setup carries no focal length, so a skipped lens leaves the model choosing one.\n   An `auto` focus or composition writes nothing. A card from an older board may carry an f-stop\n   as `aperture` instead; pass it as it came. A light writes a line only when the user changed it, and then every\n   shot of its scene carries the scene's colour temperature and dark side in its `extra`, as\n   film-story-writing sets them; a palette other than `auto` always does.\n2. **Verify: compile with `verifyWith`, then read the result's `check`.** `check` is\n   `picsart_film_verify_prompt` already run on that prompt and its `blocks`, against what you pass\n   in `verifyWith`: `approved` from the approved board (its lines, never the ones you typed into\n   `speech`), `request` with the other arguments you will send to picsart_generate (`generateAudio`,\n   `imageUrls`), `film` with the saved assets and their views, and `limits` from\n   `picsart_model_params`. Never retype the prompt into verify. A failed check is fixed in the\n   inputs and compiled again; a check whose `skipped` names the board, the lines or the reference\n   budget has not checked them, so compile again with them before anything is paid. Call\n   `picsart_film_verify_prompt` yourself only for a prompt changed after compiling. The\n   checks cover what is string matching and arithmetic. It does not judge the writing: read every character's\n   action, emotion and gaze, the entrances and exits, the props, the cut motivation and the joins\n   yourself.\n   - `kind` decides which house lines are required and which are forbidden (a still with a shutter\n     angle or a soundtrack is as wrong as a run without them); `resolvedKind` names the rules that\n     ran (`still` runs as `scene-picture`, `portrait` and `profile` as `sheet`).\n   - The approved `cast` is everyone who appears at any point, latecomers included: counting only\n     shot 1 is the usual mistake. A silent shot carries `dialogue: []`, never an omitted field.\n   - It also checks each approved line reproduced exactly and in order, each speaker's saved voice\n     in full, a line against its shot's seconds, quotation marks around anything but the approved\n     line (the model speaks them aloud), the reference budget with every named character's views\n     among them, the banned performance adjectives, and blocks that describe another shot.\n   - An `extra` object merges over the top-level keys as a host merges it; a key given twice with\n     two different values is refused. Without `approved`, the prompt-level checks still run and\n     `skipped` names the rest. It never flags text for being unrecognised.\n3. **A palette warning stops the dispatch.** When the compiler's `notes` say a shot's palette\n   argues with the film's scheme, nothing is generated from that prompt. Flag the shot with its\n   three options: keep the palette, drop it to `auto`, or swap it for one inside the scheme.\n4. **A failure is fixed at the source**: the inputs corrected, compiled again, verified again. A\n   finding on a user-owned value (a shot's seconds, a line, a lens, a light) goes back to the user,\n   never quietly changed. A prompt changed after compiling is compiled again; an old token never\n   covers new text.\n\nNever paste a descriptor into a run prompt: the references carry identity, and the prompt names\nthem by number. Prompts describe what is there, not a list of negatives; a video takes no negative\nprompt.\n\n## Voice\n\n- The film keeps the voice its takes are born with. Native audio is on for any run with a line, off\n  for a run without one.\n- Every speaking block carries the speaker's saved voice line verbatim, repairs and extends\n  included. Emotion and loudness go in the delivery.\n- Every line has a beat of silence after it inside its shot. A line running into the cut fails.\n- A shared run and a voice line do not guarantee one timbre across takes. Listen for it in review.\n\n## Dispatch and follow\n\n- `picsart_generate` is asynchronous, and a batch of runs goes out as picsart-video-rules says: one call\n  with one `items` entry per run, sent before you follow any. The call passes the model, the\n  `folderUid` the shots are filed in and the shared `aspectRatio`; each entry passes its run's\n  compiled prompt, `imageUrls`, `duration`, and model-specific settings in `extra` as\n  `picsart_model_params` names them. **Every reference\n  travels in `imageUrls`**, and no other image parameter is set: a frame travels as picture 1 of\n  `imageUrls`.\n- **Runs are shot as drafts, all in one batch**: at the model's draft setting as\n  `picsart_model_params` names it (Seedance 2.5's `draft: true`, 480p), or else its lowest\n  resolution. The user sees the whole cut quickly, for a fraction of the finish. There is no test\n  run before the others. A run keeps its `genSec`, its compiled prompt and its references: the\n  finish uses them. A repair made while the draft cut is reviewed (an edit, an extend, a re-roll)\n  is shot as a draft too, and finished with the rest. A model with neither a draft setting nor a\n  lower resolution shoots at its finish settings, and its takes need no finish.\n- **The quote is the draft batch, with the finish beside it as an estimate.** One yes buys the\n  drafts. **The finish is a second spend with its own yes, after the user approves the draft cut**,\n  as film-finishing says: a draft that returned `finalizeDraft` is finished from it (the same take\n  at the finish settings, not a new roll; an edit or extend draft finishes on its base model, as\n  the handle says); otherwise an upscale, or the approved runs generated again at the finish\n  settings with their saved prompts. A draft can be finished from its handle for 7 days; an older\n  one is generated again.\n- The batch's own card follows its jobs and reports back, as picsart-video-rules says. Label each run's\n  entry with the run's shots.\n- **A dropped or timed-out call is not a failed generation.** The job is usually still running and\n  charging. Check it with `picsart_job_status` on its handle as picsart-video-rules says, passing the\n  `folderUid` again; never submit it again. Once it is COMPLETED, save the take into the Shots\n  folder with `picsart_drive_upload`: polling never files it. A Seedance draft is the one\n  exception: its render already saved it into `folderUid`, so it is never uploaded again.\n- A job still running at the end of a turn: say what is running and that you will pick it up. A\n  batch that lands is checked and judged in that turn (`references/takes.md`); the user reviews the\n  takes inside the cut, when the use case says.\n\n## Traps\n\n- A run shot as a test before the others, unasked: it is bought twice.\n- The first batch shot at the finish settings when the model has a draft setting or a lower\n  resolution: the user pays the full price before seeing the cut.\n- Finishing a take before the user approved the draft cut, or on the draft batch's yes.\n- A Seedance draft generated again at the finish settings while its handle is still valid: it is\n  finished from the handle.\n- Shooting shot by shot, or splitting runs for emphasis when the same shots fit fewer runs.\n- Treating the model's ceiling as a reason to make one long shot.\n- A prompt typed by hand, or a compiled one edited without compiling again.\n- A verification pass read as approval of the footage.\n- A panel pointer, a contact-sheet thumbnail or a low-resolution frame sent as a reference.\n- A reference passed outside `imageUrls`; an identity or wardrobe view left out; references reordered without\n  compiling again.\n- The geography line dropped, so people swap sides between shots.\n- Readable text asked of a video or a still. Signs and screens are added in the edit.\n- Resubmitting after a dropped call instead of checking its job.\n"
AFTER
"---\nname: film-shot-generation\ndescription: Shoot a film's shots as runs - narrowing the video models a film can use, packing shot cards into multi-shot generations, drafting key frames before footage is bought, compiling and verifying every prompt on the server, following the jobs, and routing notes to an edit, an extend or a re-roll. Use when a film's video models are narrowed, or its shots are planned into runs, pictured, generated, checked or repaired. A film the user makes step by step here is carried on by its own use case, which loads this skill when a step needs it.\n---\n\n# Film shots\n\nAuthor every shot on its own; generate them together. The unit of generation is the **run**: as\nmuch of the film as fits one generation at the model's ceiling, scenes included. The model makes\nthe cuts inside it. The cuts it actually made are found and checked against the plan, and the\ntake goes into the cut whole, as generated (film-cutting). Read these\nbefore the step:\n\n| File | Read it before you… |\n|---|---|\n| `references/seams.md` | write how one shot meets the next, or where one run meets the next |\n| `references/camera.md` | choose or write a shot's camera move |\n| `references/realism.md` | write a shot's action, sound and what persists through a run |\n| `references/scene-pictures.md` | make a scene's wide, scene picture or room map |\n| `references/references.md` | put a run's reference images together |\n| `references/takes.md` | check a take's cuts, or judge one |\n| `references/repairs.md` | act on a note about a take |\n| `references/seedance.md` | compile, repair or extend anything on a Seedance model (`seedance-…`); then load the `sd25-pe` skill for Seedance 2.5 or `sd2-pe` for Seedance 2.0 |\n\n## The model\n\nOne video model shoots the whole film, and the runs are packed against its ceiling, so choose it\nbefore the shots are planned.\n\n1. Narrow the video models with `picsart_model_catalog`: `mode: \"video\"`, `purpose: \"generate\"`,\n   `concise: false`. Keep the rows whose `supportedAspectRatios` hold the film's ratio. Edits,\n   extends and upscalers are out. Never filter on `acceptsImage`: the catalog marks models that\n   take reference images as text-to-video (every Seedance), so the filter hides them. A model\n   takes the cast's views when `picsart_model_params` lists `imageUrls` or `startFrame`. A use case\n   or host that names its candidates or the film's model replaces this narrowing; steps 2 and 3\n   still run on what it names.\n2. Read `picsart_model_params` on each model that survives. Keep only those that hold\n   **several cuts inside one generation** at the finish resolution and take enough reference\n   images for a run. Note each one's draft setting (Seedance 2.5's `draft`) or, without one, its\n   lowest resolution: the first batch is shot at it.\n3. For each one kept, find its edit and extend siblings: the `picsart_model_catalog` rows (`concise: false`) from the\n   same provider with `purpose: \"edit\"` that edit or extend a clip. Repairs use them.\n\n## Runs\n\n**Packing.** Read the model's ceiling and accepted durations with `picsart_model_params`; never\nfrom memory. Pack the ordered shots into the fewest runs that fit. A scene change, a climax, a\nclose-up or a hunch that a shot works better alone is not a reason to start a run. Merge adjacent\nruns that fit together, and say which you merged.\n\n**Durations.** A shot's `sec` is its length in the cut. A run's generation length is the sum of its\nshots' `sec`, snapped up to a duration the model accepts. That is the run's `genSec`. The take\nplays whole in the cut and nothing trims it unless the user does, so the prompt describes the\naction from the first frame to the last: no calm beat padded at either end. Inside a run, the\nsilence after a line and a designed tail hold play as screen time.\n\n- The ceiling is a packing limit, not a shot length. Never merge several short actions into one\n  long shot to fill a run.\n- Dramatic shots run three to eight seconds, action shorter. A shot over 8 s carries its reason;\n  over 12 s it is a deliberate long take.\n- A scene of more than 12 s held in one shot gets a recommendation of two to four shots of\n  coverage, with what is lost without it written on its card.\n\n**The cut-by-cut pass.** Walk each scene's neighbouring shots as pairs and write the pair's rule into\nboth blocks (`references/seams.md`). Then four checks on the cards, fixed on the card before\nanything generates:\n\n1. Two shots of the same subject in a row are two sizes apart.\n2. Where a look answers something, the gaze and the thing are on opposite sides of frame.\n3. Screen direction holds through the scene, unless a shot toward or away from camera turns it.\n4. No three shots in a row share both their size and their camera move.\n\n**The run pass.** Give every shot its run and every run its ordered shots, planned cut times (running\nsums of `sec` from zero), generation length, join sentence and ordered references. Planned cuts are\nrequests: the model cuts near them, not on them. If the cards stop fitting the approved plan, or an\nedge falls on a rest, propose the fix; never move an approved edge in silence.\n\nA run that changes a place or a person's state makes later runs wait for its accepted take: their\nframes of the change replace the clean pictures they contradict.\n\n## Key frames\n\nAny video that buys footage, a film or a single generated shot in another kind of video, is first\nseen as stills at its key points, as picsart-video-rules says. Run `scripts/keyframes.py` on the plan's\nbeats: it names each key point (the hook, the turn, the payoff, and the opening of every generated\nbeat), says which of them the user's own footage already shows, and how the video reuses each\nstill. Run it again with the stills before the video is quoted; `ready` stays false until every\ngenerated beat has an approved still.\n\n- A film's scene pictures are its key frames (`references/scene-pictures.md`).\n- Outside a film, make a key frame the way a scene picture is made: at the video's frame, from\n  full-size references. A crop of a screen recording is a low-resolution frame, never a reference.\n- **An approved key frame is used, not thrown away**: it opens its generation as picture 1 of\n  `imageUrls`, or travels as a `FRAME REFERENCE` (`references/references.md`). A still nothing in\n  the video will use is not a key frame.\n\n## Compile and verify\n\nEvery prompt is compiled on the server and passed to `picsart_generate` **verbatim**. The camera,\nlighting and acting language, the house lines and the templates are the compiler's; a paraphrase\nrenders worse. This holds for one shot made for another use case too, such as a screen video's\ngenerated opening: it goes through these steps like a run.\n\n1. **Compile** with `picsart_film_compile_prompt`: `kind` (`run` for a video, `still` or\n   `scene-picture` for a picture, `map`, `edit`), the `model` the prompt is for (its compiler\n   wording follows some models, as `references/seedance.md` says for Seedance), the world's `look`\n   ids (with `look.scheme` and `look.hue` when the setup has them), and what only you can write.\n   On a Seedance model, load the `sd25-pe` skill (Seedance 2.5) or `sd2-pe` (Seedance 2.0) before\n   the first compile of the film and write these inputs by it:\n   - `scene`, `geography` (one line, identical in every prompt of the scene), and `space`:\n     foreground, midground and background, all three named;\n   - `cast`, each with a `tell`, the saved `voice` and its `language`; and `castPresence` whenever someone in\n     `cast` is not in the opening frame: where they are and when and how they enter (\"Tobin is\n     outside; he walks in through the garage door, frame-left, in shot 3\"). The prompt counts\n     every cast member from the first frame, and only this line keeps a latecomer out of it;\n   - `images`: every reference numbered, each with its job;\n   - `shots[]`: `sec`, `subject`, size, arrangement, angle, `fov`, `focus`, `composition`, `move`;\n     `performances` for every person in frame (`action`, `emotion` with the intensity film-story-writing's\n     peak rule sets, `gaze` on a named target); the shot's own `speech`, beside `performances`\n     rather than inside one (`name`, `line`, `delivery`); and the pair's cut rule in its `extra`;\n   - anything more in `extra` or `filmConstraints`, in your own words.\n   - `model`: the id the run will generate with, so a prompt longer than that model takes is\n     refused here, before the plan, not when it runs. The draft and the finish share it: a draft is\n     the same model at its draft setting, and a finish sends the model either no prompt (a draft's\n     `finalizeDraft` handle, an upscale) or this same one again.\n\n   A preset slot you leave empty compiles to a neutral default (a light's direction, the second\n   person from the cast) and `notes` names it: read the notes, and pass the slot only to change it.\n\n   **Pin what the model would re-infer.** It guesses every unstated fact frame by frame, and the\n   glitches come from those guesses. In `extra` and the performances:\n   - a moving mechanism states its fixed geometry once (the hinge side and swing of a door, the\n     grip and stroke of a tool) and every action names its instrument: water pours from the kettle,\n     never \"she pours\" from a bag of beans;\n   - list what may move (people, tools, the camera) and pin the rest still; every spark, smoke or\n     sound has an owner on frame or a cause off it, or the model invents one, usually the nearest\n     person;\n   - one primary action per person per shot; a change of tool is its own written step.\n\n   **Every shot passes its `fov`, `focus` and `composition`**, whether the card's value was seeded\n   or changed: the setup carries no focal length, so a skipped lens leaves the model choosing one.\n   An `auto` focus or composition writes nothing. A card from an older board may carry an f-stop\n   as `aperture` instead; pass it as it came. A light writes a line only when the user changed it, and then every\n   shot of its scene carries the scene's colour temperature and dark side in its `extra`, as\n   film-story-writing sets them; a palette other than `auto` always does.\n2. **Verify: compile with `verifyWith`, then read the result's `check`.** `check` is\n   `picsart_film_verify_prompt` already run on that prompt and its `blocks`, against what you pass\n   in `verifyWith`: `approved` from the approved board (its lines, never the ones you typed into\n   `speech`), `request` with the other arguments you will send to picsart_generate (`generateAudio`,\n   `imageUrls`), `film` with the saved assets, their `identityReferences` and views, and `limits` from\n   `picsart_model_params`. Never retype the prompt into verify. A failed check is fixed in the\n   inputs and compiled again; a check whose `skipped` names the board, the lines or the reference\n   budget has not checked them, so compile again with them before anything is paid. Call\n   `picsart_film_verify_prompt` yourself only for a prompt changed after compiling. The\n   checks cover what is string matching and arithmetic. It does not judge the writing: read every character's\n   action, emotion and gaze, the entrances and exits, the props, the cut motivation and the joins\n   yourself.\n   - `kind` decides which house lines are required and which are forbidden (a still with a shutter\n     angle or a soundtrack is as wrong as a run without them); `resolvedKind` names the rules that\n     ran (`still` runs as `scene-picture`, `portrait` and `profile` as `sheet`).\n   - The approved `cast` is everyone who appears at any point, latecomers included: counting only\n     shot 1 is the usual mistake. A silent shot carries `dialogue: []`, never an omitted field.\n   - It also checks each approved line reproduced exactly and in order, each speaker's saved voice\n     in full, a line against its shot's seconds, quotation marks around anything but the approved\n     line (the model speaks them aloud), the reference budget with every named character's views\n     among them, the banned performance adjectives, and blocks that describe another shot.\n   - An `extra` object merges over the top-level keys as a host merges it; a key given twice with\n     two different values is refused. Without `approved`, the prompt-level checks still run and\n     `skipped` names the rest. It never flags text for being unrecognised.\n3. **A palette warning stops the dispatch.** When the compiler's `notes` say a shot's palette\n   argues with the film's scheme, nothing is generated from that prompt. Flag the shot with its\n   three options: keep the palette, drop it to `auto`, or swap it for one inside the scheme.\n4. **A failure is fixed at the source**: the inputs corrected, compiled again, verified again. A\n   finding on a user-owned value (a shot's seconds, a line, a lens, a light) goes back to the user,\n   never quietly changed. A prompt changed after compiling is compiled again; an old token never\n   covers new text.\n\nNever paste a descriptor into a run prompt: the references carry identity, and the prompt names\nthem by number. Prompts describe what is there, not a list of negatives; a video takes no negative\nprompt.\n\n## Voice\n\n- The film keeps the voice its takes are born with. Native audio is on for any run with a line, off\n  for a run without one.\n- Every speaking block carries the speaker's saved voice line verbatim, repairs and extends\n  included. Emotion and loudness go in the delivery.\n- Every line has a beat of silence after it inside its shot. A line running into the cut fails.\n- A shared run and a voice line do not guarantee one timbre across takes. Listen for it in review.\n\n## Dispatch and follow\n\n- `picsart_generate` is asynchronous, and a batch of runs goes out as picsart-video-rules says: one call\n  with one `items` entry per run, sent before you follow any. The call passes the model, the\n  `folderUid` the shots are filed in and the shared `aspectRatio`; each entry passes its run's\n  compiled prompt, `imageUrls`, `duration`, and model-specific settings in `extra` as\n  `picsart_model_params` names them. **Every reference\n  travels in `imageUrls`**, and no other image parameter is set: a frame travels as picture 1 of\n  `imageUrls`.\n- **Runs are shot as drafts, all in one batch**: at the model's draft setting as\n  `picsart_model_params` names it (Seedance 2.5's `draft: true`, 480p), or else its lowest\n  resolution. The user sees the whole cut quickly, for a fraction of the finish. There is no test\n  run before the others. A run keeps its `genSec`, its compiled prompt and its references: the\n  finish uses them. A repair made while the draft cut is reviewed (an edit, an extend, a re-roll)\n  is shot as a draft too, and finished with the rest. A model with neither a draft setting nor a\n  lower resolution shoots at its finish settings, and its takes need no finish.\n- **The quote is the draft batch, with the finish beside it as an estimate.** One yes buys the\n  drafts. **The finish is a second spend with its own yes, after the user approves the draft cut**,\n  as film-finishing says: a draft that returned `finalizeDraft` is finished from it (the same take\n  at the finish settings, not a new roll; an edit or extend draft finishes on its base model, as\n  the handle says); otherwise an upscale, or the approved runs generated again at the finish\n  settings with their saved prompts. A draft can be finished from its handle for 7 days; an older\n  one is generated again.\n- The batch's own card follows its jobs and reports back, as picsart-video-rules says. Label each run's\n  entry with the run's shots.\n- **A dropped or timed-out call is not a failed generation.** The job is usually still running and\n  charging. Check it with `picsart_job_status` on its handle as picsart-video-rules says, passing the\n  `folderUid` again; never submit it again. Once it is COMPLETED, save the take into the Shots\n  folder with `picsart_drive_upload`: polling never files it. A Seedance draft is the one\n  exception: its render already saved it into `folderUid`, so it is never uploaded again.\n- A job still running at the end of a turn: say what is running and that you will pick it up. A\n  batch that lands is checked and judged in that turn (`references/takes.md`); the user reviews the\n  takes inside the cut, when the use case says.\n\n## Traps\n\n- A run shot as a test before the others, unasked: it is bought twice.\n- The first batch shot at the finish settings when the model has a draft setting or a lower\n  resolution: the user pays the full price before seeing the cut.\n- Finishing a take before the user approved the draft cut, or on the draft batch's yes.\n- A Seedance draft generated again at the finish settings while its handle is still valid: it is\n  finished from the handle.\n- Shooting shot by shot, or splitting runs for emphasis when the same shots fit fewer runs.\n- Treating the model's ceiling as a reason to make one long shot.\n- A prompt typed by hand, or a compiled one edited without compiling again.\n- A verification pass read as approval of the footage.\n- A panel pointer, a contact-sheet thumbnail or a low-resolution frame sent as a reference.\n- A reference passed outside `imageUrls`; an identity or wardrobe view left out; references reordered without\n  compiling again.\n- The geography line dropped, so people swap sides between shots.\n- Readable text asked of a video or a still. Signs and screens are added in the edit.\n- Resubmitting after a dropped call instead of checking its job.\n"
Full snapshot data
{
  "description": "Shoot a film's shots as runs - narrowing the video models a film can use, packing shot cards into multi-shot generations, drafting key frames before footage is bought, compiling and verifying every prompt on the server, following the jobs, and routing notes to an edit, an extend or a re-roll. Use when a film's video models are narrowed, or its shots are planned into runs, pictured, generated, checked or repaired. A film the user makes step by step here is carried on by its own use case, which loads this skill when a step needs it.",
  "included_files": [
    {
      "relative_path": "references/camera.md",
      "size_in_bytes": 8800
    },
    {
      "relative_path": "references/realism.md",
      "size_in_bytes": 5403
    },
    {
      "relative_path": "references/references.md",
      "size_in_bytes": 3456
    },
    {
      "relative_path": "references/repairs.md",
      "size_in_bytes": 3937
    },
    {
      "relative_path": "references/scene-pictures.md",
      "size_in_bytes": 2855
    },
    {
      "relative_path": "references/seams.md",
      "size_in_bytes": 4262
    },
    {
      "relative_path": "references/seedance.md",
      "size_in_bytes": 6008
    },
    {
      "relative_path": "references/takes.md",
      "size_in_bytes": 2739
    },
    {
      "relative_path": "scripts/keyframes.py",
      "size_in_bytes": 9592
    }
  ],
  "name": "film-shot-generation",
  "skill_md_contents": "---\nname: film-shot-generation\ndescription: Shoot a film's shots as runs - narrowing the video models a film can use, packing shot cards into multi-shot generations, drafting key frames before footage is bought, compiling and verifying every prompt on the server, following the jobs, and routing notes to an edit, an extend or a re-roll. Use when a film's video models are narrowed, or its shots are planned into runs, pictured, generated, checked or repaired. A film the user makes step by step here is carried on by its own use case, which loads this skill when a step needs it.\n---\n\n# Film shots\n\nAuthor every shot on its own; generate them together. The unit of generation is the **run**: as\nmuch of the film as fits one generation at the model's ceiling, scenes included. The model makes\nthe cuts inside it. The cuts it actually made are found and checked against the plan, and the\ntake goes into the cut whole, as generated (film-cutting). Read these\nbefore the step:\n\n| File | Read it before you… |\n|---|---|\n| `references/seams.md` | write how one shot meets the next, or where one run meets the next |\n| `references/camera.md` | choose or write a shot's camera move |\n| `references/realism.md` | write a shot's action, sound and what persists through a run |\n| `references/scene-pictures.md` | make a scene's wide, scene picture or room map |\n| `references/references.md` | put a run's reference images together |\n| `references/takes.md` | check a take's cuts, or judge one |\n| `references/repairs.md` | act on a note about a take |\n| `references/seedance.md` | compile, repair or extend anything on a Seedance model (`seedance-…`); then load the `sd25-pe` skill for Seedance 2.5 or `sd2-pe` for Seedance 2.0 |\n\n## The model\n\nOne video model shoots the whole film, and the runs are packed against its ceiling, so choose it\nbefore the shots are planned.\n\n1. Narrow the video models with `picsart_model_catalog`: `mode: \"video\"`, `purpose: \"generate\"`,\n   `concise: false`. Keep the rows whose `supportedAspectRatios` hold the film's ratio. Edits,\n   extends and upscalers are out. Never filter on `acceptsImage`: the catalog marks models that\n   take reference images as text-to-video (every Seedance), so the filter hides them. A model\n   takes the cast's views when `picsart_model_params` lists `imageUrls` or `startFrame`. A use case\n   or host that names its candidates or the film's model replaces this narrowing; steps 2 and 3\n   still run on what it names.\n2. Read `picsart_model_params` on each model that survives. Keep only those that hold\n   **several cuts inside one generation** at the finish resolution and take enough reference\n   images for a run. Note each one's draft setting (Seedance 2.5's `draft`) or, without one, its\n   lowest resolution: the first batch is shot at it.\n3. For each one kept, find its edit and extend siblings: the `picsart_model_catalog` rows (`concise: false`) from the\n   same provider with `purpose: \"edit\"` that edit or extend a clip. Repairs use them.\n\n## Runs\n\n**Packing.** Read the model's ceiling and accepted durations with `picsart_model_params`; never\nfrom memory. Pack the ordered shots into the fewest runs that fit. A scene change, a climax, a\nclose-up or a hunch that a shot works better alone is not a reason to start a run. Merge adjacent\nruns that fit together, and say which you merged.\n\n**Durations.** A shot's `sec` is its length in the cut. A run's generation length is the sum of its\nshots' `sec`, snapped up to a duration the model accepts. That is the run's `genSec`. The take\nplays whole in the cut and nothing trims it unless the user does, so the prompt describes the\naction from the first frame to the last: no calm beat padded at either end. Inside a run, the\nsilence after a line and a designed tail hold play as screen time.\n\n- The ceiling is a packing limit, not a shot length. Never merge several short actions into one\n  long shot to fill a run.\n- Dramatic shots run three to eight seconds, action shorter. A shot over 8 s carries its reason;\n  over 12 s it is a deliberate long take.\n- A scene of more than 12 s held in one shot gets a recommendation of two to four shots of\n  coverage, with what is lost without it written on its card.\n\n**The cut-by-cut pass.** Walk each scene's neighbouring shots as pairs and write the pair's rule into\nboth blocks (`references/seams.md`). Then four checks on the cards, fixed on the card before\nanything generates:\n\n1. Two shots of the same subject in a row are two sizes apart.\n2. Where a look answers something, the gaze and the thing are on opposite sides of frame.\n3. Screen direction holds through the scene, unless a shot toward or away from camera turns it.\n4. No three shots in a row share both their size and their camera move.\n\n**The run pass.** Give every shot its run and every run its ordered shots, planned cut times (running\nsums of `sec` from zero), generation length, join sentence and ordered references. Planned cuts are\nrequests: the model cuts near them, not on them. If the cards stop fitting the approved plan, or an\nedge falls on a rest, propose the fix; never move an approved edge in silence.\n\nA run that changes a place or a person's state makes later runs wait for its accepted take: their\nframes of the change replace the clean pictures they contradict.\n\n## Key frames\n\nAny video that buys footage, a film or a single generated shot in another kind of video, is first\nseen as stills at its key points, as picsart-video-rules says. Run `scripts/keyframes.py` on the plan's\nbeats: it names each key point (the hook, the turn, the payoff, and the opening of every generated\nbeat), says which of them the user's own footage already shows, and how the video reuses each\nstill. Run it again with the stills before the video is quoted; `ready` stays false until every\ngenerated beat has an approved still.\n\n- A film's scene pictures are its key frames (`references/scene-pictures.md`).\n- Outside a film, make a key frame the way a scene picture is made: at the video's frame, from\n  full-size references. A crop of a screen recording is a low-resolution frame, never a reference.\n- **An approved key frame is used, not thrown away**: it opens its generation as picture 1 of\n  `imageUrls`, or travels as a `FRAME REFERENCE` (`references/references.md`). A still nothing in\n  the video will use is not a key frame.\n\n## Compile and verify\n\nEvery prompt is compiled on the server and passed to `picsart_generate` **verbatim**. The camera,\nlighting and acting language, the house lines and the templates are the compiler's; a paraphrase\nrenders worse. This holds for one shot made for another use case too, such as a screen video's\ngenerated opening: it goes through these steps like a run.\n\n1. **Compile** with `picsart_film_compile_prompt`: `kind` (`run` for a video, `still` or\n   `scene-picture` for a picture, `map`, `edit`), the `model` the prompt is for (its compiler\n   wording follows some models, as `references/seedance.md` says for Seedance), the world's `look`\n   ids (with `look.scheme` and `look.hue` when the setup has them), and what only you can write.\n   On a Seedance model, load the `sd25-pe` skill (Seedance 2.5) or `sd2-pe` (Seedance 2.0) before\n   the first compile of the film and write these inputs by it:\n   - `scene`, `geography` (one line, identical in every prompt of the scene), and `space`:\n     foreground, midground and background, all three named;\n   - `cast`, each with a `tell`, the saved `voice` and its `language`; and `castPresence` whenever someone in\n     `cast` is not in the opening frame: where they are and when and how they enter (\"Tobin is\n     outside; he walks in through the garage door, frame-left, in shot 3\"). The prompt counts\n     every cast member from the first frame, and only this line keeps a latecomer out of it;\n   - `images`: every reference numbered, each with its job;\n   - `shots[]`: `sec`, `subject`, size, arrangement, angle, `fov`, `focus`, `composition`, `move`;\n     `performances` for every person in frame (`action`, `emotion` with the intensity film-story-writing's\n     peak rule sets, `gaze` on a named target); the shot's own `speech`, beside `performances`\n     rather than inside one (`name`, `line`, `delivery`); and the pair's cut rule in its `extra`;\n   - anything more in `extra` or `filmConstraints`, in your own words.\n   - `model`: the id the run will generate with, so a prompt longer than that model takes is\n     refused here, before the plan, not when it runs. The draft and the finish share it: a draft is\n     the same model at its draft setting, and a finish sends the model either no prompt (a draft's\n     `finalizeDraft` handle, an upscale) or this same one again.\n\n   A preset slot you leave empty compiles to a neutral default (a light's direction, the second\n   person from the cast) and `notes` names it: read the notes, and pass the slot only to change it.\n\n   **Pin what the model would re-infer.** It guesses every unstated fact frame by frame, and the\n   glitches come from those guesses. In `extra` and the performances:\n   - a moving mechanism states its fixed geometry once (the hinge side and swing of a door, the\n     grip and stroke of a tool) and every action names its instrument: water pours from the kettle,\n     never \"she pours\" from a bag of beans;\n   - list what may move (people, tools, the camera) and pin the rest still; every spark, smoke or\n     sound has an owner on frame or a cause off it, or the model invents one, usually the nearest\n     person;\n   - one primary action per person per shot; a change of tool is its own written step.\n\n   **Every shot passes its `fov`, `focus` and `composition`**, whether the card's value was seeded\n   or changed: the setup carries no focal length, so a skipped lens leaves the model choosing one.\n   An `auto` focus or composition writes nothing. A card from an older board may carry an f-stop\n   as `aperture` instead; pass it as it came. A light writes a line only when the user changed it, and then every\n   shot of its scene carries the scene's colour temperature and dark side in its `extra`, as\n   film-story-writing sets them; a palette other than `auto` always does.\n2. **Verify: compile with `verifyWith`, then read the result's `check`.** `check` is\n   `picsart_film_verify_prompt` already run on that prompt and its `blocks`, against what you pass\n   in `verifyWith`: `approved` from the approved board (its lines, never the ones you typed into\n   `speech`), `request` with the other arguments you will send to picsart_generate (`generateAudio`,\n   `imageUrls`), `film` with the saved assets, their `identityReferences` and views, and `limits` from\n   `picsart_model_params`. Never retype the prompt into verify. A failed check is fixed in the\n   inputs and compiled again; a check whose `skipped` names the board, the lines or the reference\n   budget has not checked them, so compile again with them before anything is paid. Call\n   `picsart_film_verify_prompt` yourself only for a prompt changed after compiling. The\n   checks cover what is string matching and arithmetic. It does not judge the writing: read every character's\n   action, emotion and gaze, the entrances and exits, the props, the cut motivation and the joins\n   yourself.\n   - `kind` decides which house lines are required and which are forbidden (a still with a shutter\n     angle or a soundtrack is as wrong as a run without them); `resolvedKind` names the rules that\n     ran (`still` runs as `scene-picture`, `portrait` and `profile` as `sheet`).\n   - The approved `cast` is everyone who appears at any point, latecomers included: counting only\n     shot 1 is the usual mistake. A silent shot carries `dialogue: []`, never an omitted field.\n   - It also checks each approved line reproduced exactly and in order, each speaker's saved voice\n     in full, a line against its shot's seconds, quotation marks around anything but the approved\n     line (the model speaks them aloud), the reference budget with every named character's views\n     among them, the banned performance adjectives, and blocks that describe another shot.\n   - An `extra` object merges over the top-level keys as a host merges it; a key given twice with\n     two different values is refused. Without `approved`, the prompt-level checks still run and\n     `skipped` names the rest. It never flags text for being unrecognised.\n3. **A palette warning stops the dispatch.** When the compiler's `notes` say a shot's palette\n   argues with the film's scheme, nothing is generated from that prompt. Flag the shot with its\n   three options: keep the palette, drop it to `auto`, or swap it for one inside the scheme.\n4. **A failure is fixed at the source**: the inputs corrected, compiled again, verified again. A\n   finding on a user-owned value (a shot's seconds, a line, a lens, a light) goes back to the user,\n   never quietly changed. A prompt changed after compiling is compiled again; an old token never\n   covers new text.\n\nNever paste a descriptor into a run prompt: the references carry identity, and the prompt names\nthem by number. Prompts describe what is there, not a list of negatives; a video takes no negative\nprompt.\n\n## Voice\n\n- The film keeps the voice its takes are born with. Native audio is on for any run with a line, off\n  for a run without one.\n- Every speaking block carries the speaker's saved voice line verbatim, repairs and extends\n  included. Emotion and loudness go in the delivery.\n- Every line has a beat of silence after it inside its shot. A line running into the cut fails.\n- A shared run and a voice line do not guarantee one timbre across takes. Listen for it in review.\n\n## Dispatch and follow\n\n- `picsart_generate` is asynchronous, and a batch of runs goes out as picsart-video-rules says: one call\n  with one `items` entry per run, sent before you follow any. The call passes the model, the\n  `folderUid` the shots are filed in and the shared `aspectRatio`; each entry passes its run's\n  compiled prompt, `imageUrls`, `duration`, and model-specific settings in `extra` as\n  `picsart_model_params` names them. **Every reference\n  travels in `imageUrls`**, and no other image parameter is set: a frame travels as picture 1 of\n  `imageUrls`.\n- **Runs are shot as drafts, all in one batch**: at the model's draft setting as\n  `picsart_model_params` names it (Seedance 2.5's `draft: true`, 480p), or else its lowest\n  resolution. The user sees the whole cut quickly, for a fraction of the finish. There is no test\n  run before the others. A run keeps its `genSec`, its compiled prompt and its references: the\n  finish uses them. A repair made while the draft cut is reviewed (an edit, an extend, a re-roll)\n  is shot as a draft too, and finished with the rest. A model with neither a draft setting nor a\n  lower resolution shoots at its finish settings, and its takes need no finish.\n- **The quote is the draft batch, with the finish beside it as an estimate.** One yes buys the\n  drafts. **The finish is a second spend with its own yes, after the user approves the draft cut**,\n  as film-finishing says: a draft that returned `finalizeDraft` is finished from it (the same take\n  at the finish settings, not a new roll; an edit or extend draft finishes on its base model, as\n  the handle says); otherwise an upscale, or the approved runs generated again at the finish\n  settings with their saved prompts. A draft can be finished from its handle for 7 days; an older\n  one is generated again.\n- The batch's own card follows its jobs and reports back, as picsart-video-rules says. Label each run's\n  entry with the run's shots.\n- **A dropped or timed-out call is not a failed generation.** The job is usually still running and\n  charging. Check it with `picsart_job_status` on its handle as picsart-video-rules says, passing the\n  `folderUid` again; never submit it again. Once it is COMPLETED, save the take into the Shots\n  folder with `picsart_drive_upload`: polling never files it. A Seedance draft is the one\n  exception: its render already saved it into `folderUid`, so it is never uploaded again.\n- A job still running at the end of a turn: say what is running and that you will pick it up. A\n  batch that lands is checked and judged in that turn (`references/takes.md`); the user reviews the\n  takes inside the cut, when the use case says.\n\n## Traps\n\n- A run shot as a test before the others, unasked: it is bought twice.\n- The first batch shot at the finish settings when the model has a draft setting or a lower\n  resolution: the user pays the full price before seeing the cut.\n- Finishing a take before the user approved the draft cut, or on the draft batch's yes.\n- A Seedance draft generated again at the finish settings while its handle is still valid: it is\n  finished from the handle.\n- Shooting shot by shot, or splitting runs for emphasis when the same shots fit fewer runs.\n- Treating the model's ceiling as a reason to make one long shot.\n- A prompt typed by hand, or a compiled one edited without compiling again.\n- A verification pass read as approval of the footage.\n- A panel pointer, a contact-sheet thumbnail or a low-resolution frame sent as a reference.\n- A reference passed outside `imageUrls`; an identity or wardrobe view left out; references reordered without\n  compiling again.\n- The geography line dropped, so people swap sides between shots.\n- Readable text asked of a video or a still. Signs and screens are added in the edit.\n- Resubmitting after a dropped call instead of checking its job.\n"
}

SHA-256 of public snapshot: 6484b6c02db1258f66b7b3ec72fdab0717136e0e0c8e875d2f82f044ab2f526b