← PicsartCONTENT HISTORY

Update to Picsart

Snapshot Nov 7, 2026 · 00:09 UTC · version 2.4.0

Collection source: downloaded plugin package.

WHAT CHANGED

Instructions updated for movie-producer

Full description — Now says: step, drafted as an animatic before video.

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.

Full description

Before

Nov 3, 2026 · 18:14 UTC

step.

After

Nov 7, 2026 · 00:09 UTC

step, drafted as an animatic before video.

Skill instructions

Before

Nov 3, 2026 · 18:14 UTC

step. Use when the user wants a short film, a movie or a multi-scene story ("I have a script"), or carries on a film already under way here (its shot list, a change to one shot, or the next step). Load it first for any work on such a fil...

After

Nov 7, 2026 · 00:09 UTC

step, drafted as an animatic before video. Use when the user wants a short film, a movie or a multi-scene story ("I have a script"), or carries on a film already under way here (its shot list, a change to one shot, or the next step). Loa...

Supporting files

Before

Nov 3, 2026 · 18:14 UTC

[{"relative_path":"agents/openai.yaml","size_in_bytes":176},{"relative_path":"references/board-replies.md","size_in_bytes":5697},{"relative_path":"references/project-record.md","size_in_bytes":5550},{"relative_path":"references/stages.md...

After

Nov 7, 2026 · 00:09 UTC

[{"relative_path":"agents/openai.yaml","size_in_bytes":176},{"relative_path":"references/board-replies.md","size_in_bytes":5697},{"relative_path":"references/project-record.md","size_in_bytes":6163},{"relative_path":"references/stages.md...

Compare saved observations

Download comparison JSON

SKILL.md text changes

− removed · + added

--- before
+++ after
@@ -1,8 +1,8 @@
 ---
 name: movie-producer
-description: Make a short narrative film from a story - several scenes, recurring characters, one locked look - staged and approved step by step. Use when the user wants a short film, a movie or a multi-scene story ("I have a script"), or carries on a film already under way here (its shot list, a change to one shot, or the next step). Load it first for any work on such a film; it brings in the film skills each step needs. Not for a drama series or its episodes (make-short-drama), a single clip, or footage the user already has.
+description: Make a short narrative film from a story - several scenes, recurring characters, one locked look - staged and approved step by step, drafted as an animatic before video. Use when the user wants a short film, a movie or a multi-scene story ("I have a script"), or carries on a film already under way here (its shot list, a change to one shot, or the next step). Load it first for any work on such a film; it brings in the film skills each step needs. Not for a drama series or its episodes (make-short-drama), a single clip, or footage the user already has.
 metadata:
-  uses: film-story-writing, film-cast-design, film-shot-generation, film-cutting, film-finishing, background-music, scene-building-basics, quality-review, realistic-color-grade, sd25-pe, sd2-pe
+  uses: film-story-writing, film-cast-design, film-shot-generation, film-animatic, voice-over-generation, film-cutting, film-finishing, footage-reframing, background-music, scene-building-basics, quality-review, realistic-color-grade, sd25-pe, sd2-pe
   optional: realistic-color-grade
   title: Produce a short film
   short-description: Make a short film from your story, scene by scene
@@ -15,24 +15,26 @@
 A film is not a long video. The model has no memory between generations: describe a character
 loosely and he arrives in every shot with a different face, jacket and age. Everything here exists
 to beat that one problem, consistency, and it runs on one economic law: **stills are cheap, video
-is expensive.** Every decision that can be made on text or pictures is made there, before the
-first video is bought.
+is expensive.** Every decision that can be made on text, pictures and sound is made there: the
+user watches the film as a voiced animatic, and says yes to it, before the first video is bought.
 
 Read picsart-video-rules first. One job: a story in, a short film out, with recurring people and places
 and one look.
 
+Before acting on a stage, load the skills in its row that apply to this job, also when the work resumes there.
+
 | Stage | Gate | Skills |
 |---|---|---|
 | 1. The idea | — | — |
 | 2. The look | ASK | film-story-writing |
-| 3. The story and the model | ASK | film-story-writing, film-shot-generation |
+| 3. The story and the model | ASK | film-story-writing, film-shot-generation, sd2-pe, sd25-pe |
 | 4. The shot list | ASK | film-story-writing, film-shot-generation |
 | 5. Cast, places and props | SPEND, ASK | film-cast-design |
-| 6. Scene pictures | SPEND, ASK | film-shot-generation, film-cast-design |
-| 7. Shooting | SPEND | film-shot-generation |
-| 8. The cut | REVIEW | film-cutting, scene-building-basics, quality-review |
+| 6. Storyboard and animatic | SPEND, ASK, REVIEW | film-animatic, film-shot-generation, film-cast-design, voice-over-generation, scene-building-basics, quality-review |
+| 7. Shooting | SPEND, ASK | film-shot-generation |
+| 8. The cut | SPEND, ASK, REVIEW | film-cutting, scene-building-basics, quality-review |
 | 9. Finishing | SPEND, ASK, REVIEW | film-finishing, background-music, realistic-color-grade |
-| 10. Deliver | ASK, DELIVER | film-finishing |
+| 10. Deliver | ASK, DELIVER | film-finishing, footage-reframing |
 
 Read these before you need them:
 
@@ -54,7 +56,7 @@
 | A film already under way (a project record) | Resume: read the record, say where the film stands, continue at its stage |
 
 **Pace: director by default**, as picsart-video-rules says. In express pace the user comes in only for the
-boards, the three locks (the look, the story with its model, the assets), every charged call no stated spend limit covers and
+boards, the three locks (the look, the story with its model, the assets), the animatic's review, every charged call no stated spend limit covers and
 anything beyond a quote.
 
 ## How you talk to the user
@@ -98,7 +100,7 @@
 
 **The challenger at each decision.** Before you go on from a decision, quality-review's challenger (the
 `challenger` agent where the host has it) asks "why this?" of it: the idea (stage 1), the look and
-the story (2, 3), the shot list (4), each sheet, plate and scene picture picked and why (5, 6), and
+the story (2, 3), the shot list (4), each sheet, plate, scene picture and panel picked and why (5, 6), and
 every quote before its SPEND (5, 6, 7, 9, and a repair in 8 that needs a generation). Act on its
 verdict as quality-review says. A `stop`, or a `rethink` of the user's own choice, goes to the user in the
 next ASK, the cheaper alternative first, before anything is spent.
@@ -133,13 +135,29 @@
 
 ## 3. The story and the model
 
-**The story.** film-story-writing writes it, for the locked genre. State the identity budget you inferred ("two
-faces and one garage") rather than asking for it.
-
-**The model, in the same turn.** film-shot-generation narrows the video models to the few that can shoot
-this film. Then open `picsart_model_choose` under the story: 3 candidates (2 is fine; a 4th becomes a suggestion), exactly one
-`candidates[].recommended`, each `candidates[].bestFor` line written as this film's trade ("one continuous 30 s take, tops
-out at 720p").
+**The story.** film-story-writing writes it, for the locked genre, with its viewer track. State the identity budget
+you inferred ("two faces and one garage") rather than asking for it. Show the track's after-watch questions under the
+story, for correction: they are what the user and the cold watch are asked after each draft.
+
+**The model, in the same turn.** The candidates are the current models, in this order:
+
+| Model | Frame | Length per run | Reference images | Draft |
+|---|---|---|---|---|
+| `seedance-2.5` | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 | 4–30 s | 30 | `draft: true` |
+| `kling-v4-omni` | 16:9, 9:16, 1:1, 21:9 | 3–30 s | 8 | none: `720p` |
+| `wan-3.0-video` | 16:9, 9:16, 1:1, 4:3, 3:4 | 2–30 s | 10 | none: `480P` |
+| `veo-3.1` | 16:9, 9:16 | 4, 6 or 8 s | 3 | none: `720p` |
+
+Read each one's `picsart_model_params` before the board (film-shot-generation's model steps 2 and
+3); the table is a guide, the params decide. Drop a candidate only when its params cannot hold the
+film's frame or its runs (Veo 3.1 holds no 1:1 and no run over 8 s). Never offer an older model
+(Seedance 2.0, its Fast and Mini, Kling V3, Hailuo, Wan 2.7) unless the user names it. The user's
+balance and the cheapest-first rule set the draft resolution, never the model: they never put an
+older model on the board or make one `recommended`.
+
+Open `picsart_model_choose` under the story with the candidates that survive, in that order, the
+first one `candidates[].recommended`, each `candidates[].bestFor` line written as this film's trade
+("one continuous 30 s take, tops out at 720p").
 
 - The pick is the story's yes unless the user sends a note with it. A note about what happens is
   answered as film-story-writing says, and the rewritten paragraph is shown again with the model board.
@@ -183,7 +201,9 @@
 
 Then film-cast-design's conveyor, in one pass:
 
-1. Draft every descriptor as film-cast-design says. No separate approval round.
+1. Draft every descriptor as film-cast-design says, then offer the cast board once
+   (film-cast-design, *The starting point*). It is the one stop here and costs nothing; a reply that
+   ignores it keeps the story's descriptors. There is no other approval round.
 2. Compile each picture with `picsart_film_compile_prompt` (a reference `kind`) and read its
    `check`, then **one SPEND for the whole batch**: every sheet and plate on one
    quote.
@@ -200,22 +220,44 @@
 film's era. Raise each flag once, as one short ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) with the options film-cast-design names. Anything
 generated is its own SPEND.
 
-## 6. Scene pictures
+## 6. Storyboard and animatic
 
-Every scene gets its pictures before its first run: the wide, the scene picture cut from it, and a
-room map where the scene cuts between walls, as film-shot-generation says. **One SPEND for every scene's
-pictures**, batched as picsart-video-rules says (at most 10 a call), and `picsart_film_review_assets` for all of them, 12 tiles a board. The scene picture is the
-opening frame of the scene's first run; the wide and the map are its place.
-
-**No still test.** The scene pictures are where the cast is checked, as film-cast-design says: say
-in their review what you saw in each face. Nothing is bought again unless the user asks for a
-change; a change goes back through stage 5's conveyor alone, under its own SPEND, on a fresh board.
-
-**The gate into shooting:** film-cast-design's gate into a run holds for every run, and every scene
-it spans has approved pictures. A missing one is a stop.
+The film is drafted on stills and sound, and the user watches it before any video is bought. Load
+film-animatic before you say what this stage needs or ask anything in it. Its yes is the gate into
+shooting.
+
+1. **Scene pictures.** Every scene gets its pictures: the wide, the scene picture cut from it,
+   and a room map where the scene cuts between walls, as film-shot-generation says. The scene
+   picture is the scene's opening panel and the opening frame of its first run.
+2. **One panel per shot**, compiled from its card and checked against its scene picture, as
+   film-animatic says. A real app's screen in a shot is built as a scene layer from the user's
+   own screenshots or recording, never generated. **One SPEND (quote it in one line, then get the yes as an ASK with "Yes, go ahead" / "Yes, up to N credits for this task" / "No": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit ("as much as needed"), never inferred from words like "go ahead". Within it, ask nothing: quote it in one line ("About 8 credits; 12 of 20 left after this"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says) for every scene picture and
+   panel**, batched as picsart-video-rules says (at most 10 a call), and
+   `picsart_film_review_assets` for all of them, 12 tiles a board.
+3. **The sound**: every line in its person's voice, a bed per scene and the card's effects, as
+   film-animatic says, on one SPEND (quote it in one line, then get the yes as an ASK with "Yes, go ahead" / "Yes, up to N credits for this task" / "No": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit ("as much as needed"), never inferred from words like "go ahead". Within it, ask nothing: quote it in one line ("About 8 credits; 12 of 20 left after this"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says), each voice line's real length probed before anything is
+   timed to it.
+4. **The animatic**: built, validated, cut-checked, looked at and watched cold as film-animatic says
+   (quality-review's cold watch, quoted first with its own SPEND (quote it in one line, then get the yes as an ASK with "Yes, go ahead" / "Yes, up to N credits for this task" / "No": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit ("as much as needed"), never inferred from words like "go ahead". Within it, ask nothing: quote it in one line ("About 8 credits; 12 of 20 left after this"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says) unless every call is quoted at
+   0 credits), then REVIEWed in the scene editor,
+   with its sound, opened cold. Notes route as film-animatic says: a story note
+   goes back to stage 3's paragraph, a shot note to that panel or line alone, each change made
+   again under its own SPEND. Loop until the user says yes.
+
+**No still test.** The scene pictures are where the cast is checked, as film-cast-design says, and
+so are the panels: say in their review what you saw in each face. A change to a person or a prop goes back
+through stage 5's conveyor alone, under its own SPEND, on a fresh board.
+
+**The gate into shooting:** the animatic approved, film-cast-design's gate into a run held for every
+run, and every scene it spans with approved pictures. A user who wants to shoot without the
+animatic may, as a recorded override; never skip it yourself.
 
 ## 7. Shooting
 
+**Which shots go to video is the user's.** ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) once, all shots recommended unless the
+animatic showed a held panel works as it is; a shot kept as a panel stays in the cut as approved.
+Quote only the picked shots, each opening on its approved panel, as film-animatic says.
+
 Before any run is quoted, a shot that film-shot-generation flags for a palette arguing with the film's
 scheme gets one short ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) with its options.
 
@@ -243,8 +285,9 @@
 When the last take lands, film-cutting assembles the film once: every candidate take in story order
 with hard cuts, every generation one clip exactly as generated: no split at a run's internal cuts,
 no trims, no transitions, padding or freeze frames. The user's own trims and splits are kept and
-never recomputed. Check it with quality-review, then REVIEW the whole cut, unasked: this is the
-film's review, and it says what your check observed in each take. **The user's approval of the cut
+never recomputed. Check it with quality-review, its cold watch included (quoted first with its own SPEND (quote it in one line, then get the yes as an ASK with "Yes, go ahead" / "Yes, up to N credits for this task" / "No": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit ("as much as needed"), never inferred from words like "go ahead". Within it, ask nothing: quote it in one line ("About 8 credits; 12 of 20 left after this"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says) unless
+every call is quoted at 0 credits; on a no, the review line says "no cold watch yet"), then REVIEW the whole cut, unasked and opened cold: this is the film's review. Once the user has
+answered, say what your check observed in each take. **The user's approval of the cut
 accepts every take in it**, and its shots become `final`.
 
 **Notes route by meaning**, as film-shot-generation says: an edit, an extend or a re-roll. A note it
@@ -278,7 +321,8 @@
 ## 10. Deliver
 
 DELIVER the final cut once, as picsart-video-rules says. Any further master from film-finishing's delivery
-list is confirmed with one ASK before the first is exported.
+list is confirmed with one ASK before the first is exported. A master in another shape is reframed as the
+footage-reframing skill says.
 Then film-finishing's archive and disclosure: give the user the disclosure text (every model used,
 per stage) and record it, and say generated music's licence is theirs to check before a festival or
 a commercial use.
Full technical diff · 3 changed fields

changed /description

BEFORE
"Make a short narrative film from a story - several scenes, recurring characters, one locked look - staged and approved step by step. Use when the user wants a short film, a movie or a multi-scene story (\"I have a script\"), or carries on a film already under way here (its shot list, a change to one shot, or the next step). Load it first for any work on such a film; it brings in the film skills each step needs. Not for a drama series or its episodes (make-short-drama), a single clip, or footage the user already has."
AFTER
"Make a short narrative film from a story - several scenes, recurring characters, one locked look - staged and approved step by step, drafted as an animatic before video. Use when the user wants a short film, a movie or a multi-scene story (\"I have a script\"), or carries on a film already under way here (its shot list, a change to one shot, or the next step). Load it first for any work on such a film; it brings in the film skills each step needs. Not for a drama series or its episodes (make-short-drama), a single clip, or footage the user already has."

changed /included_files

BEFORE
[
  {
    "relative_path": "agents/openai.yaml",
    "size_in_bytes": 176
  },
  {
    "relative_path": "references/board-replies.md",
    "size_in_bytes": 5697
  },
  {
    "relative_path": "references/project-record.md",
    "size_in_bytes": 5550
  },
  {
    "relative_path": "references/stages.md",
    "size_in_bytes": 7226
  }
]
AFTER
[
  {
    "relative_path": "agents/openai.yaml",
    "size_in_bytes": 176
  },
  {
    "relative_path": "references/board-replies.md",
    "size_in_bytes": 5697
  },
  {
    "relative_path": "references/project-record.md",
    "size_in_bytes": 6163
  },
  {
    "relative_path": "references/stages.md",
    "size_in_bytes": 8245
  }
]

changed /skill_md_contents

BEFORE
"---\nname: movie-producer\ndescription: Make a short narrative film from a story - several scenes, recurring characters, one locked look - staged and approved step by step. Use when the user wants a short film, a movie or a multi-scene story (\"I have a script\"), or carries on a film already under way here (its shot list, a change to one shot, or the next step). Load it first for any work on such a film; it brings in the film skills each step needs. Not for a drama series or its episodes (make-short-drama), a single clip, or footage the user already has.\nmetadata:\n  uses: film-story-writing, film-cast-design, film-shot-generation, film-cutting, film-finishing, background-music, scene-building-basics, quality-review, realistic-color-grade, sd25-pe, sd2-pe\n  optional: realistic-color-grade\n  title: Produce a short film\n  short-description: Make a short film from your story, scene by scene\n  argument-hint: '[story idea or script]'\n  starter-prompt: Make a short film from my story.\n---\n\n# Short film\n\nA film is not a long video. The model has no memory between generations: describe a character\nloosely and he arrives in every shot with a different face, jacket and age. Everything here exists\nto beat that one problem, consistency, and it runs on one economic law: **stills are cheap, video\nis expensive.** Every decision that can be made on text or pictures is made there, before the\nfirst video is bought.\n\nRead picsart-video-rules first. One job: a story in, a short film out, with recurring people and places\nand one look.\n\n| Stage | Gate | Skills |\n|---|---|---|\n| 1. The idea | — | — |\n| 2. The look | ASK | film-story-writing |\n| 3. The story and the model | ASK | film-story-writing, film-shot-generation |\n| 4. The shot list | ASK | film-story-writing, film-shot-generation |\n| 5. Cast, places and props | SPEND, ASK | film-cast-design |\n| 6. Scene pictures | SPEND, ASK | film-shot-generation, film-cast-design |\n| 7. Shooting | SPEND | film-shot-generation |\n| 8. The cut | REVIEW | film-cutting, scene-building-basics, quality-review |\n| 9. Finishing | SPEND, ASK, REVIEW | film-finishing, background-music, realistic-color-grade |\n| 10. Deliver | ASK, DELIVER | film-finishing |\n\nRead these before you need them:\n\n| File | Read it before you… |\n|---|---|\n| `references/stages.md` | say a stage is done, or open the next one |\n| `references/board-replies.md` | act on a reply from any board |\n| `references/project-record.md` | write or resume the project record |\n\n## Before you start\n\n**Route first.** The dividing line is recurring identity across scenes.\n\n| The user brings | Route |\n|---|---|\n| One clip's worth of idea (\"a boot stepping onto scree\") | Not this use case. Say so, and offer one generation: `picsart_model_choose`, then SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says) and `picsart_generate` |\n| Footage to cut together | Not this use case. Say it is not built yet here |\n| A story: scenes, people who recur, dialogue | This use case, from stage 1 |\n| A film already under way (a project record) | Resume: read the record, say where the film stands, continue at its stage |\n\n**Pace: director by default**, as picsart-video-rules says. In express pace the user comes in only for the\nboards, the three locks (the look, the story with its model, the assets), every charged call no stated spend limit covers and\nanything beyond a quote.\n\n## How you talk to the user\n\nTalk and ask as picsart-video-rules says. Here that means:\n\n- one board per decision; everything else waits in the record's `openDecisions`;\n- what each board's reply holds is in `references/board-replies.md`;\n- where things stand reads like \"Stage 5 of 10 · cast, places and props — locking Cal (2 of 5\n  done)\", and the gate view shows which scenes have everything they need (\"not ready yet\", never\n  \"a hole\");\n- an alarm word is for a real gate violation, such as a video about to be bought for a scene\n  whose assets are not locked.\n\n## The project record\n\nThe film's state is one record, and it outranks your memory of it. Where the host gives you\nfiles, keep it as `film.json` in the working folder; otherwise keep it in the conversation and\ngive it to the user once, at the end of a working session, to paste back next time. Never print it\nmid-flow. Update it whole at every milestone: a gate passed, an asset locked, a batch dispatched or\nlanded, a review round, picture lock, the export. Its shape is `references/project-record.md`.\n\nBeside the facts it keeps the **brief**: the logline, the world in three sentences, the people as\npeople, and the standing decisions with their reasons (\"hard cuts only: the film is about\nabruptness\"). On resume, read it before saying where things stand. With no record at hand, take\nwhat the user says about the film as its state and carry on; ask for the record only when the step\nneeds a fact they have not given.\n\n## Gates\n\n**A gate is passed only when its checklist in `references/stages.md` is met**, or when the user\nconsciously overrides it; record the override and its reason. Before you say a stage is done or\nname the next one, write its checklist with ✓ or ✗ per line and the evidence beside each ✓ (a\nstatus a tool returned, a user's yes, a recorded override). A line with ✗ means the stage is not\ndone: say which line and what closes it.\n\n**Choosing how to meet a rule is your craft call; choosing to spend or risk money against a closed\ngate is never yours.** Which model shortlist, which order, whether a face needs one more view: yours,\nrecorded, never asked. Buying video for a scene whose assets are not locked, going beyond a quote,\ntrading quality for money: the user's.\n\n**The challenger at each decision.** Before you go on from a decision, quality-review's challenger (the\n`challenger` agent where the host has it) asks \"why this?\" of it: the idea (stage 1), the look and\nthe story (2, 3), the shot list (4), each sheet, plate and scene picture picked and why (5, 6), and\nevery quote before its SPEND (5, 6, 7, 9, and a repair in 8 that needs a generation). Act on its\nverdict as quality-review says. A `stop`, or a `rethink` of the user's own choice, goes to the user in the\nnext ASK, the cheaper alternative first, before anything is spent.\n\n## 1. The idea\n\n- **Read the user's brief first.** Every file in the material that is not media, read in full\n  before the first question, as picsart-video-rules's The user's own brief says. A brief sets the message, the\n  audience and the must-shows.\n\nAsk for the idea only if the user has not given one. Once there is one, ask nothing more here:\nruntime and frame are set on the look console, and the story proposes an ending the user can\nchange.\n\n## 2. The look\n\n**`picsart_film_setup` comes first, before a word of story is written**, one call per visual\nworld. Genre decides how the story is told, and every shot card sits under what this console\nlocks: the style line, the lens family the cards' focal lengths come from, and the colour scheme\neach card's own palette has to fit.\n\n- Pre-set it from the idea with `suggested`, one `suggested.why` line each, as film-story-writing says: the genre the\n  events make, a tone when the story names a period, and the colour.\n- **`film` (the title) is required.** `ratio` and `duration` go inside `suggested.selections`, under\n  those field names, never as top-level arguments: the schema rejects anything it does not list.\n- **Pass `ratio` whenever the user named a format at all** (\"vertical\", \"TikTok\", \"square\"). Pass\n  the runtime they said as `duration`. Nothing infers a format; the console's default stands\n  otherwise.\n- The console is the ASK. On `film_setup_feedback` (`verdict: \"locked\"`), store `stylePrefix`\n  verbatim and the `selections` as they came. That lock is the look's lock; there is no later one.\n- If the genre changes at any point, film-story-writing rewrites the story first.\n\n## 3. The story and the model\n\n**The story.** film-story-writing writes it, for the locked genre. State the identity budget you inferred (\"two\nfaces and one garage\") rather than asking for it.\n\n**The model, in the same turn.** film-shot-generation narrows the video models to the few that can shoot\nthis film. Then open `picsart_model_choose` under the story: 3 candidates (2 is fine; a 4th becomes a suggestion), exactly one\n`candidates[].recommended`, each `candidates[].bestFor` line written as this film's trade (\"one continuous 30 s take, tops\nout at 720p\").\n\n- The pick is the story's yes unless the user sends a note with it. A note about what happens is\n  answered as film-story-writing says, and the rewritten paragraph is shown again with the model board.\n- On the pick, record the model, its take ceiling and its edit and extend siblings, as film-shot-generation\n  finds them. One model for the whole film. A Seedance pick (`seedance-…`) also brings in the `sd25-pe`\n  skill for Seedance 2.5 or `sd2-pe` for Seedance 2.0, as film-shot-generation's Seedance reference says.\n\n## 4. The shot list\n\n**`picsart_film_shotlist` once, with every scene in one call.** Load film-story-writing before you write\nthe cards: it turns the approved story into them, and its peak rule marks one card, the `Peak`\nline's shot, with the moved face `unguarded` and what shows (\"@teo relief, unguarded: the tears\ncome\"), every other face held in; film-shot-generation packs them into runs against the model's ceiling, with one join\nsentence on the shot that opens each run. Pass `film`, the model, and the setup's defaults, so the\nuser never picks from a vocabulary the film has not adopted.\n\n- The board approves camera and seconds. It is not a place to rewrite the story: an edit that\n  changes what happens is a story note, so rewrite the paragraph first, then open the board again.\n- On `shotlist_board_feedback`, **replace** your list with it, runs included. Fields the board does\n  not carry (references, prompt versions, trims) stay on the shot by id.\n- A long scene held in one shot comes with film-shot-generation' coverage recommendation on its card. Keep\n  the single shot only if the user chooses it on the board.\n- A card that film-shot-generation flags for a kinetic move on a big face, set on the board or changed\n  later, gets one short ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) before the run is compiled: the move as the user set it, or one of\n  film-shot-generation' safer versions. The camera stays the user's.\n- After a long stretch on one video, offer once to reopen the board to recap what comes next.\n  Honour a no without asking again.\n\n## 5. Cast, places and props\n\n**The project folder first**, before anything is generated. `picsart_drive_create_folder` with\n`path: \"Picsart Films/<film-slug>\"` and\n`children: [\"Library\", \"Assets\", \"Shots\", \"Exports\"]`. Keep every uid it returns in the record.\nSay it once, plainly: \"Created Picsart Films/the-garage in your Picsart Drive, with Library,\nAssets, Shots and Exports inside. Everything this film makes is filed there.\" Never say it again,\nand never list the whole Drive: no `list` without a `folderUid`. Pass the right `folderUid` on\nevery `picsart_generate` and `picsart_job_status` call of the film, and the project folder as\n`projectFolderUid` on every asset call. A finished job is filed only when you save it, as\npicsart-video-rules's SPEND rule 4 says: save every finished picture and take into its folder before you\nshow it. Never call a filed file permanent.\n\nThen film-cast-design's conveyor, in one pass:\n\n1. Draft every descriptor as film-cast-design says. No separate approval round.\n2. Compile each picture with `picsart_film_compile_prompt` (a reference `kind`) and read its\n   `check`, then **one SPEND for the whole batch**: every sheet and plate on one\n   quote.\n3. Dispatch on the yes as one batch (picsart-video-rules, SPEND), with `folderUid` set to Assets, and\n   let the batch's card follow the jobs as picsart-video-rules says.\n4. Look at each picture (picsart-video-rules, Asset URLs) before anything uses it, then put them all on\n   `picsart_film_review_assets` in one call (at most 12 tiles; more go on a second board), with the one thing to judge them by as the board's `judge`, and one line per tile as its `assets[].why`.\n5. Act on the reply as `references/board-replies.md` says. Each approved asset is cut into views and\n   locked with `picsart_film_save_asset`, as film-cast-design says. A change is regenerated under its own SPEND and put on a fresh board with `assets[].version` and\n   `assets[].previousUrl`. A discarded tile is never used.\n\nA person the user photographed is saved as it came and is not put up for approval: it is theirs.\nfilm-cast-design flags what it cannot settle on its own, about a photo the user brought or about the\nfilm's era. Raise each flag once, as one short ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) with the options film-cast-design names. Anything\ngenerated is its own SPEND.\n\n## 6. Scene pictures\n\nEvery scene gets its pictures before its first run: the wide, the scene picture cut from it, and a\nroom map where the scene cuts between walls, as film-shot-generation says. **One SPEND for every scene's\npictures**, batched as picsart-video-rules says (at most 10 a call), and `picsart_film_review_assets` for all of them, 12 tiles a board. The scene picture is the\nopening frame of the scene's first run; the wide and the map are its place.\n\n**No still test.** The scene pictures are where the cast is checked, as film-cast-design says: say\nin their review what you saw in each face. Nothing is bought again unless the user asks for a\nchange; a change goes back through stage 5's conveyor alone, under its own SPEND, on a fresh board.\n\n**The gate into shooting:** film-cast-design's gate into a run holds for every run, and every scene\nit spans has approved pictures. A missing one is a stop.\n\n## 7. Shooting\n\nBefore any run is quoted, a shot that film-shot-generation flags for a palette arguing with the film's\nscheme gets one short ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) with its options.\n\n1. **The forecast, once, before the first video:** runs × each run's seconds at the model's draft\n   rate from `picsart_preflight`, plus a margin for repairs, and the finish beside it. It is an\n   estimate, not a quote.\n2. **Shoot every run as a draft, in one batch**, as film-shot-generation says: the model's draft\n   setting or its lowest resolution, and no test run first. Every independent run is compiled,\n   verified and sent together, one call per run: one quote for the batch with the finish priced\n   beside it as an estimate, one yes, one monitor. The yes buys the drafts only. A run that waits for an earlier take (its frames\n   are the references) is its own SPEND once that take lands and passes your check.\n3. **No film so far.** While takes run, never assemble, cut, open or show the film so far: a landed\n   take waits for the others. As each take lands, find its actual cuts and judge it as\n   film-shot-generation's takes reference says. That is your technical check, not acceptance:\n   every take stays a candidate until the user approves the cut (8). No question between the\n   takes and the cut.\n4. Dialogue is judged in the cut's REVIEW, by ear. Say that the words were not checked against the\n   script by a tool.\n\nShooting is done when every take has landed and passed your check, with its actual cuts, prompt,\nquote and handle in the record. No take is accepted yet.\n\n## 8. The cut\n\nWhen the last take lands, film-cutting assembles the film once: every candidate take in story order\nwith hard cuts, every generation one clip exactly as generated: no split at a run's internal cuts,\nno trims, no transitions, padding or freeze frames. The user's own trims and splits are kept and\nnever recomputed. Check it with quality-review, then REVIEW the whole cut, unasked: this is the\nfilm's review, and it says what your check observed in each take. **The user's approval of the cut\naccepts every take in it**, and its shots become `final`.\n\n**Notes route by meaning**, as film-shot-generation says: an edit, an extend or a re-roll. A note it\nflags as ambiguous gets one short ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) between its two routes. **Each is its own SPEND**, shot as a draft\nlike the takes: a yes to a run is not a yes to its repair. A note on a seam is not a licence to buy footage: film-cutting's\njoin repair diagnoses first. A bridge between two runs is its own SPEND too, reviewed as\nfilm-cutting's join repair says. Apply what the user points at, re-cut once and open it again, until\nthey call it final. After that, change no picture unless they ask.\n\n## 9. Finishing\n\nIn this order, as film-finishing says: the finish of the draft takes, then colour, then sound.\n\n1. **Finish the approved cut**, as film-finishing says: from each draft's `finalizeDraft` handle\n   where it has one, otherwise an upscale or the approved run generated again at the finish\n   settings. It is its own SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says), after the cut is approved, asked as film-finishing's one\n   question: finish the approved takes, or keep the drafts. Then the cut is re-assembled at the\n   finish size with the user's trims.\n2. **Colour:** ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) with three or four looks that suit the film, from the look list in\n   `picsart_scene_capabilities` (`sections: [\"looksCompact\"]`). Applying one is free.\n   When the takes look glossy or plastic, as generated footage often does, one option is the\n   realism grade, applied as the realistic-color-grade skill says.\n3. **Music:** offer it once, only after the cut is final, and never bare: ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) with the brief\n   drafted as the background-music skill says, and three exits: generate it, change the brief, or skip. A\n   changed brief is redrafted and asked again; a skip is settled for the session. A yes is a SPEND,\n   as picsart-video-rules says. Lay the bed as film-finishing says, then REVIEW the film with it, on how it\n   sits under the dialogue. A note on its level moves it as the background-music skill says; a different\n   track goes back through the background-music skill's brief, with a new SPEND. A film going to festivals\n   or dubbing gets film-finishing's sound-team handoff offered once.\n\n## 10. Deliver\n\nDELIVER the final cut once, as picsart-video-rules says. Any further master from film-finishing's delivery\nlist is confirmed with one ASK before the first is exported.\nThen film-finishing's archive and disclosure: give the user the disclosure text (every model used,\nper stage) and record it, and say generated music's licence is theirs to check before a festival or\na commercial use.\n\n## When something fails\n\n- **Out of credits: zero retries.** Say which step is paused and what it needs against the balance\n  `picsart_credits` reads. Keep the record and every job handle. Continue only when the user says\n  their credits are there; never poll the balance.\n- **A dropped call is not a failed generation**: follow its job as film-shot-generation says.\n- **A board that errors on a value** gets the value fixed and the board sent again. A board the\n  host cannot draw gets the host notes' fallback, and the gate still holds.\n- **Anything else a stage cannot run without** gets one identical retry, then one plain line: what\n  you tried, what blocked it, what you need. Never reword and refire.\n- **An outage is status, not a decision.** Keep going on everything free, keep the blocked item in\n  `openDecisions`, and try again next turn. Never offer a choice the rules already answer, such as\n  giving up a lead's consistency to dodge a temporary outage.\n"
AFTER
"---\nname: movie-producer\ndescription: Make a short narrative film from a story - several scenes, recurring characters, one locked look - staged and approved step by step, drafted as an animatic before video. Use when the user wants a short film, a movie or a multi-scene story (\"I have a script\"), or carries on a film already under way here (its shot list, a change to one shot, or the next step). Load it first for any work on such a film; it brings in the film skills each step needs. Not for a drama series or its episodes (make-short-drama), a single clip, or footage the user already has.\nmetadata:\n  uses: film-story-writing, film-cast-design, film-shot-generation, film-animatic, voice-over-generation, film-cutting, film-finishing, footage-reframing, background-music, scene-building-basics, quality-review, realistic-color-grade, sd25-pe, sd2-pe\n  optional: realistic-color-grade\n  title: Produce a short film\n  short-description: Make a short film from your story, scene by scene\n  argument-hint: '[story idea or script]'\n  starter-prompt: Make a short film from my story.\n---\n\n# Short film\n\nA film is not a long video. The model has no memory between generations: describe a character\nloosely and he arrives in every shot with a different face, jacket and age. Everything here exists\nto beat that one problem, consistency, and it runs on one economic law: **stills are cheap, video\nis expensive.** Every decision that can be made on text, pictures and sound is made there: the\nuser watches the film as a voiced animatic, and says yes to it, before the first video is bought.\n\nRead picsart-video-rules first. One job: a story in, a short film out, with recurring people and places\nand one look.\n\nBefore acting on a stage, load the skills in its row that apply to this job, also when the work resumes there.\n\n| Stage | Gate | Skills |\n|---|---|---|\n| 1. The idea | — | — |\n| 2. The look | ASK | film-story-writing |\n| 3. The story and the model | ASK | film-story-writing, film-shot-generation, sd2-pe, sd25-pe |\n| 4. The shot list | ASK | film-story-writing, film-shot-generation |\n| 5. Cast, places and props | SPEND, ASK | film-cast-design |\n| 6. Storyboard and animatic | SPEND, ASK, REVIEW | film-animatic, film-shot-generation, film-cast-design, voice-over-generation, scene-building-basics, quality-review |\n| 7. Shooting | SPEND, ASK | film-shot-generation |\n| 8. The cut | SPEND, ASK, REVIEW | film-cutting, scene-building-basics, quality-review |\n| 9. Finishing | SPEND, ASK, REVIEW | film-finishing, background-music, realistic-color-grade |\n| 10. Deliver | ASK, DELIVER | film-finishing, footage-reframing |\n\nRead these before you need them:\n\n| File | Read it before you… |\n|---|---|\n| `references/stages.md` | say a stage is done, or open the next one |\n| `references/board-replies.md` | act on a reply from any board |\n| `references/project-record.md` | write or resume the project record |\n\n## Before you start\n\n**Route first.** The dividing line is recurring identity across scenes.\n\n| The user brings | Route |\n|---|---|\n| One clip's worth of idea (\"a boot stepping onto scree\") | Not this use case. Say so, and offer one generation: `picsart_model_choose`, then SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says) and `picsart_generate` |\n| Footage to cut together | Not this use case. Say it is not built yet here |\n| A story: scenes, people who recur, dialogue | This use case, from stage 1 |\n| A film already under way (a project record) | Resume: read the record, say where the film stands, continue at its stage |\n\n**Pace: director by default**, as picsart-video-rules says. In express pace the user comes in only for the\nboards, the three locks (the look, the story with its model, the assets), the animatic's review, every charged call no stated spend limit covers and\nanything beyond a quote.\n\n## How you talk to the user\n\nTalk and ask as picsart-video-rules says. Here that means:\n\n- one board per decision; everything else waits in the record's `openDecisions`;\n- what each board's reply holds is in `references/board-replies.md`;\n- where things stand reads like \"Stage 5 of 10 · cast, places and props — locking Cal (2 of 5\n  done)\", and the gate view shows which scenes have everything they need (\"not ready yet\", never\n  \"a hole\");\n- an alarm word is for a real gate violation, such as a video about to be bought for a scene\n  whose assets are not locked.\n\n## The project record\n\nThe film's state is one record, and it outranks your memory of it. Where the host gives you\nfiles, keep it as `film.json` in the working folder; otherwise keep it in the conversation and\ngive it to the user once, at the end of a working session, to paste back next time. Never print it\nmid-flow. Update it whole at every milestone: a gate passed, an asset locked, a batch dispatched or\nlanded, a review round, picture lock, the export. Its shape is `references/project-record.md`.\n\nBeside the facts it keeps the **brief**: the logline, the world in three sentences, the people as\npeople, and the standing decisions with their reasons (\"hard cuts only: the film is about\nabruptness\"). On resume, read it before saying where things stand. With no record at hand, take\nwhat the user says about the film as its state and carry on; ask for the record only when the step\nneeds a fact they have not given.\n\n## Gates\n\n**A gate is passed only when its checklist in `references/stages.md` is met**, or when the user\nconsciously overrides it; record the override and its reason. Before you say a stage is done or\nname the next one, write its checklist with ✓ or ✗ per line and the evidence beside each ✓ (a\nstatus a tool returned, a user's yes, a recorded override). A line with ✗ means the stage is not\ndone: say which line and what closes it.\n\n**Choosing how to meet a rule is your craft call; choosing to spend or risk money against a closed\ngate is never yours.** Which model shortlist, which order, whether a face needs one more view: yours,\nrecorded, never asked. Buying video for a scene whose assets are not locked, going beyond a quote,\ntrading quality for money: the user's.\n\n**The challenger at each decision.** Before you go on from a decision, quality-review's challenger (the\n`challenger` agent where the host has it) asks \"why this?\" of it: the idea (stage 1), the look and\nthe story (2, 3), the shot list (4), each sheet, plate, scene picture and panel picked and why (5, 6), and\nevery quote before its SPEND (5, 6, 7, 9, and a repair in 8 that needs a generation). Act on its\nverdict as quality-review says. A `stop`, or a `rethink` of the user's own choice, goes to the user in the\nnext ASK, the cheaper alternative first, before anything is spent.\n\n## 1. The idea\n\n- **Read the user's brief first.** Every file in the material that is not media, read in full\n  before the first question, as picsart-video-rules's The user's own brief says. A brief sets the message, the\n  audience and the must-shows.\n\nAsk for the idea only if the user has not given one. Once there is one, ask nothing more here:\nruntime and frame are set on the look console, and the story proposes an ending the user can\nchange.\n\n## 2. The look\n\n**`picsart_film_setup` comes first, before a word of story is written**, one call per visual\nworld. Genre decides how the story is told, and every shot card sits under what this console\nlocks: the style line, the lens family the cards' focal lengths come from, and the colour scheme\neach card's own palette has to fit.\n\n- Pre-set it from the idea with `suggested`, one `suggested.why` line each, as film-story-writing says: the genre the\n  events make, a tone when the story names a period, and the colour.\n- **`film` (the title) is required.** `ratio` and `duration` go inside `suggested.selections`, under\n  those field names, never as top-level arguments: the schema rejects anything it does not list.\n- **Pass `ratio` whenever the user named a format at all** (\"vertical\", \"TikTok\", \"square\"). Pass\n  the runtime they said as `duration`. Nothing infers a format; the console's default stands\n  otherwise.\n- The console is the ASK. On `film_setup_feedback` (`verdict: \"locked\"`), store `stylePrefix`\n  verbatim and the `selections` as they came. That lock is the look's lock; there is no later one.\n- If the genre changes at any point, film-story-writing rewrites the story first.\n\n## 3. The story and the model\n\n**The story.** film-story-writing writes it, for the locked genre, with its viewer track. State the identity budget\nyou inferred (\"two faces and one garage\") rather than asking for it. Show the track's after-watch questions under the\nstory, for correction: they are what the user and the cold watch are asked after each draft.\n\n**The model, in the same turn.** The candidates are the current models, in this order:\n\n| Model | Frame | Length per run | Reference images | Draft |\n|---|---|---|---|---|\n| `seedance-2.5` | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 | 4–30 s | 30 | `draft: true` |\n| `kling-v4-omni` | 16:9, 9:16, 1:1, 21:9 | 3–30 s | 8 | none: `720p` |\n| `wan-3.0-video` | 16:9, 9:16, 1:1, 4:3, 3:4 | 2–30 s | 10 | none: `480P` |\n| `veo-3.1` | 16:9, 9:16 | 4, 6 or 8 s | 3 | none: `720p` |\n\nRead each one's `picsart_model_params` before the board (film-shot-generation's model steps 2 and\n3); the table is a guide, the params decide. Drop a candidate only when its params cannot hold the\nfilm's frame or its runs (Veo 3.1 holds no 1:1 and no run over 8 s). Never offer an older model\n(Seedance 2.0, its Fast and Mini, Kling V3, Hailuo, Wan 2.7) unless the user names it. The user's\nbalance and the cheapest-first rule set the draft resolution, never the model: they never put an\nolder model on the board or make one `recommended`.\n\nOpen `picsart_model_choose` under the story with the candidates that survive, in that order, the\nfirst one `candidates[].recommended`, each `candidates[].bestFor` line written as this film's trade\n(\"one continuous 30 s take, tops out at 720p\").\n\n- The pick is the story's yes unless the user sends a note with it. A note about what happens is\n  answered as film-story-writing says, and the rewritten paragraph is shown again with the model board.\n- On the pick, record the model, its take ceiling and its edit and extend siblings, as film-shot-generation\n  finds them. One model for the whole film. A Seedance pick (`seedance-…`) also brings in the `sd25-pe`\n  skill for Seedance 2.5 or `sd2-pe` for Seedance 2.0, as film-shot-generation's Seedance reference says.\n\n## 4. The shot list\n\n**`picsart_film_shotlist` once, with every scene in one call.** Load film-story-writing before you write\nthe cards: it turns the approved story into them, and its peak rule marks one card, the `Peak`\nline's shot, with the moved face `unguarded` and what shows (\"@teo relief, unguarded: the tears\ncome\"), every other face held in; film-shot-generation packs them into runs against the model's ceiling, with one join\nsentence on the shot that opens each run. Pass `film`, the model, and the setup's defaults, so the\nuser never picks from a vocabulary the film has not adopted.\n\n- The board approves camera and seconds. It is not a place to rewrite the story: an edit that\n  changes what happens is a story note, so rewrite the paragraph first, then open the board again.\n- On `shotlist_board_feedback`, **replace** your list with it, runs included. Fields the board does\n  not carry (references, prompt versions, trims) stay on the shot by id.\n- A long scene held in one shot comes with film-shot-generation' coverage recommendation on its card. Keep\n  the single shot only if the user chooses it on the board.\n- A card that film-shot-generation flags for a kinetic move on a big face, set on the board or changed\n  later, gets one short ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) before the run is compiled: the move as the user set it, or one of\n  film-shot-generation' safer versions. The camera stays the user's.\n- After a long stretch on one video, offer once to reopen the board to recap what comes next.\n  Honour a no without asking again.\n\n## 5. Cast, places and props\n\n**The project folder first**, before anything is generated. `picsart_drive_create_folder` with\n`path: \"Picsart Films/<film-slug>\"` and\n`children: [\"Library\", \"Assets\", \"Shots\", \"Exports\"]`. Keep every uid it returns in the record.\nSay it once, plainly: \"Created Picsart Films/the-garage in your Picsart Drive, with Library,\nAssets, Shots and Exports inside. Everything this film makes is filed there.\" Never say it again,\nand never list the whole Drive: no `list` without a `folderUid`. Pass the right `folderUid` on\nevery `picsart_generate` and `picsart_job_status` call of the film, and the project folder as\n`projectFolderUid` on every asset call. A finished job is filed only when you save it, as\npicsart-video-rules's SPEND rule 4 says: save every finished picture and take into its folder before you\nshow it. Never call a filed file permanent.\n\nThen film-cast-design's conveyor, in one pass:\n\n1. Draft every descriptor as film-cast-design says, then offer the cast board once\n   (film-cast-design, *The starting point*). It is the one stop here and costs nothing; a reply that\n   ignores it keeps the story's descriptors. There is no other approval round.\n2. Compile each picture with `picsart_film_compile_prompt` (a reference `kind`) and read its\n   `check`, then **one SPEND for the whole batch**: every sheet and plate on one\n   quote.\n3. Dispatch on the yes as one batch (picsart-video-rules, SPEND), with `folderUid` set to Assets, and\n   let the batch's card follow the jobs as picsart-video-rules says.\n4. Look at each picture (picsart-video-rules, Asset URLs) before anything uses it, then put them all on\n   `picsart_film_review_assets` in one call (at most 12 tiles; more go on a second board), with the one thing to judge them by as the board's `judge`, and one line per tile as its `assets[].why`.\n5. Act on the reply as `references/board-replies.md` says. Each approved asset is cut into views and\n   locked with `picsart_film_save_asset`, as film-cast-design says. A change is regenerated under its own SPEND and put on a fresh board with `assets[].version` and\n   `assets[].previousUrl`. A discarded tile is never used.\n\nA person the user photographed is saved as it came and is not put up for approval: it is theirs.\nfilm-cast-design flags what it cannot settle on its own, about a photo the user brought or about the\nfilm's era. Raise each flag once, as one short ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) with the options film-cast-design names. Anything\ngenerated is its own SPEND.\n\n## 6. Storyboard and animatic\n\nThe film is drafted on stills and sound, and the user watches it before any video is bought. Load\nfilm-animatic before you say what this stage needs or ask anything in it. Its yes is the gate into\nshooting.\n\n1. **Scene pictures.** Every scene gets its pictures: the wide, the scene picture cut from it,\n   and a room map where the scene cuts between walls, as film-shot-generation says. The scene\n   picture is the scene's opening panel and the opening frame of its first run.\n2. **One panel per shot**, compiled from its card and checked against its scene picture, as\n   film-animatic says. A real app's screen in a shot is built as a scene layer from the user's\n   own screenshots or recording, never generated. **One SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says) for every scene picture and\n   panel**, batched as picsart-video-rules says (at most 10 a call), and\n   `picsart_film_review_assets` for all of them, 12 tiles a board.\n3. **The sound**: every line in its person's voice, a bed per scene and the card's effects, as\n   film-animatic says, on one SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says), each voice line's real length probed before anything is\n   timed to it.\n4. **The animatic**: built, validated, cut-checked, looked at and watched cold as film-animatic says\n   (quality-review's cold watch, quoted first with its own SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says) unless every call is quoted at\n   0 credits), then REVIEWed in the scene editor,\n   with its sound, opened cold. Notes route as film-animatic says: a story note\n   goes back to stage 3's paragraph, a shot note to that panel or line alone, each change made\n   again under its own SPEND. Loop until the user says yes.\n\n**No still test.** The scene pictures are where the cast is checked, as film-cast-design says, and\nso are the panels: say in their review what you saw in each face. A change to a person or a prop goes back\nthrough stage 5's conveyor alone, under its own SPEND, on a fresh board.\n\n**The gate into shooting:** the animatic approved, film-cast-design's gate into a run held for every\nrun, and every scene it spans with approved pictures. A user who wants to shoot without the\nanimatic may, as a recorded override; never skip it yourself.\n\n## 7. Shooting\n\n**Which shots go to video is the user's.** ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) once, all shots recommended unless the\nanimatic showed a held panel works as it is; a shot kept as a panel stays in the cut as approved.\nQuote only the picked shots, each opening on its approved panel, as film-animatic says.\n\nBefore any run is quoted, a shot that film-shot-generation flags for a palette arguing with the film's\nscheme gets one short ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) with its options.\n\n1. **The forecast, once, before the first video:** runs × each run's seconds at the model's draft\n   rate from `picsart_preflight`, plus a margin for repairs, and the finish beside it. It is an\n   estimate, not a quote.\n2. **Shoot every run as a draft, in one batch**, as film-shot-generation says: the model's draft\n   setting or its lowest resolution, and no test run first. Every independent run is compiled,\n   verified and sent together, one call per run: one quote for the batch with the finish priced\n   beside it as an estimate, one yes, one monitor. The yes buys the drafts only. A run that waits for an earlier take (its frames\n   are the references) is its own SPEND once that take lands and passes your check.\n3. **No film so far.** While takes run, never assemble, cut, open or show the film so far: a landed\n   take waits for the others. As each take lands, find its actual cuts and judge it as\n   film-shot-generation's takes reference says. That is your technical check, not acceptance:\n   every take stays a candidate until the user approves the cut (8). No question between the\n   takes and the cut.\n4. Dialogue is judged in the cut's REVIEW, by ear. Say that the words were not checked against the\n   script by a tool.\n\nShooting is done when every take has landed and passed your check, with its actual cuts, prompt,\nquote and handle in the record. No take is accepted yet.\n\n## 8. The cut\n\nWhen the last take lands, film-cutting assembles the film once: every candidate take in story order\nwith hard cuts, every generation one clip exactly as generated: no split at a run's internal cuts,\nno trims, no transitions, padding or freeze frames. The user's own trims and splits are kept and\nnever recomputed. Check it with quality-review, its cold watch included (quoted first with its own SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says) unless\nevery call is quoted at 0 credits; on a no, the review line says \"no cold watch yet\"), then REVIEW the whole cut, unasked and opened cold: this is the film's review. Once the user has\nanswered, say what your check observed in each take. **The user's approval of the cut\naccepts every take in it**, and its shots become `final`.\n\n**Notes route by meaning**, as film-shot-generation says: an edit, an extend or a re-roll. A note it\nflags as ambiguous gets one short ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) between its two routes. **Each is its own SPEND**, shot as a draft\nlike the takes: a yes to a run is not a yes to its repair. A note on a seam is not a licence to buy footage: film-cutting's\njoin repair diagnoses first. A bridge between two runs is its own SPEND too, reviewed as\nfilm-cutting's join repair says. Apply what the user points at, re-cut once and open it again, until\nthey call it final. After that, change no picture unless they ask.\n\n## 9. Finishing\n\nIn this order, as film-finishing says: the finish of the draft takes, then colour, then sound.\n\n1. **Finish the approved cut**, as film-finishing says: from each draft's `finalizeDraft` handle\n   where it has one, otherwise an upscale or the approved run generated again at the finish\n   settings. It is its own SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says), after the cut is approved, asked as film-finishing's one\n   question: finish the approved takes, or keep the drafts. Then the cut is re-assembled at the\n   finish size with the user's trims.\n2. **Colour:** ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) with three or four looks that suit the film, from the look list in\n   `picsart_scene_capabilities` (`sections: [\"looksCompact\"]`). Applying one is free.\n   When the takes look glossy or plastic, as generated footage often does, one option is the\n   realism grade, applied as the realistic-color-grade skill says.\n3. **Music:** offer it once, only after the cut is final, and never bare: ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) with the brief\n   drafted as the background-music skill says, and three exits: generate it, change the brief, or skip. A\n   changed brief is redrafted and asked again; a skip is settled for the session. A yes is a SPEND,\n   as picsart-video-rules says. Lay the bed as film-finishing says, then REVIEW the film with it, on how it\n   sits under the dialogue. A note on its level moves it as the background-music skill says; a different\n   track goes back through the background-music skill's brief, with a new SPEND. A film going to festivals\n   or dubbing gets film-finishing's sound-team handoff offered once.\n\n## 10. Deliver\n\nDELIVER the final cut once, as picsart-video-rules says. Any further master from film-finishing's delivery\nlist is confirmed with one ASK before the first is exported. A master in another shape is reframed as the\nfootage-reframing skill says.\nThen film-finishing's archive and disclosure: give the user the disclosure text (every model used,\nper stage) and record it, and say generated music's licence is theirs to check before a festival or\na commercial use.\n\n## When something fails\n\n- **Out of credits: zero retries.** Say which step is paused and what it needs against the balance\n  `picsart_credits` reads. Keep the record and every job handle. Continue only when the user says\n  their credits are there; never poll the balance.\n- **A dropped call is not a failed generation**: follow its job as film-shot-generation says.\n- **A board that errors on a value** gets the value fixed and the board sent again. A board the\n  host cannot draw gets the host notes' fallback, and the gate still holds.\n- **Anything else a stage cannot run without** gets one identical retry, then one plain line: what\n  you tried, what blocked it, what you need. Never reword and refire.\n- **An outage is status, not a decision.** Keep going on everything free, keep the blocked item in\n  `openDecisions`, and try again next turn. Never offer a choice the rules already answer, such as\n  giving up a lead's consistency to dodge a temporary outage.\n"
Full snapshot data
{
  "description": "Make a short narrative film from a story - several scenes, recurring characters, one locked look - staged and approved step by step, drafted as an animatic before video. Use when the user wants a short film, a movie or a multi-scene story (\"I have a script\"), or carries on a film already under way here (its shot list, a change to one shot, or the next step). Load it first for any work on such a film; it brings in the film skills each step needs. Not for a drama series or its episodes (make-short-drama), a single clip, or footage the user already has.",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 176
    },
    {
      "relative_path": "references/board-replies.md",
      "size_in_bytes": 5697
    },
    {
      "relative_path": "references/project-record.md",
      "size_in_bytes": 6163
    },
    {
      "relative_path": "references/stages.md",
      "size_in_bytes": 8245
    }
  ],
  "name": "movie-producer",
  "skill_md_contents": "---\nname: movie-producer\ndescription: Make a short narrative film from a story - several scenes, recurring characters, one locked look - staged and approved step by step, drafted as an animatic before video. Use when the user wants a short film, a movie or a multi-scene story (\"I have a script\"), or carries on a film already under way here (its shot list, a change to one shot, or the next step). Load it first for any work on such a film; it brings in the film skills each step needs. Not for a drama series or its episodes (make-short-drama), a single clip, or footage the user already has.\nmetadata:\n  uses: film-story-writing, film-cast-design, film-shot-generation, film-animatic, voice-over-generation, film-cutting, film-finishing, footage-reframing, background-music, scene-building-basics, quality-review, realistic-color-grade, sd25-pe, sd2-pe\n  optional: realistic-color-grade\n  title: Produce a short film\n  short-description: Make a short film from your story, scene by scene\n  argument-hint: '[story idea or script]'\n  starter-prompt: Make a short film from my story.\n---\n\n# Short film\n\nA film is not a long video. The model has no memory between generations: describe a character\nloosely and he arrives in every shot with a different face, jacket and age. Everything here exists\nto beat that one problem, consistency, and it runs on one economic law: **stills are cheap, video\nis expensive.** Every decision that can be made on text, pictures and sound is made there: the\nuser watches the film as a voiced animatic, and says yes to it, before the first video is bought.\n\nRead picsart-video-rules first. One job: a story in, a short film out, with recurring people and places\nand one look.\n\nBefore acting on a stage, load the skills in its row that apply to this job, also when the work resumes there.\n\n| Stage | Gate | Skills |\n|---|---|---|\n| 1. The idea | — | — |\n| 2. The look | ASK | film-story-writing |\n| 3. The story and the model | ASK | film-story-writing, film-shot-generation, sd2-pe, sd25-pe |\n| 4. The shot list | ASK | film-story-writing, film-shot-generation |\n| 5. Cast, places and props | SPEND, ASK | film-cast-design |\n| 6. Storyboard and animatic | SPEND, ASK, REVIEW | film-animatic, film-shot-generation, film-cast-design, voice-over-generation, scene-building-basics, quality-review |\n| 7. Shooting | SPEND, ASK | film-shot-generation |\n| 8. The cut | SPEND, ASK, REVIEW | film-cutting, scene-building-basics, quality-review |\n| 9. Finishing | SPEND, ASK, REVIEW | film-finishing, background-music, realistic-color-grade |\n| 10. Deliver | ASK, DELIVER | film-finishing, footage-reframing |\n\nRead these before you need them:\n\n| File | Read it before you… |\n|---|---|\n| `references/stages.md` | say a stage is done, or open the next one |\n| `references/board-replies.md` | act on a reply from any board |\n| `references/project-record.md` | write or resume the project record |\n\n## Before you start\n\n**Route first.** The dividing line is recurring identity across scenes.\n\n| The user brings | Route |\n|---|---|\n| One clip's worth of idea (\"a boot stepping onto scree\") | Not this use case. Say so, and offer one generation: `picsart_model_choose`, then SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says) and `picsart_generate` |\n| Footage to cut together | Not this use case. Say it is not built yet here |\n| A story: scenes, people who recur, dialogue | This use case, from stage 1 |\n| A film already under way (a project record) | Resume: read the record, say where the film stands, continue at its stage |\n\n**Pace: director by default**, as picsart-video-rules says. In express pace the user comes in only for the\nboards, the three locks (the look, the story with its model, the assets), the animatic's review, every charged call no stated spend limit covers and\nanything beyond a quote.\n\n## How you talk to the user\n\nTalk and ask as picsart-video-rules says. Here that means:\n\n- one board per decision; everything else waits in the record's `openDecisions`;\n- what each board's reply holds is in `references/board-replies.md`;\n- where things stand reads like \"Stage 5 of 10 · cast, places and props — locking Cal (2 of 5\n  done)\", and the gate view shows which scenes have everything they need (\"not ready yet\", never\n  \"a hole\");\n- an alarm word is for a real gate violation, such as a video about to be bought for a scene\n  whose assets are not locked.\n\n## The project record\n\nThe film's state is one record, and it outranks your memory of it. Where the host gives you\nfiles, keep it as `film.json` in the working folder; otherwise keep it in the conversation and\ngive it to the user once, at the end of a working session, to paste back next time. Never print it\nmid-flow. Update it whole at every milestone: a gate passed, an asset locked, a batch dispatched or\nlanded, a review round, picture lock, the export. Its shape is `references/project-record.md`.\n\nBeside the facts it keeps the **brief**: the logline, the world in three sentences, the people as\npeople, and the standing decisions with their reasons (\"hard cuts only: the film is about\nabruptness\"). On resume, read it before saying where things stand. With no record at hand, take\nwhat the user says about the film as its state and carry on; ask for the record only when the step\nneeds a fact they have not given.\n\n## Gates\n\n**A gate is passed only when its checklist in `references/stages.md` is met**, or when the user\nconsciously overrides it; record the override and its reason. Before you say a stage is done or\nname the next one, write its checklist with ✓ or ✗ per line and the evidence beside each ✓ (a\nstatus a tool returned, a user's yes, a recorded override). A line with ✗ means the stage is not\ndone: say which line and what closes it.\n\n**Choosing how to meet a rule is your craft call; choosing to spend or risk money against a closed\ngate is never yours.** Which model shortlist, which order, whether a face needs one more view: yours,\nrecorded, never asked. Buying video for a scene whose assets are not locked, going beyond a quote,\ntrading quality for money: the user's.\n\n**The challenger at each decision.** Before you go on from a decision, quality-review's challenger (the\n`challenger` agent where the host has it) asks \"why this?\" of it: the idea (stage 1), the look and\nthe story (2, 3), the shot list (4), each sheet, plate, scene picture and panel picked and why (5, 6), and\nevery quote before its SPEND (5, 6, 7, 9, and a repair in 8 that needs a generation). Act on its\nverdict as quality-review says. A `stop`, or a `rethink` of the user's own choice, goes to the user in the\nnext ASK, the cheaper alternative first, before anything is spent.\n\n## 1. The idea\n\n- **Read the user's brief first.** Every file in the material that is not media, read in full\n  before the first question, as picsart-video-rules's The user's own brief says. A brief sets the message, the\n  audience and the must-shows.\n\nAsk for the idea only if the user has not given one. Once there is one, ask nothing more here:\nruntime and frame are set on the look console, and the story proposes an ending the user can\nchange.\n\n## 2. The look\n\n**`picsart_film_setup` comes first, before a word of story is written**, one call per visual\nworld. Genre decides how the story is told, and every shot card sits under what this console\nlocks: the style line, the lens family the cards' focal lengths come from, and the colour scheme\neach card's own palette has to fit.\n\n- Pre-set it from the idea with `suggested`, one `suggested.why` line each, as film-story-writing says: the genre the\n  events make, a tone when the story names a period, and the colour.\n- **`film` (the title) is required.** `ratio` and `duration` go inside `suggested.selections`, under\n  those field names, never as top-level arguments: the schema rejects anything it does not list.\n- **Pass `ratio` whenever the user named a format at all** (\"vertical\", \"TikTok\", \"square\"). Pass\n  the runtime they said as `duration`. Nothing infers a format; the console's default stands\n  otherwise.\n- The console is the ASK. On `film_setup_feedback` (`verdict: \"locked\"`), store `stylePrefix`\n  verbatim and the `selections` as they came. That lock is the look's lock; there is no later one.\n- If the genre changes at any point, film-story-writing rewrites the story first.\n\n## 3. The story and the model\n\n**The story.** film-story-writing writes it, for the locked genre, with its viewer track. State the identity budget\nyou inferred (\"two faces and one garage\") rather than asking for it. Show the track's after-watch questions under the\nstory, for correction: they are what the user and the cold watch are asked after each draft.\n\n**The model, in the same turn.** The candidates are the current models, in this order:\n\n| Model | Frame | Length per run | Reference images | Draft |\n|---|---|---|---|---|\n| `seedance-2.5` | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 | 4–30 s | 30 | `draft: true` |\n| `kling-v4-omni` | 16:9, 9:16, 1:1, 21:9 | 3–30 s | 8 | none: `720p` |\n| `wan-3.0-video` | 16:9, 9:16, 1:1, 4:3, 3:4 | 2–30 s | 10 | none: `480P` |\n| `veo-3.1` | 16:9, 9:16 | 4, 6 or 8 s | 3 | none: `720p` |\n\nRead each one's `picsart_model_params` before the board (film-shot-generation's model steps 2 and\n3); the table is a guide, the params decide. Drop a candidate only when its params cannot hold the\nfilm's frame or its runs (Veo 3.1 holds no 1:1 and no run over 8 s). Never offer an older model\n(Seedance 2.0, its Fast and Mini, Kling V3, Hailuo, Wan 2.7) unless the user names it. The user's\nbalance and the cheapest-first rule set the draft resolution, never the model: they never put an\nolder model on the board or make one `recommended`.\n\nOpen `picsart_model_choose` under the story with the candidates that survive, in that order, the\nfirst one `candidates[].recommended`, each `candidates[].bestFor` line written as this film's trade\n(\"one continuous 30 s take, tops out at 720p\").\n\n- The pick is the story's yes unless the user sends a note with it. A note about what happens is\n  answered as film-story-writing says, and the rewritten paragraph is shown again with the model board.\n- On the pick, record the model, its take ceiling and its edit and extend siblings, as film-shot-generation\n  finds them. One model for the whole film. A Seedance pick (`seedance-…`) also brings in the `sd25-pe`\n  skill for Seedance 2.5 or `sd2-pe` for Seedance 2.0, as film-shot-generation's Seedance reference says.\n\n## 4. The shot list\n\n**`picsart_film_shotlist` once, with every scene in one call.** Load film-story-writing before you write\nthe cards: it turns the approved story into them, and its peak rule marks one card, the `Peak`\nline's shot, with the moved face `unguarded` and what shows (\"@teo relief, unguarded: the tears\ncome\"), every other face held in; film-shot-generation packs them into runs against the model's ceiling, with one join\nsentence on the shot that opens each run. Pass `film`, the model, and the setup's defaults, so the\nuser never picks from a vocabulary the film has not adopted.\n\n- The board approves camera and seconds. It is not a place to rewrite the story: an edit that\n  changes what happens is a story note, so rewrite the paragraph first, then open the board again.\n- On `shotlist_board_feedback`, **replace** your list with it, runs included. Fields the board does\n  not carry (references, prompt versions, trims) stay on the shot by id.\n- A long scene held in one shot comes with film-shot-generation' coverage recommendation on its card. Keep\n  the single shot only if the user chooses it on the board.\n- A card that film-shot-generation flags for a kinetic move on a big face, set on the board or changed\n  later, gets one short ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) before the run is compiled: the move as the user set it, or one of\n  film-shot-generation' safer versions. The camera stays the user's.\n- After a long stretch on one video, offer once to reopen the board to recap what comes next.\n  Honour a no without asking again.\n\n## 5. Cast, places and props\n\n**The project folder first**, before anything is generated. `picsart_drive_create_folder` with\n`path: \"Picsart Films/<film-slug>\"` and\n`children: [\"Library\", \"Assets\", \"Shots\", \"Exports\"]`. Keep every uid it returns in the record.\nSay it once, plainly: \"Created Picsart Films/the-garage in your Picsart Drive, with Library,\nAssets, Shots and Exports inside. Everything this film makes is filed there.\" Never say it again,\nand never list the whole Drive: no `list` without a `folderUid`. Pass the right `folderUid` on\nevery `picsart_generate` and `picsart_job_status` call of the film, and the project folder as\n`projectFolderUid` on every asset call. A finished job is filed only when you save it, as\npicsart-video-rules's SPEND rule 4 says: save every finished picture and take into its folder before you\nshow it. Never call a filed file permanent.\n\nThen film-cast-design's conveyor, in one pass:\n\n1. Draft every descriptor as film-cast-design says, then offer the cast board once\n   (film-cast-design, *The starting point*). It is the one stop here and costs nothing; a reply that\n   ignores it keeps the story's descriptors. There is no other approval round.\n2. Compile each picture with `picsart_film_compile_prompt` (a reference `kind`) and read its\n   `check`, then **one SPEND for the whole batch**: every sheet and plate on one\n   quote.\n3. Dispatch on the yes as one batch (picsart-video-rules, SPEND), with `folderUid` set to Assets, and\n   let the batch's card follow the jobs as picsart-video-rules says.\n4. Look at each picture (picsart-video-rules, Asset URLs) before anything uses it, then put them all on\n   `picsart_film_review_assets` in one call (at most 12 tiles; more go on a second board), with the one thing to judge them by as the board's `judge`, and one line per tile as its `assets[].why`.\n5. Act on the reply as `references/board-replies.md` says. Each approved asset is cut into views and\n   locked with `picsart_film_save_asset`, as film-cast-design says. A change is regenerated under its own SPEND and put on a fresh board with `assets[].version` and\n   `assets[].previousUrl`. A discarded tile is never used.\n\nA person the user photographed is saved as it came and is not put up for approval: it is theirs.\nfilm-cast-design flags what it cannot settle on its own, about a photo the user brought or about the\nfilm's era. Raise each flag once, as one short ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) with the options film-cast-design names. Anything\ngenerated is its own SPEND.\n\n## 6. Storyboard and animatic\n\nThe film is drafted on stills and sound, and the user watches it before any video is bought. Load\nfilm-animatic before you say what this stage needs or ask anything in it. Its yes is the gate into\nshooting.\n\n1. **Scene pictures.** Every scene gets its pictures: the wide, the scene picture cut from it,\n   and a room map where the scene cuts between walls, as film-shot-generation says. The scene\n   picture is the scene's opening panel and the opening frame of its first run.\n2. **One panel per shot**, compiled from its card and checked against its scene picture, as\n   film-animatic says. A real app's screen in a shot is built as a scene layer from the user's\n   own screenshots or recording, never generated. **One SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says) for every scene picture and\n   panel**, batched as picsart-video-rules says (at most 10 a call), and\n   `picsart_film_review_assets` for all of them, 12 tiles a board.\n3. **The sound**: every line in its person's voice, a bed per scene and the card's effects, as\n   film-animatic says, on one SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says), each voice line's real length probed before anything is\n   timed to it.\n4. **The animatic**: built, validated, cut-checked, looked at and watched cold as film-animatic says\n   (quality-review's cold watch, quoted first with its own SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says) unless every call is quoted at\n   0 credits), then REVIEWed in the scene editor,\n   with its sound, opened cold. Notes route as film-animatic says: a story note\n   goes back to stage 3's paragraph, a shot note to that panel or line alone, each change made\n   again under its own SPEND. Loop until the user says yes.\n\n**No still test.** The scene pictures are where the cast is checked, as film-cast-design says, and\nso are the panels: say in their review what you saw in each face. A change to a person or a prop goes back\nthrough stage 5's conveyor alone, under its own SPEND, on a fresh board.\n\n**The gate into shooting:** the animatic approved, film-cast-design's gate into a run held for every\nrun, and every scene it spans with approved pictures. A user who wants to shoot without the\nanimatic may, as a recorded override; never skip it yourself.\n\n## 7. Shooting\n\n**Which shots go to video is the user's.** ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) once, all shots recommended unless the\nanimatic showed a held panel works as it is; a shot kept as a panel stays in the cut as approved.\nQuote only the picked shots, each opening on its approved panel, as film-animatic says.\n\nBefore any run is quoted, a shot that film-shot-generation flags for a palette arguing with the film's\nscheme gets one short ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) with its options.\n\n1. **The forecast, once, before the first video:** runs × each run's seconds at the model's draft\n   rate from `picsart_preflight`, plus a margin for repairs, and the finish beside it. It is an\n   estimate, not a quote.\n2. **Shoot every run as a draft, in one batch**, as film-shot-generation says: the model's draft\n   setting or its lowest resolution, and no test run first. Every independent run is compiled,\n   verified and sent together, one call per run: one quote for the batch with the finish priced\n   beside it as an estimate, one yes, one monitor. The yes buys the drafts only. A run that waits for an earlier take (its frames\n   are the references) is its own SPEND once that take lands and passes your check.\n3. **No film so far.** While takes run, never assemble, cut, open or show the film so far: a landed\n   take waits for the others. As each take lands, find its actual cuts and judge it as\n   film-shot-generation's takes reference says. That is your technical check, not acceptance:\n   every take stays a candidate until the user approves the cut (8). No question between the\n   takes and the cut.\n4. Dialogue is judged in the cut's REVIEW, by ear. Say that the words were not checked against the\n   script by a tool.\n\nShooting is done when every take has landed and passed your check, with its actual cuts, prompt,\nquote and handle in the record. No take is accepted yet.\n\n## 8. The cut\n\nWhen the last take lands, film-cutting assembles the film once: every candidate take in story order\nwith hard cuts, every generation one clip exactly as generated: no split at a run's internal cuts,\nno trims, no transitions, padding or freeze frames. The user's own trims and splits are kept and\nnever recomputed. Check it with quality-review, its cold watch included (quoted first with its own SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says) unless\nevery call is quoted at 0 credits; on a no, the review line says \"no cold watch yet\"), then REVIEW the whole cut, unasked and opened cold: this is the film's review. Once the user has\nanswered, say what your check observed in each take. **The user's approval of the cut\naccepts every take in it**, and its shots become `final`.\n\n**Notes route by meaning**, as film-shot-generation says: an edit, an extend or a re-roll. A note it\nflags as ambiguous gets one short ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) between its two routes. **Each is its own SPEND**, shot as a draft\nlike the takes: a yes to a run is not a yes to its repair. A note on a seam is not a licence to buy footage: film-cutting's\njoin repair diagnoses first. A bridge between two runs is its own SPEND too, reviewed as\nfilm-cutting's join repair says. Apply what the user points at, re-cut once and open it again, until\nthey call it final. After that, change no picture unless they ask.\n\n## 9. Finishing\n\nIn this order, as film-finishing says: the finish of the draft takes, then colour, then sound.\n\n1. **Finish the approved cut**, as film-finishing says: from each draft's `finalizeDraft` handle\n   where it has one, otherwise an upscale or the approved run generated again at the finish\n   settings. It is its own SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says), after the cut is approved, asked as film-finishing's one\n   question: finish the approved takes, or keep the drafts. Then the cut is re-assembled at the\n   finish size with the user's trims.\n2. **Colour:** ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) with three or four looks that suit the film, from the look list in\n   `picsart_scene_capabilities` (`sections: [\"looksCompact\"]`). Applying one is free.\n   When the takes look glossy or plastic, as generated footage often does, one option is the\n   realism grade, applied as the realistic-color-grade skill says.\n3. **Music:** offer it once, only after the cut is final, and never bare: ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) with the brief\n   drafted as the background-music skill says, and three exits: generate it, change the brief, or skip. A\n   changed brief is redrafted and asked again; a skip is settled for the session. A yes is a SPEND,\n   as picsart-video-rules says. Lay the bed as film-finishing says, then REVIEW the film with it, on how it\n   sits under the dialogue. A note on its level moves it as the background-music skill says; a different\n   track goes back through the background-music skill's brief, with a new SPEND. A film going to festivals\n   or dubbing gets film-finishing's sound-team handoff offered once.\n\n## 10. Deliver\n\nDELIVER the final cut once, as picsart-video-rules says. Any further master from film-finishing's delivery\nlist is confirmed with one ASK before the first is exported. A master in another shape is reframed as the\nfootage-reframing skill says.\nThen film-finishing's archive and disclosure: give the user the disclosure text (every model used,\nper stage) and record it, and say generated music's licence is theirs to check before a festival or\na commercial use.\n\n## When something fails\n\n- **Out of credits: zero retries.** Say which step is paused and what it needs against the balance\n  `picsart_credits` reads. Keep the record and every job handle. Continue only when the user says\n  their credits are there; never poll the balance.\n- **A dropped call is not a failed generation**: follow its job as film-shot-generation says.\n- **A board that errors on a value** gets the value fixed and the board sent again. A board the\n  host cannot draw gets the host notes' fallback, and the gate still holds.\n- **Anything else a stage cannot run without** gets one identical retry, then one plain line: what\n  you tried, what blocked it, what you need. Never reword and refire.\n- **An outage is status, not a decision.** Keep going on everything free, keep the blocked item in\n  `openDecisions`, and try again next turn. Never offer a choice the rules already answer, such as\n  giving up a lead's consistency to dodge a temporary outage.\n"
}

SHA-256 of public snapshot: 5c6600011132aa8456d70a0aeb41af520fc4df3a827550d6f6fd3e5d8a691361