{"id":78704,"plugin_id":"plugin_asdk_app_6a18d4c190a0819186e6b129a09e931e","kind":"skill","collection_source":"plugin_package","comparison_source":"plugin_package","observed_at":"2026-11-03T18:14:02.156Z","digest":"d153405ae4acf6345d9cd31760bc691ebd6492e094f6612ef656786e7b658b31","against":65261,"payload":{"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.","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":5550},{"relative_path":"references/stages.md","size_in_bytes":7226}],"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. 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"},"changes":[{"path":"/included_files","type":"changed","before":[{"relative_path":"agents/openai.yaml","size_in_bytes":176},{"relative_path":"references/board-replies.md","size_in_bytes":5503},{"relative_path":"references/project-record.md","size_in_bytes":5552},{"relative_path":"references/stages.md","size_in_bytes":6676}],"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":5550},{"relative_path":"references/stages.md","size_in_bytes":7226}]},{"path":"/skill_md_contents","type":"changed","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\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, REVIEW | film-shot-generation, scene-building-basics, quality-review |\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 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 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.\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 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 check it with\n   `picsart_film_verify_prompt`, 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 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**The cast on stills:** film-cast-design's test of the locked cast is **one SPEND for the batch**, before\nthe first run. A person who fails it goes back through stage 5's conveyor alone: the tightened\ndescriptor, a new sheet under its own SPEND, and a fresh board.\n\n**The gate into shooting:** film-cast-design's gate into a run holds for every run, every scene it spans\nhas approved pictures, and the cast passed its stills. 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 its options.\n\n1. **The forecast, once, before the first video:** runs × two takes × each run's seconds at the\n   model's draft rate from `picsart_preflight`, plus a margin for repairs, beside the\n   final-resolution pass at its finish rate. It is an estimate, not a quote.\n2. **One run first.** If the whole film is one run, that is the film. Otherwise the riskiest run:\n   the one with dialogue and the most cuts. SPEND on its own quote, saying a re-roll costs again.\n   Every run is shot as a draft, as film-shot-generation says; the finish settings come only in Finishing.\n   What it teaches goes into the recipe before the rest are bought.\n3. **Then the rest, as a conveyor**: independent runs dispatched together, each run compiled, verified and\n   sent as film-shot-generation says, one call per run. One quote for the batch, one yes, one monitor.\n4. **Every take that lands opens REVIEW in that turn, unasked.** film-shot-generation splits it at the cuts\n   it actually made. Build the whole film so far with film-cutting's assembly, every accepted take\n   plus the new one in story order, check it with quality-review, and open it in\n   `picsart_scene_editor`. Never a review of the new take alone: what fails is the join.\n5. **Notes route by meaning**, as film-shot-generation says: an edit, an extend or a re-roll. A note it\n   flags as ambiguous gets one short ASK between its two routes. **Each is its own SPEND.** A yes\n   to the run is not a yes to its repair.\n6. Dialogue is judged in REVIEW, by ear. Say that the words were not checked against the script\n   by a tool.\n\nA scene block is done when every run in it is accepted and split at its real cuts, every shot is\nfinal, and every prompt, quote and take is in the record.\n\n## 8. The cut\n\nfilm-cutting assembles the selects into one scene, hard cuts within a scene, every shot its own clip\nover its run file. Check it with quality-review, then REVIEW the whole cut. Apply what the user points\nat and open it again, until they call it final. A note on a seam is not a licence to buy footage:\nfilm-cutting's join repair diagnoses first, and a repair that needs a generation is its own SPEND. So\nis a bridge between two runs, reviewed as film-cutting's join repair says. After the user calls the cut\nfinal, change no picture unless they ask.\n\n## 9. Finishing\n\nIn this order, as film-finishing says: the final-resolution pass, then colour, then sound.\n\n1. **The final-resolution pass**, as film-finishing describes it, on its own quote and its own\n   yes, after asking whether the drafts are good enough to keep.\n2. **Colour:** ASK 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 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. 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"}],"summary":"Fields changed: 2. /included_files, /skill_md_contents.","summary_kind":"deterministic","summary_metadata":{}}