Update to Picsart
Snapshot Nov 11, 2026 · 00:08 UTC · version 2.5.0
Collection source: downloaded plugin package.
Payment or plan references changed
Skill instructions — Now says: local-scripts: pick_style.py, style_check.py, build_index.py **A style from our library supplies its own breakdown.** When the user brought no reference...
Observed in published text. Live prices and checkout terms have not been verified by this change.
Up to 3 plugins free · no card required.
All fields and original values.
Skill instructions
Nov 7, 2026 · 00:09 UTC
**A reference video is read with the tools.** Every call below except the probe and the stills may charge credits, and a tool charges only when its description says so. Quote what the read will cost, then SPEND (quote it in one line, the...
Nov 11, 2026 · 00:08 UTC
local-scripts: pick_style.py, style_check.py, build_index.py **A style from our library supplies its own breakdown.** When the user brought no reference and the use case builds in a style, read `references/style-library.md` (how the on...
Supporting files
Nov 7, 2026 · 00:09 UTC
[{"relative_path":"references/format.md","size_in_bytes":5615},{"relative_path":"scripts/map_structure.py","size_in_bytes":15055},{"relative_path":"scripts/ref_format.py","size_in_bytes":19619},{"relative_path":"scripts/reuse_guard.py","...
Nov 11, 2026 · 00:08 UTC
[{"relative_path":"data/catalog-55.104.0.json","size_in_bytes":58910},{"relative_path":"references/format.md","size_in_bytes":5615},{"relative_path":"references/skin-thanksgiving.md","size_in_bytes":7260},{"relative_path":"references/sty...
Compare saved observations
Download comparison JSONSKILL.md text changes
− removed · + added
--- before +++ after @@ -3,6 +3,7 @@ description: Read a reference reel's structure and format, never its content - its beats, shots, caption pattern, pace and bed into a structure sheet (or parse a written breakdown for free), its layout, captions, hook and end card into the record's format, with what the footage can match; fit the user's script to the beats, and report each beat as matched, changed, dropped or added, with the content rules checked. Use when a short should be built the way a reference reel is built or looks, including the user's own channel. metadata: source: channel team breakdowns and tools/reuse_guard.py, commit 3f064f0 + local-scripts: pick_style.py, style_check.py, build_index.py --- # Reel structure @@ -29,19 +30,31 @@ python3 scripts/sheet.py parse breakdown.md --out sheet.json ``` -**A reference video is read with the tools.** Every call below except the probe and the stills -may charge credits, and a tool charges only when its description says so. Quote what the read -will cost, 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). The calls do not depend on each other; run them at the same time, -and follow each job receipt as picsart-video-rules says. - -| Tool | What it gives the sheet | -|---|---| -| `picsart_media_probe` | length, frame size, and whether there is audio | -| `picsart_media_segment_shots` over the whole length | the shots: holds and transitions | -| `picsart_media_transcribe` | the words' timing, for the pace and for the reuse check, never to reuse them | -| `picsart_media_describe_video` with `detail: "deep"` | shot types, camera moves, on-screen text style, per shot | -| `picsart_media_analyze_audio` | the bed: tempo and loudness | -| `picsart_media_video_stills` | one still per beat, **for the user to look at only**, never an input to a generation | +**A style from our library supplies its own breakdown.** When the user brought no reference and the use case +builds in a style, read `references/style-library.md` (how the one best-fitting style is picked +for the footage, how it becomes the sheet and the format with no read and no SPEND, and how it is +built) and `references/style-index.md` (one line per style); then open only the picked style's +file, `styles/<id>.md`, never the whole folder. For a Thanksgiving or Friendsgiving reel, also read +`references/skin-thanksgiving.md` (the full skin); never on other occasions. + +**A reference video is read with the tools, and the read is required**: none of it is optional +when the user sends a reel to follow. Run each required analysis below. Use the tool's billing +contract and picsart-video-rules's SPEND rule: quote any charged call, 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). +Follow each job receipt as picsart-video-rules says. + +| Order | Tool | What it gives the sheet | +|---|---|---| +| 1 | `picsart_media_probe` | length, frame size, frame rate, and whether there is audio | +| 1 | `picsart_media_segment_shots` over the whole length | the shots: holds and transitions, each with the step to sample it at | +| 2 | `picsart_media_video_stills` | at least 8 frames per shot, and every transition at its suggested step, at 480 px wide or more (never 180 px tiles); crop sheets (`crop`) of each frame, border and title, so a frame's shape (wavy, hand-drawn, doodled) is read, not guessed | +| 3 | `picsart_media_track_motion` | every card, photo and title that moves, measured (below) | +| 3 | `picsart_media_analyze_audio` | the bed's beat grid, tempo and loudness, when there is music | +| 3 | `picsart_media_transcribe` | only when someone speaks: the words' timing, for the pace and the reuse check, never to reuse them. Never on a music-only reel | +| any | `picsart_media_describe_video` with `detail: "standard"` | what each shot shows and its on-screen text, in words; optional when the use case says so, and quoted whenever it runs | + +The stills are **for the user to look at only**, never an input to a generation; you read the +reference from them too. +The calls in one row of the order run at the same time. Keep each result as it came back (as files, where you run commands), then draft the sheet from them. No video is decoded here: @@ -52,8 +65,57 @@ The draft has one row per shot (a long shot is split at its sentences). A short transition is a cut, and a long one is a move inside the shot: check each boundary on the stills. Every field -the tools cannot know is `?`. **Name every beat yourself**, from the watch and the stills: join -rows that make one beat, and fill picture, on screen, caption and sound. +the tools cannot know is `?`. **Name every beat yourself**, from the stills (and the watch when it +ran): join rows that make one beat, and fill picture, on screen, caption and sound. + +**Measure the moves; never guess them.** The stills show what moves; the motion tools measure it. +Track every move the edit adds with `picsart_media_track_motion`, as the +motion-tracking-from-video skill says: +- a push, punch-in or pan on a shot or photo: the whole frame is the target; +- a photo, card or title that slides, scales or turns, with `"mode": "similarity"` (`"corners"` + when it skews or tilts in 3D), from automatic targets or boxes read off the stills; +- a seam that moves the picture; +- a sticker or object that leads a reveal (a title wiped in as it passes). + +Each window runs from the frame before the move starts to the frame after it settles, at the +video's own frame rate. Track every window; never guess a move to save a call. Targets that +share a window go in one call. Then read each move's easing with that skill's `fit_motion.py moves --into sheet.json`: +it adds the moves to the sheet's `moves`. Set each one's `track` to the result's `resultUrl`. +Write what it measured in the beat's Move cell: from and to, how long, the delay, the curve and the +overshoot (for example "card 1 up 1625→760 px over 0.77 s from 2.10 s, ease out, no overshoot"). +Keep each result, as files where you run commands, for the build and the check. A camera move filmed +in the reference's own footage goes in the Shot cell and is not tracked: the user's footage has its +own. A move the tracker cannot see, such as a wipe or a fade, is read from cropped stills, one per +frame, as that skill says. Record those observations in the beat's `stillMeasurements`: each +entry names the `target`, a `channel` of `opacity` or `reveal`, and at least two ordered `frames` +with `t` in source seconds, `source` identifying the frame, and the observed `value` from 0 to 1. +The values must change and the observations must overlap the beat. For example: + +```json +{"target":"title","channel":"reveal","frames":[ + {"t":2.0,"source":"stills/title-060.png","value":0}, + {"t":2.5,"source":"stills/title-075.png","value":1} +]} +``` + +The Move cell describes those numbers. A `(stills)` label alone is not evidence; position, +scale and rotation still require tracking. + +Every moving beat declares `motionRequirements`, listing **every** target and channel observed +in the reference, independently of the evidence collected. For a card that slides and fades: +`[{"target":"card1","channel":"position"},{"target":"card1","channel":"opacity"}]`. +The gate checks each requirement separately: matching tracked moves for position, scale and +rotation; matching frame measurements for opacity and reveal. Evidence for one target or channel +cannot cover another. Write the Move cell from this complete list, never use prose to opt out. + +A sheet from a reference video passes the measured check before anything is mapped onto it: + +``` +python3 scripts/sheet.py validate sheet.json --measured +``` + +It refuses a moving beat without overlapping tracked or supported still measurements, a Move +cell with words alone, and a Move left `?`. ## 2. The sheet @@ -111,10 +173,12 @@ ``` Then answer each element against the user's footage: reproduced, approximated (say how) or -impossible. Anything not reproduced: 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 a rendered mock (one free frame of their +impossible. For a reference video, an element that moves (a text animation, a card's move, a frame +that turns) says "measured" with its moves in its answer, never a look alone. Anything not reproduced: 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 a rendered mock (one free frame of their footage in the format) beside the reference still, and keep the answer in the block. `ref_format.py feasibility format.json` refuses while an element is open. The reference stage is -done only with a sheet that passes `sheet.py validate` and no open feasibility row. +done only with a sheet that passes `sheet.py validate` (with `--measured` for a reference video) +and no open feasibility row. ## 4. Map the script
Full technical diff · 2 changed fields
changed /included_files
[
{
"relative_path": "references/format.md",
"size_in_bytes": 5615
},
{
"relative_path": "scripts/map_structure.py",
"size_in_bytes": 15055
},
{
"relative_path": "scripts/ref_format.py",
"size_in_bytes": 19619
},
{
"relative_path": "scripts/reuse_guard.py",
"size_in_bytes": 9134
},
{
"relative_path": "scripts/sheet.py",
"size_in_bytes": 40067
},
{
"relative_path": "scripts/structure_report.py",
"size_in_bytes": 28761
}
][
{
"relative_path": "data/catalog-55.104.0.json",
"size_in_bytes": 58910
},
{
"relative_path": "references/format.md",
"size_in_bytes": 5615
},
{
"relative_path": "references/skin-thanksgiving.md",
"size_in_bytes": 7260
},
{
"relative_path": "references/style-index.md",
"size_in_bytes": 13621
},
{
"relative_path": "references/style-library.md",
"size_in_bytes": 17597
},
{
"relative_path": "scripts/build_index.py",
"size_in_bytes": 3598
},
{
"relative_path": "scripts/map_structure.py",
"size_in_bytes": 15055
},
{
"relative_path": "scripts/pick_style.py",
"size_in_bytes": 15700
},
{
"relative_path": "scripts/ref_format.py",
"size_in_bytes": 19619
},
{
"relative_path": "scripts/reuse_guard.py",
"size_in_bytes": 9134
},
{
"relative_path": "scripts/sheet.py",
"size_in_bytes": 47575
},
{
"relative_path": "scripts/structure_report.py",
"size_in_bytes": 28761
},
{
"relative_path": "scripts/style_check.py",
"size_in_bytes": 5876
},
{
"relative_path": "styles/arched-card.md",
"size_in_bytes": 2287
},
{
"relative_path": "styles/autumn-season-rush.md",
"size_in_bytes": 6087
},
{
"relative_path": "styles/bars-reveal.md",
"size_in_bytes": 1931
},
{
"relative_path": "styles/beat-cut-recap.md",
"size_in_bytes": 1457
},
{
"relative_path": "styles/bw-editorial.md",
"size_in_bytes": 1969
},
{
"relative_path": "styles/bw-slowmo.md",
"size_in_bytes": 1497
},
{
"relative_path": "styles/bw-to-colour.md",
"size_in_bytes": 1738
},
{
"relative_path": "styles/calendar-fill.md",
"size_in_bytes": 2488
},
{
"relative_path": "styles/caption-card.md",
"size_in_bytes": 2264
},
{
"relative_path": "styles/card-fan.md",
"size_in_bytes": 1676
},
{
"relative_path": "styles/chapter-cards.md",
"size_in_bytes": 2329
},
{
"relative_path": "styles/circle-frame-reel.md",
"size_in_bytes": 2986
},
{
"relative_path": "styles/city-list-poster.md",
"size_in_bytes": 2341
},
{
"relative_path": "styles/clock-collage.md",
"size_in_bytes": 2088
},
{
"relative_path": "styles/coming-soon.md",
"size_in_bytes": 2342
},
{
"relative_path": "styles/contact-sheet.md",
"size_in_bytes": 3563
},
{
"relative_path": "styles/countdown-intro.md",
"size_in_bytes": 1715
},
{
"relative_path": "styles/curved-caption.md",
"size_in_bytes": 1803
},
{
"relative_path": "styles/daily-preview-flash.md",
"size_in_bytes": 4543
},
{
"relative_path": "styles/date-badge.md",
"size_in_bytes": 2266
},
{
"relative_path": "styles/dear-month.md",
"size_in_bytes": 2437
},
{
"relative_path": "styles/digicam-flash.md",
"size_in_bytes": 1925
},
{
"relative_path": "styles/doodle-book.md",
"size_in_bytes": 3674
},
{
"relative_path": "styles/duotone-poster.md",
"size_in_bytes": 2019
},
{
"relative_path": "styles/editorial-split.md",
"size_in_bytes": 2091
},
{
"relative_path": "styles/end-credits.md",
"size_in_bytes": 2487
},
{
"relative_path": "styles/event-recap-title.md",
"size_in_bytes": 1868
},
{
"relative_path": "styles/film-memories.md",
"size_in_bytes": 1979
},
{
"relative_path": "styles/film-strip.md",
"size_in_bytes": 1367
},
{
"relative_path": "styles/framed-window.md",
"size_in_bytes": 2095
},
{
"relative_path": "styles/freeze-frame-snap.md",
"size_in_bytes": 1905
},
{
"relative_path": "styles/freeze-sticker.md",
"size_in_bytes": 3549
},
{
"relative_path": "styles/giant-word-punch.md",
"size_in_bytes": 3055
},
{
"relative_path": "styles/golden-glow.md",
"size_in_bytes": 1910
},
{
"relative_path": "styles/grid-focus.md",
"size_in_bytes": 1579
},
{
"relative_path": "styles/grid-pullback.md",
"size_in_bytes": 1436
},
{
"relative_path": "styles/grid-reveal.md",
"size_in_bytes": 1481
},
{
"relative_path": "styles/hard-shadow-pop.md",
"size_in_bytes": 1873
},
{
"relative_path": "styles/heart-frame.md",
"size_in_bytes": 1870
},
{
"relative_path": "styles/hello-month.md",
"size_in_bytes": 2588
},
{
"relative_path": "styles/highlight-caption.md",
"size_in_bytes": 2010
},
{
"relative_path": "styles/hundred-photos.md",
"size_in_bytes": 2335
},
{
"relative_path": "styles/instant-frames.md",
"size_in_bytes": 1800
},
{
"relative_path": "styles/kinetic-word-stack.md",
"size_in_bytes": 2961
},
{
"relative_path": "styles/label-chip-cards.md",
"size_in_bytes": 2323
},
{
"relative_path": "styles/light-leak.md",
"size_in_bytes": 1913
},
{
"relative_path": "styles/magazine-cover.md",
"size_in_bytes": 3421
},
{
"relative_path": "styles/matted-flash-recap.md",
"size_in_bytes": 2081
},
{
"relative_path": "styles/mini-vlog-title.md",
"size_in_bytes": 1673
},
{
"relative_path": "styles/month-list.md",
"size_in_bytes": 2548
},
{
"relative_path": "styles/moody-noir.md",
"size_in_bytes": 1755
},
{
"relative_path": "styles/mosaic-open.md",
"size_in_bytes": 1911
},
{
"relative_path": "styles/neon-sparkle.md",
"size_in_bytes": 2404
},
{
"relative_path": "styles/night-vision-party.md",
"size_in_bytes": 1790
},
{
"relative_path": "styles/notebook-page.md",
"size_in_bytes": 2051
},
{
"relative_path": "styles/number-cards.md",
"size_in_bytes": 1748
},
{
"relative_path": "styles/numbered-film-recap.md",
"size_in_bytes": 2220
},
{
"relative_path": "styles/old-movie-stutter.md",
"size_in_bytes": 5875
},
{
"relative_path": "styles/one-clip-slowmo.md",
"size_in_bytes": 1866
},
{
"relative_path": "styles/outline-echo.md",
"size_in_bytes": 2635
},
{
"relative_path": "styles/paper-gallery.md",
"size_in_bytes": 2306
},
{
"relative_path": "styles/party-word-knockout.md",
"size_in_bytes": 6690
},
{
"relative_path": "styles/peek-slide.md",
"size_in_bytes": 1814
},
{
"relative_path": "styles/photo-burst.md",
"size_in_bytes": 1543
},
{
"relative_path": "styles/photo-in-letters.md",
"size_in_bytes": 2125
},
{
"relative_path": "styles/photobooth-strip.md",
"size_in_bytes": 1609
},
{
"relative_path": "styles/poem-lines.md",
"size_in_bytes": 2084
},
{
"relative_path": "styles/polaroid-cards.md",
"size_in_bytes": 1473
},
{
"relative_path": "styles/polaroid-collage.md",
"size_in_bytes": 1629
},
{
"relative_path": "styles/postage-stamps.md",
"size_in_bytes": 2575
},
{
"relative_path": "styles/quiet-affirmation.md",
"size_in_bytes": 2293
},
{
"relative_path": "styles/quiet-caption.md",
"size_in_bytes": 2118
},
{
"relative_path": "styles/rewind-ramp.md",
"size_in_bytes": 1949
},
{
"relative_path": "styles/scrapbook-drops.md",
"size_in_bytes": 1811
},
{
"relative_path": "styles/season-tiles.md",
"size_in_bytes": 2342
},
{
"relative_path": "styles/selfies-beat-shake.md",
"size_in_bytes": 6162
},
{
"relative_path": "styles/shake-beats.md",
"size_in_bytes": 1682
},
{
"relative_path": "styles/shape-windows.md",
"size_in_bytes": 2222
},
{
"relative_path": "styles/sideways-turn.md",
"size_in_bytes": 2493
},
{
"relative_path": "styles/slice-wipe.md",
"size_in_bytes": 1900
},
{
"relative_path": "styles/slide-projector.md",
"size_in_bytes": 2173
},
{
"relative_path": "styles/slowmo-dump.md",
"size_in_bytes": 1629
},
{
"relative_path": "styles/slowmo-flash.md",
"size_in_bytes": 1719
},
{
"relative_path": "styles/split-panels.md",
"size_in_bytes": 1452
},
{
"relative_path": "styles/split-tone-title.md",
"size_in_bytes": 2375
},
{
"relative_path": "styles/stacked-handwriting.md",
"size_in_bytes": 2204
},
{
"relative_path": "styles/stamp-collage.md",
"size_in_bytes": 2390
},
{
"relative_path": "styles/starry-script.md",
"size_in_bytes": 2376
},
{
"relative_path": "styles/sticker-collage.md",
"size_in_bytes": 3726
},
{
"relative_path": "styles/sticker-wall.md",
"size_in_bytes": 3596
},
{
"relative_path": "styles/storybook-words.md",
"size_in_bytes": 2196
},
{
"relative_path": "styles/strip-stack.md",
"size_in_bytes": 3578
},
{
"relative_path": "styles/strobe-recap.md",
"size_in_bytes": 1588
},
{
"relative_path": "styles/swipe-post.md",
"size_in_bytes": 1676
},
{
"relative_path": "styles/switch-on.md",
"size_in_bytes": 2394
},
{
"relative_path": "styles/thankful-list.md",
"size_in_bytes": 2621
},
{
"relative_path": "styles/three-word-stack.md",
"size_in_bytes": 2339
},
{
"relative_path": "styles/timestamped-day.md",
"size_in_bytes": 2139
},
{
"relative_path": "styles/title-flash-recap.md",
"size_in_bytes": 2223
},
{
"relative_path": "styles/title-mosaic.md",
"size_in_bytes": 2353
},
{
"relative_path": "styles/title-window.md",
"size_in_bytes": 2140
},
{
"relative_path": "styles/torn-paper-pages.md",
"size_in_bytes": 2268
},
{
"relative_path": "styles/travel-welcome-recap.md",
"size_in_bytes": 8257
},
{
"relative_path": "styles/typed-message.md",
"size_in_bytes": 2173
},
{
"relative_path": "styles/vcr-home-video.md",
"size_in_bytes": 1862
},
{
"relative_path": "styles/velocity-ramp.md",
"size_in_bytes": 1907
},
{
"relative_path": "styles/viewfinder-rec.md",
"size_in_bytes": 2175
},
{
"relative_path": "styles/whip-pan.md",
"size_in_bytes": 2325
},
{
"relative_path": "styles/whiteout-dissolve.md",
"size_in_bytes": 2256
},
{
"relative_path": "styles/widescreen-mono.md",
"size_in_bytes": 1668
},
{
"relative_path": "styles/widescreen-vlog.md",
"size_in_bytes": 2538
},
{
"relative_path": "styles/word-cards.md",
"size_in_bytes": 2418
},
{
"relative_path": "styles/word-countdown.md",
"size_in_bytes": 2563
},
{
"relative_path": "styles/word-per-shot.md",
"size_in_bytes": 1869
},
{
"relative_path": "styles/year-counter.md",
"size_in_bytes": 2008
},
{
"relative_path": "styles/year-flip.md",
"size_in_bytes": 2459
},
{
"relative_path": "styles/zoom-through-travel.md",
"size_in_bytes": 2085
}
]changed /skill_md_contents
"---\nname: reel-structure\ndescription: Read a reference reel's structure and format, never its content - its beats, shots, caption pattern, pace and bed into a structure sheet (or parse a written breakdown for free), its layout, captions, hook and end card into the record's format, with what the footage can match; fit the user's script to the beats, and report each beat as matched, changed, dropped or added, with the content rules checked. Use when a short should be built the way a reference reel is built or looks, including the user's own channel.\nmetadata:\n source: channel team breakdowns and tools/reuse_guard.py, commit 3f064f0\n---\n\n# Reel structure\n\nA reference reel lends its **structure**: where its beats fall, how its shots and captions\nwork, how fast it talks, what sits under the voice. Its **content** stays its own. Nothing the\nviewer can see or hear of the reference reaches the user's video: no words, no frames, no audio\nor music. Only its pattern is copied.\n\nThe method has five steps: read the structure into a sheet, check the sheet with the user, read\nthe format and what the footage can match of it, map the user's script onto the beats, and report\nwhat matched and what changed. A job with no script (cutting footage to a reference) stops after\nthe format.\n\n**The user's own channel is different**: its format is the spec to reproduce, and its logo, end\ncard, fonts and copy are theirs (own-brand mode, `references/format.md`).\n\n## 1. Read the structure\n\n**A written breakdown is free.** When the user brings a beat-by-beat breakdown, parse it and skip\nthe read:\n\n```\npython3 scripts/sheet.py parse breakdown.md --out sheet.json\n```\n\n**A reference video is read with the tools.** Every call below except the probe and the stills\nmay charge credits, and a tool charges only when its description says so. Quote what the read\nwill cost, 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). The calls do not depend on each other; run them at the same time,\nand follow each job receipt as picsart-video-rules says.\n\n| Tool | What it gives the sheet |\n|---|---|\n| `picsart_media_probe` | length, frame size, and whether there is audio |\n| `picsart_media_segment_shots` over the whole length | the shots: holds and transitions |\n| `picsart_media_transcribe` | the words' timing, for the pace and for the reuse check, never to reuse them |\n| `picsart_media_describe_video` with `detail: \"deep\"` | shot types, camera moves, on-screen text style, per shot |\n| `picsart_media_analyze_audio` | the bed: tempo and loudness |\n| `picsart_media_video_stills` | one still per beat, **for the user to look at only**, never an input to a generation |\n\nKeep each result as it came back (as files, where you run commands), then draft the sheet from them. No video is decoded here:\n\n```\npython3 scripts/sheet.py draft --shots shots.json --transcript transcript.json \\\n --describe describe.json --audio audio.json --probe probe.json --out sheet.json\n```\n\nThe draft has one row per shot (a long shot is split at its sentences). A short transition is a\ncut, and a long one is a move inside the shot: check each boundary on the stills. Every field\nthe tools cannot know is `?`. **Name every beat yourself**, from the watch and the stills: join\nrows that make one beat, and fill picture, on screen, caption and sound.\n\n## 2. The sheet\n\nOne row per beat, or several rows for a long one, in this table:\n\n```\n| Time (s) | Beat | What happens (picture) | Voice | On screen | Shot | Move | Caption | Sound |\n```\n\n- **Beat** names its role: hook, stake, twist, joke run, feeling, reveal, turn, payoff, CTA,\n and the retention-hooks skill's intensifier and rehook. Join two with `+` (\"Payoff + CTA\").\n A reference with its own beat (\"Steps\") keeps that name. Consecutive rows with the same name\n (reveal, reveal (soft), reveal) stay rows in the sheet and are **one beat** to the mapping\n and the report, from the first row's start to the last row's end.\n- **`soft`** in the Beat cell marks a beat that starts mid-shot with no line. Its edges are\n checked within 1 s; every other beat's within 0.5 s.\n- **Voice** is the reference's words, kept only so the reuse check can compare with them, and the\n pace in words a second comes from it. **On screen** is checked for pattern only. **Caption**\n is the caption style and timing (\"top, whole reel\"; \"word by word, centre\"). **Sound** is voice\n only, bed, or effects.\n- **`?` is unknown**, never a value and never an error: a `?` time, a `?` cell, or `?` with a\n note. Never guess one. The map step needs every beat timed and named, and says which are not.\n- A header above the table, as `- Key: value` lines: Format (talking head, POV skit, screen\n tutorial, list, reaction), Length, Cut rate, Caption style, Layout, Bed, Loudness and Source.\n **Layout** names the mode and who sits where: `split-v (top host, bottom guest)`.\n- Two more columns after Sound when the reference has a format to keep: **Frame** (the beat's\n layout, or who fills it: `split-v`, `full: guest`) and **Caption position** (`seam`, `top`,\n `centre`, `lower third`). Length,\n cut rate and loudness keep their number and the line as written (`- Cut rate: ~19 cuts/min\n (21 picture changes…)`). A file with several sheets parses with `parse --all`.\n\nA short breakdown (`| Time | Beat | What happens |`) parses too: its quoted lines become Voice,\nor On screen when the words before them name a caption or a title.\n\nCheck the sheet, and write it as Markdown for the user:\n\n```\npython3 scripts/sheet.py validate sheet.json\npython3 scripts/sheet.py markdown sheet.json --out sheet.md\n```\n\nShow the user the sheet with the stills, and fix what they correct. Then 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) whether the sheet\nis the structure to copy, before anything is mapped onto it.\n\n## 3. The format, and what the footage can match\n\nRead how the reference looks into the record's `format`, as `references/format.md` says: the\nlayout and who sits where, the emphasis, the captions' style and **position**, the hook, the end\ncard and, for the user's own channel, the brand files. Draft it from the sheet, then fill it from\nthe stills:\n\n```\npython3 scripts/ref_format.py from-sheet sheet.json --source own-brand --out format.json\npython3 scripts/ref_format.py check format.json\n```\n\nThen answer each element against the user's footage: reproduced, approximated (say how) or\nimpossible. Anything not reproduced: 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 a rendered mock (one free frame of their\nfootage in the format) beside the reference still, and keep the answer in the block.\n`ref_format.py feasibility format.json` refuses while an element is open. The reference stage is\ndone only with a sheet that passes `sheet.py validate` and no open feasibility row.\n\n## 4. Map the script\n\nThe user's script is a table with a Time column, and a Beat column where the writer said which\nreference beat a row copies. Fit it to the sheet:\n\n```\npython3 scripts/map_structure.py sheet.json script.md --spans allowed-spans.json --out mapping.json\n```\n\n- The first row opens on the reference's hook.\n- A row named for a beat takes the next beat of that name. A time range on the reference's\n clock in its Beat cell, with the sheet's id (\"F1 36–54 s\"), carries it over the later beats\n that range covers. Beats never run backwards.\n- An unnamed row between two rows of one beat joins it. Any other unnamed row is **added**: it is\n the user's own, and it is kept. When no row is named, each takes the beat its middle falls in.\n- Each beat gets the reference's share of the length. Rows scale by at most 15 %, and a beat\n within 15 % of its share matches; otherwise it is **changed**, with the reason.\n- **The allowed spans are placed first and never stretched**: a row over the user's own screen\n clip keeps its length.\n- A beat no row takes is **dropped**, and the report says so. **No row is ever dropped.**\n\n## 5. Report\n\n```\npython3 scripts/structure_report.py sheet.json mapping.json --transcript transcript.json \\\n --media media.json\n```\n\nAdd `--own-brand` for the user's own channel, with its logo, end card and fonts listed under\n`brand` in the media list: they and its on-screen copy are reported \"own brand, allowed\".\n\nThe report has one line per reference beat (its time, the user's rows, matched / changed /\ndropped, the reason), then one per added row. Below it, the content rules, each passed, failed\nor not checked:\n\n| Rule | Checks |\n|---|---|\n| words | no run of 4 or more of the reference's spoken words in a voice line (`scripts/reuse_guard.py`) |\n| captions | the on-screen words are the user's own, short whole-caption copies included; only the caption pattern is copied |\n| pictures | no still or clip of the reference is a generation input |\n| sound | no audio or music of the reference is in the cut |\n\nThe media list (`media.json` where you run commands, else kept in the record) lists the reference's URL and every still or clip made from it, the URLs given to\neach generation, and the audio in the cut; an empty list says none was used, and a missing list is\nnot checked. Without it, pictures and sound are not checked, and the report says so; never call\nthem passed. Likewise words and captions are not checked while the reference's Voice or On screen\ncells are `?` and no `--transcript` covers the speech.\n\n**A failed rule is fixed, not waived.** Rewrite the line, or change the input. A format label\nnobody owns (\"get ready with me\", \"GRWM\", \"POV\", \"storytime\") passes on screen, and the report\nnames it \"genre phrase, allowed\"; show that line to the user. Any other phrase shared with the\nreference stays only when the user chooses it: 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) whether to keep it, and pass it as\n`--allow \"<phrase>\"`. To check a whole script file\non its own, `python3 scripts/reuse_guard.py transcript.json script.md` lists every shared run\nwith its line.\n\nShow the user the report beside the sheet. When beats are changed or dropped, 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) whether to\nrework the script toward the reference or keep the changes, one beat at a time.\n"
"---\nname: reel-structure\ndescription: Read a reference reel's structure and format, never its content - its beats, shots, caption pattern, pace and bed into a structure sheet (or parse a written breakdown for free), its layout, captions, hook and end card into the record's format, with what the footage can match; fit the user's script to the beats, and report each beat as matched, changed, dropped or added, with the content rules checked. Use when a short should be built the way a reference reel is built or looks, including the user's own channel.\nmetadata:\n source: channel team breakdowns and tools/reuse_guard.py, commit 3f064f0\n local-scripts: pick_style.py, style_check.py, build_index.py\n---\n\n# Reel structure\n\nA reference reel lends its **structure**: where its beats fall, how its shots and captions\nwork, how fast it talks, what sits under the voice. Its **content** stays its own. Nothing the\nviewer can see or hear of the reference reaches the user's video: no words, no frames, no audio\nor music. Only its pattern is copied.\n\nThe method has five steps: read the structure into a sheet, check the sheet with the user, read\nthe format and what the footage can match of it, map the user's script onto the beats, and report\nwhat matched and what changed. A job with no script (cutting footage to a reference) stops after\nthe format.\n\n**The user's own channel is different**: its format is the spec to reproduce, and its logo, end\ncard, fonts and copy are theirs (own-brand mode, `references/format.md`).\n\n## 1. Read the structure\n\n**A written breakdown is free.** When the user brings a beat-by-beat breakdown, parse it and skip\nthe read:\n\n```\npython3 scripts/sheet.py parse breakdown.md --out sheet.json\n```\n\n**A style from our library supplies its own breakdown.** When the user brought no reference and the use case\nbuilds in a style, read `references/style-library.md` (how the one best-fitting style is picked\nfor the footage, how it becomes the sheet and the format with no read and no SPEND, and how it is\nbuilt) and `references/style-index.md` (one line per style); then open only the picked style's\nfile, `styles/<id>.md`, never the whole folder. For a Thanksgiving or Friendsgiving reel, also read\n`references/skin-thanksgiving.md` (the full skin); never on other occasions.\n\n**A reference video is read with the tools, and the read is required**: none of it is optional\nwhen the user sends a reel to follow. Run each required analysis below. Use the tool's billing\ncontract and picsart-video-rules's SPEND rule: quote any charged call, 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).\nFollow each job receipt as picsart-video-rules says.\n\n| Order | Tool | What it gives the sheet |\n|---|---|---|\n| 1 | `picsart_media_probe` | length, frame size, frame rate, and whether there is audio |\n| 1 | `picsart_media_segment_shots` over the whole length | the shots: holds and transitions, each with the step to sample it at |\n| 2 | `picsart_media_video_stills` | at least 8 frames per shot, and every transition at its suggested step, at 480 px wide or more (never 180 px tiles); crop sheets (`crop`) of each frame, border and title, so a frame's shape (wavy, hand-drawn, doodled) is read, not guessed |\n| 3 | `picsart_media_track_motion` | every card, photo and title that moves, measured (below) |\n| 3 | `picsart_media_analyze_audio` | the bed's beat grid, tempo and loudness, when there is music |\n| 3 | `picsart_media_transcribe` | only when someone speaks: the words' timing, for the pace and the reuse check, never to reuse them. Never on a music-only reel |\n| any | `picsart_media_describe_video` with `detail: \"standard\"` | what each shot shows and its on-screen text, in words; optional when the use case says so, and quoted whenever it runs |\n\nThe stills are **for the user to look at only**, never an input to a generation; you read the\nreference from them too.\nThe calls in one row of the order run at the same time.\n\nKeep each result as it came back (as files, where you run commands), then draft the sheet from them. No video is decoded here:\n\n```\npython3 scripts/sheet.py draft --shots shots.json --transcript transcript.json \\\n --describe describe.json --audio audio.json --probe probe.json --out sheet.json\n```\n\nThe draft has one row per shot (a long shot is split at its sentences). A short transition is a\ncut, and a long one is a move inside the shot: check each boundary on the stills. Every field\nthe tools cannot know is `?`. **Name every beat yourself**, from the stills (and the watch when it\nran): join rows that make one beat, and fill picture, on screen, caption and sound.\n\n**Measure the moves; never guess them.** The stills show what moves; the motion tools measure it.\nTrack every move the edit adds with `picsart_media_track_motion`, as the\nmotion-tracking-from-video skill says:\n- a push, punch-in or pan on a shot or photo: the whole frame is the target;\n- a photo, card or title that slides, scales or turns, with `\"mode\": \"similarity\"` (`\"corners\"`\n when it skews or tilts in 3D), from automatic targets or boxes read off the stills;\n- a seam that moves the picture;\n- a sticker or object that leads a reveal (a title wiped in as it passes).\n\nEach window runs from the frame before the move starts to the frame after it settles, at the\nvideo's own frame rate. Track every window; never guess a move to save a call. Targets that\nshare a window go in one call. Then read each move's easing with that skill's `fit_motion.py moves --into sheet.json`:\nit adds the moves to the sheet's `moves`. Set each one's `track` to the result's `resultUrl`.\nWrite what it measured in the beat's Move cell: from and to, how long, the delay, the curve and the\novershoot (for example \"card 1 up 1625→760 px over 0.77 s from 2.10 s, ease out, no overshoot\").\nKeep each result, as files where you run commands, for the build and the check. A camera move filmed\nin the reference's own footage goes in the Shot cell and is not tracked: the user's footage has its\nown. A move the tracker cannot see, such as a wipe or a fade, is read from cropped stills, one per\nframe, as that skill says. Record those observations in the beat's `stillMeasurements`: each\nentry names the `target`, a `channel` of `opacity` or `reveal`, and at least two ordered `frames`\nwith `t` in source seconds, `source` identifying the frame, and the observed `value` from 0 to 1.\nThe values must change and the observations must overlap the beat. For example:\n\n```json\n{\"target\":\"title\",\"channel\":\"reveal\",\"frames\":[\n {\"t\":2.0,\"source\":\"stills/title-060.png\",\"value\":0},\n {\"t\":2.5,\"source\":\"stills/title-075.png\",\"value\":1}\n]}\n```\n\nThe Move cell describes those numbers. A `(stills)` label alone is not evidence; position,\nscale and rotation still require tracking.\n\nEvery moving beat declares `motionRequirements`, listing **every** target and channel observed\nin the reference, independently of the evidence collected. For a card that slides and fades:\n`[{\"target\":\"card1\",\"channel\":\"position\"},{\"target\":\"card1\",\"channel\":\"opacity\"}]`.\nThe gate checks each requirement separately: matching tracked moves for position, scale and\nrotation; matching frame measurements for opacity and reveal. Evidence for one target or channel\ncannot cover another. Write the Move cell from this complete list, never use prose to opt out.\n\nA sheet from a reference video passes the measured check before anything is mapped onto it:\n\n```\npython3 scripts/sheet.py validate sheet.json --measured\n```\n\nIt refuses a moving beat without overlapping tracked or supported still measurements, a Move\ncell with words alone, and a Move left `?`.\n\n## 2. The sheet\n\nOne row per beat, or several rows for a long one, in this table:\n\n```\n| Time (s) | Beat | What happens (picture) | Voice | On screen | Shot | Move | Caption | Sound |\n```\n\n- **Beat** names its role: hook, stake, twist, joke run, feeling, reveal, turn, payoff, CTA,\n and the retention-hooks skill's intensifier and rehook. Join two with `+` (\"Payoff + CTA\").\n A reference with its own beat (\"Steps\") keeps that name. Consecutive rows with the same name\n (reveal, reveal (soft), reveal) stay rows in the sheet and are **one beat** to the mapping\n and the report, from the first row's start to the last row's end.\n- **`soft`** in the Beat cell marks a beat that starts mid-shot with no line. Its edges are\n checked within 1 s; every other beat's within 0.5 s.\n- **Voice** is the reference's words, kept only so the reuse check can compare with them, and the\n pace in words a second comes from it. **On screen** is checked for pattern only. **Caption**\n is the caption style and timing (\"top, whole reel\"; \"word by word, centre\"). **Sound** is voice\n only, bed, or effects.\n- **`?` is unknown**, never a value and never an error: a `?` time, a `?` cell, or `?` with a\n note. Never guess one. The map step needs every beat timed and named, and says which are not.\n- A header above the table, as `- Key: value` lines: Format (talking head, POV skit, screen\n tutorial, list, reaction), Length, Cut rate, Caption style, Layout, Bed, Loudness and Source.\n **Layout** names the mode and who sits where: `split-v (top host, bottom guest)`.\n- Two more columns after Sound when the reference has a format to keep: **Frame** (the beat's\n layout, or who fills it: `split-v`, `full: guest`) and **Caption position** (`seam`, `top`,\n `centre`, `lower third`). Length,\n cut rate and loudness keep their number and the line as written (`- Cut rate: ~19 cuts/min\n (21 picture changes…)`). A file with several sheets parses with `parse --all`.\n\nA short breakdown (`| Time | Beat | What happens |`) parses too: its quoted lines become Voice,\nor On screen when the words before them name a caption or a title.\n\nCheck the sheet, and write it as Markdown for the user:\n\n```\npython3 scripts/sheet.py validate sheet.json\npython3 scripts/sheet.py markdown sheet.json --out sheet.md\n```\n\nShow the user the sheet with the stills, and fix what they correct. Then 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) whether the sheet\nis the structure to copy, before anything is mapped onto it.\n\n## 3. The format, and what the footage can match\n\nRead how the reference looks into the record's `format`, as `references/format.md` says: the\nlayout and who sits where, the emphasis, the captions' style and **position**, the hook, the end\ncard and, for the user's own channel, the brand files. Draft it from the sheet, then fill it from\nthe stills:\n\n```\npython3 scripts/ref_format.py from-sheet sheet.json --source own-brand --out format.json\npython3 scripts/ref_format.py check format.json\n```\n\nThen answer each element against the user's footage: reproduced, approximated (say how) or\nimpossible. For a reference video, an element that moves (a text animation, a card's move, a frame\nthat turns) says \"measured\" with its moves in its answer, never a look alone. Anything not reproduced: 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 a rendered mock (one free frame of their\nfootage in the format) beside the reference still, and keep the answer in the block.\n`ref_format.py feasibility format.json` refuses while an element is open. The reference stage is\ndone only with a sheet that passes `sheet.py validate` (with `--measured` for a reference video)\nand no open feasibility row.\n\n## 4. Map the script\n\nThe user's script is a table with a Time column, and a Beat column where the writer said which\nreference beat a row copies. Fit it to the sheet:\n\n```\npython3 scripts/map_structure.py sheet.json script.md --spans allowed-spans.json --out mapping.json\n```\n\n- The first row opens on the reference's hook.\n- A row named for a beat takes the next beat of that name. A time range on the reference's\n clock in its Beat cell, with the sheet's id (\"F1 36–54 s\"), carries it over the later beats\n that range covers. Beats never run backwards.\n- An unnamed row between two rows of one beat joins it. Any other unnamed row is **added**: it is\n the user's own, and it is kept. When no row is named, each takes the beat its middle falls in.\n- Each beat gets the reference's share of the length. Rows scale by at most 15 %, and a beat\n within 15 % of its share matches; otherwise it is **changed**, with the reason.\n- **The allowed spans are placed first and never stretched**: a row over the user's own screen\n clip keeps its length.\n- A beat no row takes is **dropped**, and the report says so. **No row is ever dropped.**\n\n## 5. Report\n\n```\npython3 scripts/structure_report.py sheet.json mapping.json --transcript transcript.json \\\n --media media.json\n```\n\nAdd `--own-brand` for the user's own channel, with its logo, end card and fonts listed under\n`brand` in the media list: they and its on-screen copy are reported \"own brand, allowed\".\n\nThe report has one line per reference beat (its time, the user's rows, matched / changed /\ndropped, the reason), then one per added row. Below it, the content rules, each passed, failed\nor not checked:\n\n| Rule | Checks |\n|---|---|\n| words | no run of 4 or more of the reference's spoken words in a voice line (`scripts/reuse_guard.py`) |\n| captions | the on-screen words are the user's own, short whole-caption copies included; only the caption pattern is copied |\n| pictures | no still or clip of the reference is a generation input |\n| sound | no audio or music of the reference is in the cut |\n\nThe media list (`media.json` where you run commands, else kept in the record) lists the reference's URL and every still or clip made from it, the URLs given to\neach generation, and the audio in the cut; an empty list says none was used, and a missing list is\nnot checked. Without it, pictures and sound are not checked, and the report says so; never call\nthem passed. Likewise words and captions are not checked while the reference's Voice or On screen\ncells are `?` and no `--transcript` covers the speech.\n\n**A failed rule is fixed, not waived.** Rewrite the line, or change the input. A format label\nnobody owns (\"get ready with me\", \"GRWM\", \"POV\", \"storytime\") passes on screen, and the report\nnames it \"genre phrase, allowed\"; show that line to the user. Any other phrase shared with the\nreference stays only when the user chooses it: 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) whether to keep it, and pass it as\n`--allow \"<phrase>\"`. To check a whole script file\non its own, `python3 scripts/reuse_guard.py transcript.json script.md` lists every shared run\nwith its line.\n\nShow the user the report beside the sheet. When beats are changed or dropped, 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) whether to\nrework the script toward the reference or keep the changes, one beat at a time.\n"Full snapshot data
{
"description": "Read a reference reel's structure and format, never its content - its beats, shots, caption pattern, pace and bed into a structure sheet (or parse a written breakdown for free), its layout, captions, hook and end card into the record's format, with what the footage can match; fit the user's script to the beats, and report each beat as matched, changed, dropped or added, with the content rules checked. Use when a short should be built the way a reference reel is built or looks, including the user's own channel.",
"included_files": [
{
"relative_path": "data/catalog-55.104.0.json",
"size_in_bytes": 58910
},
{
"relative_path": "references/format.md",
"size_in_bytes": 5615
},
{
"relative_path": "references/skin-thanksgiving.md",
"size_in_bytes": 7260
},
{
"relative_path": "references/style-index.md",
"size_in_bytes": 13621
},
{
"relative_path": "references/style-library.md",
"size_in_bytes": 17597
},
{
"relative_path": "scripts/build_index.py",
"size_in_bytes": 3598
},
{
"relative_path": "scripts/map_structure.py",
"size_in_bytes": 15055
},
{
"relative_path": "scripts/pick_style.py",
"size_in_bytes": 15700
},
{
"relative_path": "scripts/ref_format.py",
"size_in_bytes": 19619
},
{
"relative_path": "scripts/reuse_guard.py",
"size_in_bytes": 9134
},
{
"relative_path": "scripts/sheet.py",
"size_in_bytes": 47575
},
{
"relative_path": "scripts/structure_report.py",
"size_in_bytes": 28761
},
{
"relative_path": "scripts/style_check.py",
"size_in_bytes": 5876
},
{
"relative_path": "styles/arched-card.md",
"size_in_bytes": 2287
},
{
"relative_path": "styles/autumn-season-rush.md",
"size_in_bytes": 6087
},
{
"relative_path": "styles/bars-reveal.md",
"size_in_bytes": 1931
},
{
"relative_path": "styles/beat-cut-recap.md",
"size_in_bytes": 1457
},
{
"relative_path": "styles/bw-editorial.md",
"size_in_bytes": 1969
},
{
"relative_path": "styles/bw-slowmo.md",
"size_in_bytes": 1497
},
{
"relative_path": "styles/bw-to-colour.md",
"size_in_bytes": 1738
},
{
"relative_path": "styles/calendar-fill.md",
"size_in_bytes": 2488
},
{
"relative_path": "styles/caption-card.md",
"size_in_bytes": 2264
},
{
"relative_path": "styles/card-fan.md",
"size_in_bytes": 1676
},
{
"relative_path": "styles/chapter-cards.md",
"size_in_bytes": 2329
},
{
"relative_path": "styles/circle-frame-reel.md",
"size_in_bytes": 2986
},
{
"relative_path": "styles/city-list-poster.md",
"size_in_bytes": 2341
},
{
"relative_path": "styles/clock-collage.md",
"size_in_bytes": 2088
},
{
"relative_path": "styles/coming-soon.md",
"size_in_bytes": 2342
},
{
"relative_path": "styles/contact-sheet.md",
"size_in_bytes": 3563
},
{
"relative_path": "styles/countdown-intro.md",
"size_in_bytes": 1715
},
{
"relative_path": "styles/curved-caption.md",
"size_in_bytes": 1803
},
{
"relative_path": "styles/daily-preview-flash.md",
"size_in_bytes": 4543
},
{
"relative_path": "styles/date-badge.md",
"size_in_bytes": 2266
},
{
"relative_path": "styles/dear-month.md",
"size_in_bytes": 2437
},
{
"relative_path": "styles/digicam-flash.md",
"size_in_bytes": 1925
},
{
"relative_path": "styles/doodle-book.md",
"size_in_bytes": 3674
},
{
"relative_path": "styles/duotone-poster.md",
"size_in_bytes": 2019
},
{
"relative_path": "styles/editorial-split.md",
"size_in_bytes": 2091
},
{
"relative_path": "styles/end-credits.md",
"size_in_bytes": 2487
},
{
"relative_path": "styles/event-recap-title.md",
"size_in_bytes": 1868
},
{
"relative_path": "styles/film-memories.md",
"size_in_bytes": 1979
},
{
"relative_path": "styles/film-strip.md",
"size_in_bytes": 1367
},
{
"relative_path": "styles/framed-window.md",
"size_in_bytes": 2095
},
{
"relative_path": "styles/freeze-frame-snap.md",
"size_in_bytes": 1905
},
{
"relative_path": "styles/freeze-sticker.md",
"size_in_bytes": 3549
},
{
"relative_path": "styles/giant-word-punch.md",
"size_in_bytes": 3055
},
{
"relative_path": "styles/golden-glow.md",
"size_in_bytes": 1910
},
{
"relative_path": "styles/grid-focus.md",
"size_in_bytes": 1579
},
{
"relative_path": "styles/grid-pullback.md",
"size_in_bytes": 1436
},
{
"relative_path": "styles/grid-reveal.md",
"size_in_bytes": 1481
},
{
"relative_path": "styles/hard-shadow-pop.md",
"size_in_bytes": 1873
},
{
"relative_path": "styles/heart-frame.md",
"size_in_bytes": 1870
},
{
"relative_path": "styles/hello-month.md",
"size_in_bytes": 2588
},
{
"relative_path": "styles/highlight-caption.md",
"size_in_bytes": 2010
},
{
"relative_path": "styles/hundred-photos.md",
"size_in_bytes": 2335
},
{
"relative_path": "styles/instant-frames.md",
"size_in_bytes": 1800
},
{
"relative_path": "styles/kinetic-word-stack.md",
"size_in_bytes": 2961
},
{
"relative_path": "styles/label-chip-cards.md",
"size_in_bytes": 2323
},
{
"relative_path": "styles/light-leak.md",
"size_in_bytes": 1913
},
{
"relative_path": "styles/magazine-cover.md",
"size_in_bytes": 3421
},
{
"relative_path": "styles/matted-flash-recap.md",
"size_in_bytes": 2081
},
{
"relative_path": "styles/mini-vlog-title.md",
"size_in_bytes": 1673
},
{
"relative_path": "styles/month-list.md",
"size_in_bytes": 2548
},
{
"relative_path": "styles/moody-noir.md",
"size_in_bytes": 1755
},
{
"relative_path": "styles/mosaic-open.md",
"size_in_bytes": 1911
},
{
"relative_path": "styles/neon-sparkle.md",
"size_in_bytes": 2404
},
{
"relative_path": "styles/night-vision-party.md",
"size_in_bytes": 1790
},
{
"relative_path": "styles/notebook-page.md",
"size_in_bytes": 2051
},
{
"relative_path": "styles/number-cards.md",
"size_in_bytes": 1748
},
{
"relative_path": "styles/numbered-film-recap.md",
"size_in_bytes": 2220
},
{
"relative_path": "styles/old-movie-stutter.md",
"size_in_bytes": 5875
},
{
"relative_path": "styles/one-clip-slowmo.md",
"size_in_bytes": 1866
},
{
"relative_path": "styles/outline-echo.md",
"size_in_bytes": 2635
},
{
"relative_path": "styles/paper-gallery.md",
"size_in_bytes": 2306
},
{
"relative_path": "styles/party-word-knockout.md",
"size_in_bytes": 6690
},
{
"relative_path": "styles/peek-slide.md",
"size_in_bytes": 1814
},
{
"relative_path": "styles/photo-burst.md",
"size_in_bytes": 1543
},
{
"relative_path": "styles/photo-in-letters.md",
"size_in_bytes": 2125
},
{
"relative_path": "styles/photobooth-strip.md",
"size_in_bytes": 1609
},
{
"relative_path": "styles/poem-lines.md",
"size_in_bytes": 2084
},
{
"relative_path": "styles/polaroid-cards.md",
"size_in_bytes": 1473
},
{
"relative_path": "styles/polaroid-collage.md",
"size_in_bytes": 1629
},
{
"relative_path": "styles/postage-stamps.md",
"size_in_bytes": 2575
},
{
"relative_path": "styles/quiet-affirmation.md",
"size_in_bytes": 2293
},
{
"relative_path": "styles/quiet-caption.md",
"size_in_bytes": 2118
},
{
"relative_path": "styles/rewind-ramp.md",
"size_in_bytes": 1949
},
{
"relative_path": "styles/scrapbook-drops.md",
"size_in_bytes": 1811
},
{
"relative_path": "styles/season-tiles.md",
"size_in_bytes": 2342
},
{
"relative_path": "styles/selfies-beat-shake.md",
"size_in_bytes": 6162
},
{
"relative_path": "styles/shake-beats.md",
"size_in_bytes": 1682
},
{
"relative_path": "styles/shape-windows.md",
"size_in_bytes": 2222
},
{
"relative_path": "styles/sideways-turn.md",
"size_in_bytes": 2493
},
{
"relative_path": "styles/slice-wipe.md",
"size_in_bytes": 1900
},
{
"relative_path": "styles/slide-projector.md",
"size_in_bytes": 2173
},
{
"relative_path": "styles/slowmo-dump.md",
"size_in_bytes": 1629
},
{
"relative_path": "styles/slowmo-flash.md",
"size_in_bytes": 1719
},
{
"relative_path": "styles/split-panels.md",
"size_in_bytes": 1452
},
{
"relative_path": "styles/split-tone-title.md",
"size_in_bytes": 2375
},
{
"relative_path": "styles/stacked-handwriting.md",
"size_in_bytes": 2204
},
{
"relative_path": "styles/stamp-collage.md",
"size_in_bytes": 2390
},
{
"relative_path": "styles/starry-script.md",
"size_in_bytes": 2376
},
{
"relative_path": "styles/sticker-collage.md",
"size_in_bytes": 3726
},
{
"relative_path": "styles/sticker-wall.md",
"size_in_bytes": 3596
},
{
"relative_path": "styles/storybook-words.md",
"size_in_bytes": 2196
},
{
"relative_path": "styles/strip-stack.md",
"size_in_bytes": 3578
},
{
"relative_path": "styles/strobe-recap.md",
"size_in_bytes": 1588
},
{
"relative_path": "styles/swipe-post.md",
"size_in_bytes": 1676
},
{
"relative_path": "styles/switch-on.md",
"size_in_bytes": 2394
},
{
"relative_path": "styles/thankful-list.md",
"size_in_bytes": 2621
},
{
"relative_path": "styles/three-word-stack.md",
"size_in_bytes": 2339
},
{
"relative_path": "styles/timestamped-day.md",
"size_in_bytes": 2139
},
{
"relative_path": "styles/title-flash-recap.md",
"size_in_bytes": 2223
},
{
"relative_path": "styles/title-mosaic.md",
"size_in_bytes": 2353
},
{
"relative_path": "styles/title-window.md",
"size_in_bytes": 2140
},
{
"relative_path": "styles/torn-paper-pages.md",
"size_in_bytes": 2268
},
{
"relative_path": "styles/travel-welcome-recap.md",
"size_in_bytes": 8257
},
{
"relative_path": "styles/typed-message.md",
"size_in_bytes": 2173
},
{
"relative_path": "styles/vcr-home-video.md",
"size_in_bytes": 1862
},
{
"relative_path": "styles/velocity-ramp.md",
"size_in_bytes": 1907
},
{
"relative_path": "styles/viewfinder-rec.md",
"size_in_bytes": 2175
},
{
"relative_path": "styles/whip-pan.md",
"size_in_bytes": 2325
},
{
"relative_path": "styles/whiteout-dissolve.md",
"size_in_bytes": 2256
},
{
"relative_path": "styles/widescreen-mono.md",
"size_in_bytes": 1668
},
{
"relative_path": "styles/widescreen-vlog.md",
"size_in_bytes": 2538
},
{
"relative_path": "styles/word-cards.md",
"size_in_bytes": 2418
},
{
"relative_path": "styles/word-countdown.md",
"size_in_bytes": 2563
},
{
"relative_path": "styles/word-per-shot.md",
"size_in_bytes": 1869
},
{
"relative_path": "styles/year-counter.md",
"size_in_bytes": 2008
},
{
"relative_path": "styles/year-flip.md",
"size_in_bytes": 2459
},
{
"relative_path": "styles/zoom-through-travel.md",
"size_in_bytes": 2085
}
],
"name": "reel-structure",
"skill_md_contents": "---\nname: reel-structure\ndescription: Read a reference reel's structure and format, never its content - its beats, shots, caption pattern, pace and bed into a structure sheet (or parse a written breakdown for free), its layout, captions, hook and end card into the record's format, with what the footage can match; fit the user's script to the beats, and report each beat as matched, changed, dropped or added, with the content rules checked. Use when a short should be built the way a reference reel is built or looks, including the user's own channel.\nmetadata:\n source: channel team breakdowns and tools/reuse_guard.py, commit 3f064f0\n local-scripts: pick_style.py, style_check.py, build_index.py\n---\n\n# Reel structure\n\nA reference reel lends its **structure**: where its beats fall, how its shots and captions\nwork, how fast it talks, what sits under the voice. Its **content** stays its own. Nothing the\nviewer can see or hear of the reference reaches the user's video: no words, no frames, no audio\nor music. Only its pattern is copied.\n\nThe method has five steps: read the structure into a sheet, check the sheet with the user, read\nthe format and what the footage can match of it, map the user's script onto the beats, and report\nwhat matched and what changed. A job with no script (cutting footage to a reference) stops after\nthe format.\n\n**The user's own channel is different**: its format is the spec to reproduce, and its logo, end\ncard, fonts and copy are theirs (own-brand mode, `references/format.md`).\n\n## 1. Read the structure\n\n**A written breakdown is free.** When the user brings a beat-by-beat breakdown, parse it and skip\nthe read:\n\n```\npython3 scripts/sheet.py parse breakdown.md --out sheet.json\n```\n\n**A style from our library supplies its own breakdown.** When the user brought no reference and the use case\nbuilds in a style, read `references/style-library.md` (how the one best-fitting style is picked\nfor the footage, how it becomes the sheet and the format with no read and no SPEND, and how it is\nbuilt) and `references/style-index.md` (one line per style); then open only the picked style's\nfile, `styles/<id>.md`, never the whole folder. For a Thanksgiving or Friendsgiving reel, also read\n`references/skin-thanksgiving.md` (the full skin); never on other occasions.\n\n**A reference video is read with the tools, and the read is required**: none of it is optional\nwhen the user sends a reel to follow. Run each required analysis below. Use the tool's billing\ncontract and picsart-video-rules's SPEND rule: quote any charged call, 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).\nFollow each job receipt as picsart-video-rules says.\n\n| Order | Tool | What it gives the sheet |\n|---|---|---|\n| 1 | `picsart_media_probe` | length, frame size, frame rate, and whether there is audio |\n| 1 | `picsart_media_segment_shots` over the whole length | the shots: holds and transitions, each with the step to sample it at |\n| 2 | `picsart_media_video_stills` | at least 8 frames per shot, and every transition at its suggested step, at 480 px wide or more (never 180 px tiles); crop sheets (`crop`) of each frame, border and title, so a frame's shape (wavy, hand-drawn, doodled) is read, not guessed |\n| 3 | `picsart_media_track_motion` | every card, photo and title that moves, measured (below) |\n| 3 | `picsart_media_analyze_audio` | the bed's beat grid, tempo and loudness, when there is music |\n| 3 | `picsart_media_transcribe` | only when someone speaks: the words' timing, for the pace and the reuse check, never to reuse them. Never on a music-only reel |\n| any | `picsart_media_describe_video` with `detail: \"standard\"` | what each shot shows and its on-screen text, in words; optional when the use case says so, and quoted whenever it runs |\n\nThe stills are **for the user to look at only**, never an input to a generation; you read the\nreference from them too.\nThe calls in one row of the order run at the same time.\n\nKeep each result as it came back (as files, where you run commands), then draft the sheet from them. No video is decoded here:\n\n```\npython3 scripts/sheet.py draft --shots shots.json --transcript transcript.json \\\n --describe describe.json --audio audio.json --probe probe.json --out sheet.json\n```\n\nThe draft has one row per shot (a long shot is split at its sentences). A short transition is a\ncut, and a long one is a move inside the shot: check each boundary on the stills. Every field\nthe tools cannot know is `?`. **Name every beat yourself**, from the stills (and the watch when it\nran): join rows that make one beat, and fill picture, on screen, caption and sound.\n\n**Measure the moves; never guess them.** The stills show what moves; the motion tools measure it.\nTrack every move the edit adds with `picsart_media_track_motion`, as the\nmotion-tracking-from-video skill says:\n- a push, punch-in or pan on a shot or photo: the whole frame is the target;\n- a photo, card or title that slides, scales or turns, with `\"mode\": \"similarity\"` (`\"corners\"`\n when it skews or tilts in 3D), from automatic targets or boxes read off the stills;\n- a seam that moves the picture;\n- a sticker or object that leads a reveal (a title wiped in as it passes).\n\nEach window runs from the frame before the move starts to the frame after it settles, at the\nvideo's own frame rate. Track every window; never guess a move to save a call. Targets that\nshare a window go in one call. Then read each move's easing with that skill's `fit_motion.py moves --into sheet.json`:\nit adds the moves to the sheet's `moves`. Set each one's `track` to the result's `resultUrl`.\nWrite what it measured in the beat's Move cell: from and to, how long, the delay, the curve and the\novershoot (for example \"card 1 up 1625→760 px over 0.77 s from 2.10 s, ease out, no overshoot\").\nKeep each result, as files where you run commands, for the build and the check. A camera move filmed\nin the reference's own footage goes in the Shot cell and is not tracked: the user's footage has its\nown. A move the tracker cannot see, such as a wipe or a fade, is read from cropped stills, one per\nframe, as that skill says. Record those observations in the beat's `stillMeasurements`: each\nentry names the `target`, a `channel` of `opacity` or `reveal`, and at least two ordered `frames`\nwith `t` in source seconds, `source` identifying the frame, and the observed `value` from 0 to 1.\nThe values must change and the observations must overlap the beat. For example:\n\n```json\n{\"target\":\"title\",\"channel\":\"reveal\",\"frames\":[\n {\"t\":2.0,\"source\":\"stills/title-060.png\",\"value\":0},\n {\"t\":2.5,\"source\":\"stills/title-075.png\",\"value\":1}\n]}\n```\n\nThe Move cell describes those numbers. A `(stills)` label alone is not evidence; position,\nscale and rotation still require tracking.\n\nEvery moving beat declares `motionRequirements`, listing **every** target and channel observed\nin the reference, independently of the evidence collected. For a card that slides and fades:\n`[{\"target\":\"card1\",\"channel\":\"position\"},{\"target\":\"card1\",\"channel\":\"opacity\"}]`.\nThe gate checks each requirement separately: matching tracked moves for position, scale and\nrotation; matching frame measurements for opacity and reveal. Evidence for one target or channel\ncannot cover another. Write the Move cell from this complete list, never use prose to opt out.\n\nA sheet from a reference video passes the measured check before anything is mapped onto it:\n\n```\npython3 scripts/sheet.py validate sheet.json --measured\n```\n\nIt refuses a moving beat without overlapping tracked or supported still measurements, a Move\ncell with words alone, and a Move left `?`.\n\n## 2. The sheet\n\nOne row per beat, or several rows for a long one, in this table:\n\n```\n| Time (s) | Beat | What happens (picture) | Voice | On screen | Shot | Move | Caption | Sound |\n```\n\n- **Beat** names its role: hook, stake, twist, joke run, feeling, reveal, turn, payoff, CTA,\n and the retention-hooks skill's intensifier and rehook. Join two with `+` (\"Payoff + CTA\").\n A reference with its own beat (\"Steps\") keeps that name. Consecutive rows with the same name\n (reveal, reveal (soft), reveal) stay rows in the sheet and are **one beat** to the mapping\n and the report, from the first row's start to the last row's end.\n- **`soft`** in the Beat cell marks a beat that starts mid-shot with no line. Its edges are\n checked within 1 s; every other beat's within 0.5 s.\n- **Voice** is the reference's words, kept only so the reuse check can compare with them, and the\n pace in words a second comes from it. **On screen** is checked for pattern only. **Caption**\n is the caption style and timing (\"top, whole reel\"; \"word by word, centre\"). **Sound** is voice\n only, bed, or effects.\n- **`?` is unknown**, never a value and never an error: a `?` time, a `?` cell, or `?` with a\n note. Never guess one. The map step needs every beat timed and named, and says which are not.\n- A header above the table, as `- Key: value` lines: Format (talking head, POV skit, screen\n tutorial, list, reaction), Length, Cut rate, Caption style, Layout, Bed, Loudness and Source.\n **Layout** names the mode and who sits where: `split-v (top host, bottom guest)`.\n- Two more columns after Sound when the reference has a format to keep: **Frame** (the beat's\n layout, or who fills it: `split-v`, `full: guest`) and **Caption position** (`seam`, `top`,\n `centre`, `lower third`). Length,\n cut rate and loudness keep their number and the line as written (`- Cut rate: ~19 cuts/min\n (21 picture changes…)`). A file with several sheets parses with `parse --all`.\n\nA short breakdown (`| Time | Beat | What happens |`) parses too: its quoted lines become Voice,\nor On screen when the words before them name a caption or a title.\n\nCheck the sheet, and write it as Markdown for the user:\n\n```\npython3 scripts/sheet.py validate sheet.json\npython3 scripts/sheet.py markdown sheet.json --out sheet.md\n```\n\nShow the user the sheet with the stills, and fix what they correct. Then 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) whether the sheet\nis the structure to copy, before anything is mapped onto it.\n\n## 3. The format, and what the footage can match\n\nRead how the reference looks into the record's `format`, as `references/format.md` says: the\nlayout and who sits where, the emphasis, the captions' style and **position**, the hook, the end\ncard and, for the user's own channel, the brand files. Draft it from the sheet, then fill it from\nthe stills:\n\n```\npython3 scripts/ref_format.py from-sheet sheet.json --source own-brand --out format.json\npython3 scripts/ref_format.py check format.json\n```\n\nThen answer each element against the user's footage: reproduced, approximated (say how) or\nimpossible. For a reference video, an element that moves (a text animation, a card's move, a frame\nthat turns) says \"measured\" with its moves in its answer, never a look alone. Anything not reproduced: 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 a rendered mock (one free frame of their\nfootage in the format) beside the reference still, and keep the answer in the block.\n`ref_format.py feasibility format.json` refuses while an element is open. The reference stage is\ndone only with a sheet that passes `sheet.py validate` (with `--measured` for a reference video)\nand no open feasibility row.\n\n## 4. Map the script\n\nThe user's script is a table with a Time column, and a Beat column where the writer said which\nreference beat a row copies. Fit it to the sheet:\n\n```\npython3 scripts/map_structure.py sheet.json script.md --spans allowed-spans.json --out mapping.json\n```\n\n- The first row opens on the reference's hook.\n- A row named for a beat takes the next beat of that name. A time range on the reference's\n clock in its Beat cell, with the sheet's id (\"F1 36–54 s\"), carries it over the later beats\n that range covers. Beats never run backwards.\n- An unnamed row between two rows of one beat joins it. Any other unnamed row is **added**: it is\n the user's own, and it is kept. When no row is named, each takes the beat its middle falls in.\n- Each beat gets the reference's share of the length. Rows scale by at most 15 %, and a beat\n within 15 % of its share matches; otherwise it is **changed**, with the reason.\n- **The allowed spans are placed first and never stretched**: a row over the user's own screen\n clip keeps its length.\n- A beat no row takes is **dropped**, and the report says so. **No row is ever dropped.**\n\n## 5. Report\n\n```\npython3 scripts/structure_report.py sheet.json mapping.json --transcript transcript.json \\\n --media media.json\n```\n\nAdd `--own-brand` for the user's own channel, with its logo, end card and fonts listed under\n`brand` in the media list: they and its on-screen copy are reported \"own brand, allowed\".\n\nThe report has one line per reference beat (its time, the user's rows, matched / changed /\ndropped, the reason), then one per added row. Below it, the content rules, each passed, failed\nor not checked:\n\n| Rule | Checks |\n|---|---|\n| words | no run of 4 or more of the reference's spoken words in a voice line (`scripts/reuse_guard.py`) |\n| captions | the on-screen words are the user's own, short whole-caption copies included; only the caption pattern is copied |\n| pictures | no still or clip of the reference is a generation input |\n| sound | no audio or music of the reference is in the cut |\n\nThe media list (`media.json` where you run commands, else kept in the record) lists the reference's URL and every still or clip made from it, the URLs given to\neach generation, and the audio in the cut; an empty list says none was used, and a missing list is\nnot checked. Without it, pictures and sound are not checked, and the report says so; never call\nthem passed. Likewise words and captions are not checked while the reference's Voice or On screen\ncells are `?` and no `--transcript` covers the speech.\n\n**A failed rule is fixed, not waived.** Rewrite the line, or change the input. A format label\nnobody owns (\"get ready with me\", \"GRWM\", \"POV\", \"storytime\") passes on screen, and the report\nnames it \"genre phrase, allowed\"; show that line to the user. Any other phrase shared with the\nreference stays only when the user chooses it: 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) whether to keep it, and pass it as\n`--allow \"<phrase>\"`. To check a whole script file\non its own, `python3 scripts/reuse_guard.py transcript.json script.md` lists every shared run\nwith its line.\n\nShow the user the report beside the sheet. When beats are changed or dropped, 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) whether to\nrework the script toward the reference or keep the changes, one beat at a time.\n"
}SHA-256 of public snapshot: c7ac1eeed5d2e90f3a7df93ac30c8062d3976bb1e02eafd45e350ff26e6fc4ac