← PicsartCONTENT HISTORY
WHAT CHANGED
changed
changed
Update to Picsart
Snapshot Nov 3, 2026 · 18:14 UTC · version 2.3.0
Collection source: downloaded plugin package.
Instructions updated for footage-reframing
Full description — Now says: when a landscape video is reposted as a vertical one,
Observed in instructions or declared skills. Runtime behavior has not been tested.
Save Picsart and check future changes in Following.
Up to 3 plugins free · no card required.
All fields and original values.
Full description
Before
Oct 27, 2026 · 06:06 UTC
After
Nov 3, 2026 · 18:14 UTC
when a landscape video is reposted as a vertical one,
Skill instructions
Before
Oct 27, 2026 · 06:06 UTC
After
Nov 3, 2026 · 18:14 UTC
when a landscape video is reposted as a vertical one,
Compare saved observations
Download comparison JSONSKILL.md text changes
− removed · + added
--- before +++ after @@ -1,6 +1,6 @@ --- name: footage-reframing -description: Put the user's own footage in a frame of another shape - landscape to a vertical reel, say - with the camera following the person, measured once per source, and cut it into a reel of clips back to back with scripts/reel_cut.py, so any re-cut is free. Covers which clips follow the subject and which show the whole frame, photos held as beats, a camera that swings between two people, and hard cuts. Use when a reel or short is cut from the user's own videos and photos, or when a vertical crop loses the subject. +description: Put the user's own footage in a frame of another shape - landscape to a vertical reel, say - with the camera following the person, measured once per source, and cut it into a reel of clips back to back with scripts/reel_cut.py, so any re-cut is free. Covers which clips follow the subject and which show the whole frame, photos held as beats, a camera that swings between two people, and hard cuts. Use when a reel or short is cut from the user's own videos and photos, when a landscape video is reposted as a vertical one, or when a vertical crop loses the subject. --- # Reframe
Full technical diff · 2 changed fields
changed /description
BEFORE
"Put the user's own footage in a frame of another shape - landscape to a vertical reel, say - with the camera following the person, measured once per source, and cut it into a reel of clips back to back with scripts/reel_cut.py, so any re-cut is free. Covers which clips follow the subject and which show the whole frame, photos held as beats, a camera that swings between two people, and hard cuts. Use when a reel or short is cut from the user's own videos and photos, or when a vertical crop loses the subject."
AFTER
"Put the user's own footage in a frame of another shape - landscape to a vertical reel, say - with the camera following the person, measured once per source, and cut it into a reel of clips back to back with scripts/reel_cut.py, so any re-cut is free. Covers which clips follow the subject and which show the whole frame, photos held as beats, a camera that swings between two people, and hard cuts. Use when a reel or short is cut from the user's own videos and photos, when a landscape video is reposted as a vertical one, or when a vertical crop loses the subject."
changed /skill_md_contents
BEFORE
"---\nname: footage-reframing\ndescription: Put the user's own footage in a frame of another shape - landscape to a vertical reel, say - with the camera following the person, measured once per source, and cut it into a reel of clips back to back with scripts/reel_cut.py, so any re-cut is free. Covers which clips follow the subject and which show the whole frame, photos held as beats, a camera that swings between two people, and hard cuts. Use when a reel or short is cut from the user's own videos and photos, or when a vertical crop loses the subject.\n---\n\n# Reframe\n\nA vertical crop of a landscape shot keeps about a third of its width. Centred, that third is often\na wall beside the speaker. So the subject's position is measured, never guessed, and the clips are\ncut from that measurement by a script.\n\n## Measure each source once\n\n1. **Which sources need it.** A video whose shape differs from the reel's, with a person or\n another subject in it. A source already the reel's shape, and one with nothing to follow (a\n title card, a full-frame graphic, a wide shot with no subject), needs no reframe: its clips are\n `full`.\n2. **Reframe it.** `picsart_media_reframe_video` with the source's Picsart-hosted `url` and the\n reel's `aspect_ratio`. It replies with a job receipt, followed as picsart-video-rules says. It\n takes minutes, so post a line first, and\n start it as soon as the source and the reel's shape are known. It does not need the cut.\n3. **Save the result verbatim**, the whole reply, as `reframe-<source id>.json`. Never pass\n `scene` and `layer_id` for this: that mode refuses a trim, and every call measures again.\n\n**One reframe per source and shape, for the whole session.** The result covers the source's whole\nlength, so every clip, every re-cut and every new running order is windowed from it by the script.\nMeasuring again for a new cut repeats minutes of work and changes nothing. Its description says\nwhether it charges credits. If it does, it is a SPEND (picsart-video-rules): quote every source's reframe in\none go.\n\nIf it fails, retry it once: it is flaky, and a later try often succeeds. If it fails again, stop\nand say the reframing is unavailable right now, with what is ready. Never estimate the subject's\nposition from a description of the video, and never frame a talking person `full` as a stand-in.\n\n## Cut the reel\n\n`scripts/reel_cut.py` builds the scene. Write its input to a file and run\n`python3 scripts/reel_cut.py reel.json`:\n\n```json\n{\n \"width\": 1080, \"height\": 1920,\n \"sources\": [\n {\"id\": \"talk\", \"url\": \"<the url you reframed>\", \"reframe\": \"reframe-talk.json\"},\n {\"id\": \"broll\", \"url\": \"<url>\", \"width\": 1920, \"height\": 1080, \"duration\": 31.5},\n {\"id\": \"photo\", \"type\": \"image\", \"url\": \"<url>\", \"width\": 1600, \"height\": 1200}\n ],\n \"clips\": [\n {\"source\": \"talk\", \"in\": 12.0, \"out\": 18.5},\n {\"source\": \"broll\", \"in\": 3.0, \"out\": 6.0, \"frame\": \"full\", \"dim\": 0.3},\n {\"source\": \"photo\", \"duration\": 2.0},\n {\"source\": \"talk\", \"in\": 40.2, \"out\": 44.0}\n ]\n}\n```\n\n- `width` and `height` are the reel's. The sizes and lengths of sources with no reframe come from\n `picsart_media_probe`, never from memory.\n- Clips play in list order, each `in` to `out` in **its own source's** seconds. A range from one\n source applied to another lands nowhere.\n- A reframed source's clips default to `crop`: the camera follows the subject. Others default to\n `full`: the whole frame over a blurred copy of itself (`dim` darkens the copy), or over black\n with `\"background\": \"black\"`.\n- A photo has no time of its own: its clip gives a `duration`, long enough to read and no longer.\n `full` shows all of it; `\"frame\": \"crop\"` fills the frame from its centre.\n- With no `transition`, every seam is a hard cut. Keep it that way for speech: a crossfade blurs\n the clean sentence edge the cut was placed on. Add one only when the user asks for it.\n\nIt prints one JSON line, `{scene, duration, clips, notes}`. Pass `scene` on as it is: it validates\nas it stands, and every clip is a plain media clip the scene editor opens. If it exits 1, its one\nline on stderr says what to change.\n\n**A re-cut is a new run.** To trim a clip, swap one, or change the order, edit the clip list and\nrun the script again. The reframe result stays as it is.\n\n## Crop or full\n\n**A clip with a person talking is `crop`.** Letterboxing a face into a third of a vertical frame is\nthe defect this skill exists to prevent, not a safe choice. `full` is for a clip with nothing to\nfollow. When a crop looks wrong, fix the crop (below), never switch the clip to `full`.\n\n## When the camera swings\n\nThe reframe follows *a* subject in each frame, not the one speaking. On a two-person shot it can\nswing from one to the other, and the crop then lands between them. The script measures that:\n`notes` names each clip whose camera crosses more of the source than one person moves, with the\ncentre to hold:\n\n```\nclips[1]: the camera crosses 42% of the source, so it may be following two people; to hold one, cut it again with \"hold\": 0.773\n```\n\nAdd that `hold` to the clip and run it again: the clip then holds one still window, as large as\nits own crop was. The transcript says who is speaking in that clip. If the hold sits on the\nlistener, give `hold` that person's side instead, from 0 (the left edge) to 1 (the right). Or\nchoose a stretch of the speech where only the speaker is in the frame.\n\n## Check\n\nBefore the scene is reviewed, run `picsart_scene_validate` on it, then\n`picsart_scene_contact_sheet` at each seam and in the middle of each clip. Look for: a face in\nevery `crop` frame, not cut by the frame's edge; and no clip that opens on a wall or a hand. Fix\nwhat fails in one new run, as the quality-review skill says.\n"AFTER
"---\nname: footage-reframing\ndescription: Put the user's own footage in a frame of another shape - landscape to a vertical reel, say - with the camera following the person, measured once per source, and cut it into a reel of clips back to back with scripts/reel_cut.py, so any re-cut is free. Covers which clips follow the subject and which show the whole frame, photos held as beats, a camera that swings between two people, and hard cuts. Use when a reel or short is cut from the user's own videos and photos, when a landscape video is reposted as a vertical one, or when a vertical crop loses the subject.\n---\n\n# Reframe\n\nA vertical crop of a landscape shot keeps about a third of its width. Centred, that third is often\na wall beside the speaker. So the subject's position is measured, never guessed, and the clips are\ncut from that measurement by a script.\n\n## Measure each source once\n\n1. **Which sources need it.** A video whose shape differs from the reel's, with a person or\n another subject in it. A source already the reel's shape, and one with nothing to follow (a\n title card, a full-frame graphic, a wide shot with no subject), needs no reframe: its clips are\n `full`.\n2. **Reframe it.** `picsart_media_reframe_video` with the source's Picsart-hosted `url` and the\n reel's `aspect_ratio`. It replies with a job receipt, followed as picsart-video-rules says. It\n takes minutes, so post a line first, and\n start it as soon as the source and the reel's shape are known. It does not need the cut.\n3. **Save the result verbatim**, the whole reply, as `reframe-<source id>.json`. Never pass\n `scene` and `layer_id` for this: that mode refuses a trim, and every call measures again.\n\n**One reframe per source and shape, for the whole session.** The result covers the source's whole\nlength, so every clip, every re-cut and every new running order is windowed from it by the script.\nMeasuring again for a new cut repeats minutes of work and changes nothing. Its description says\nwhether it charges credits. If it does, it is a SPEND (picsart-video-rules): quote every source's reframe in\none go.\n\nIf it fails, retry it once: it is flaky, and a later try often succeeds. If it fails again, stop\nand say the reframing is unavailable right now, with what is ready. Never estimate the subject's\nposition from a description of the video, and never frame a talking person `full` as a stand-in.\n\n## Cut the reel\n\n`scripts/reel_cut.py` builds the scene. Write its input to a file and run\n`python3 scripts/reel_cut.py reel.json`:\n\n```json\n{\n \"width\": 1080, \"height\": 1920,\n \"sources\": [\n {\"id\": \"talk\", \"url\": \"<the url you reframed>\", \"reframe\": \"reframe-talk.json\"},\n {\"id\": \"broll\", \"url\": \"<url>\", \"width\": 1920, \"height\": 1080, \"duration\": 31.5},\n {\"id\": \"photo\", \"type\": \"image\", \"url\": \"<url>\", \"width\": 1600, \"height\": 1200}\n ],\n \"clips\": [\n {\"source\": \"talk\", \"in\": 12.0, \"out\": 18.5},\n {\"source\": \"broll\", \"in\": 3.0, \"out\": 6.0, \"frame\": \"full\", \"dim\": 0.3},\n {\"source\": \"photo\", \"duration\": 2.0},\n {\"source\": \"talk\", \"in\": 40.2, \"out\": 44.0}\n ]\n}\n```\n\n- `width` and `height` are the reel's. The sizes and lengths of sources with no reframe come from\n `picsart_media_probe`, never from memory.\n- Clips play in list order, each `in` to `out` in **its own source's** seconds. A range from one\n source applied to another lands nowhere.\n- A reframed source's clips default to `crop`: the camera follows the subject. Others default to\n `full`: the whole frame over a blurred copy of itself (`dim` darkens the copy), or over black\n with `\"background\": \"black\"`.\n- A photo has no time of its own: its clip gives a `duration`, long enough to read and no longer.\n `full` shows all of it; `\"frame\": \"crop\"` fills the frame from its centre.\n- With no `transition`, every seam is a hard cut. Keep it that way for speech: a crossfade blurs\n the clean sentence edge the cut was placed on. Add one only when the user asks for it.\n\nIt prints one JSON line, `{scene, duration, clips, notes}`. Pass `scene` on as it is: it validates\nas it stands, and every clip is a plain media clip the scene editor opens. If it exits 1, its one\nline on stderr says what to change.\n\n**A re-cut is a new run.** To trim a clip, swap one, or change the order, edit the clip list and\nrun the script again. The reframe result stays as it is.\n\n## Crop or full\n\n**A clip with a person talking is `crop`.** Letterboxing a face into a third of a vertical frame is\nthe defect this skill exists to prevent, not a safe choice. `full` is for a clip with nothing to\nfollow. When a crop looks wrong, fix the crop (below), never switch the clip to `full`.\n\n## When the camera swings\n\nThe reframe follows *a* subject in each frame, not the one speaking. On a two-person shot it can\nswing from one to the other, and the crop then lands between them. The script measures that:\n`notes` names each clip whose camera crosses more of the source than one person moves, with the\ncentre to hold:\n\n```\nclips[1]: the camera crosses 42% of the source, so it may be following two people; to hold one, cut it again with \"hold\": 0.773\n```\n\nAdd that `hold` to the clip and run it again: the clip then holds one still window, as large as\nits own crop was. The transcript says who is speaking in that clip. If the hold sits on the\nlistener, give `hold` that person's side instead, from 0 (the left edge) to 1 (the right). Or\nchoose a stretch of the speech where only the speaker is in the frame.\n\n## Check\n\nBefore the scene is reviewed, run `picsart_scene_validate` on it, then\n`picsart_scene_contact_sheet` at each seam and in the middle of each clip. Look for: a face in\nevery `crop` frame, not cut by the frame's edge; and no clip that opens on a wall or a hand. Fix\nwhat fails in one new run, as the quality-review skill says.\n"Full snapshot data
{
"description": "Put the user's own footage in a frame of another shape - landscape to a vertical reel, say - with the camera following the person, measured once per source, and cut it into a reel of clips back to back with scripts/reel_cut.py, so any re-cut is free. Covers which clips follow the subject and which show the whole frame, photos held as beats, a camera that swings between two people, and hard cuts. Use when a reel or short is cut from the user's own videos and photos, when a landscape video is reposted as a vertical one, or when a vertical crop loses the subject.",
"included_files": [
{
"relative_path": "scripts/reel_cut.py",
"size_in_bytes": 21516
}
],
"name": "footage-reframing",
"skill_md_contents": "---\nname: footage-reframing\ndescription: Put the user's own footage in a frame of another shape - landscape to a vertical reel, say - with the camera following the person, measured once per source, and cut it into a reel of clips back to back with scripts/reel_cut.py, so any re-cut is free. Covers which clips follow the subject and which show the whole frame, photos held as beats, a camera that swings between two people, and hard cuts. Use when a reel or short is cut from the user's own videos and photos, when a landscape video is reposted as a vertical one, or when a vertical crop loses the subject.\n---\n\n# Reframe\n\nA vertical crop of a landscape shot keeps about a third of its width. Centred, that third is often\na wall beside the speaker. So the subject's position is measured, never guessed, and the clips are\ncut from that measurement by a script.\n\n## Measure each source once\n\n1. **Which sources need it.** A video whose shape differs from the reel's, with a person or\n another subject in it. A source already the reel's shape, and one with nothing to follow (a\n title card, a full-frame graphic, a wide shot with no subject), needs no reframe: its clips are\n `full`.\n2. **Reframe it.** `picsart_media_reframe_video` with the source's Picsart-hosted `url` and the\n reel's `aspect_ratio`. It replies with a job receipt, followed as picsart-video-rules says. It\n takes minutes, so post a line first, and\n start it as soon as the source and the reel's shape are known. It does not need the cut.\n3. **Save the result verbatim**, the whole reply, as `reframe-<source id>.json`. Never pass\n `scene` and `layer_id` for this: that mode refuses a trim, and every call measures again.\n\n**One reframe per source and shape, for the whole session.** The result covers the source's whole\nlength, so every clip, every re-cut and every new running order is windowed from it by the script.\nMeasuring again for a new cut repeats minutes of work and changes nothing. Its description says\nwhether it charges credits. If it does, it is a SPEND (picsart-video-rules): quote every source's reframe in\none go.\n\nIf it fails, retry it once: it is flaky, and a later try often succeeds. If it fails again, stop\nand say the reframing is unavailable right now, with what is ready. Never estimate the subject's\nposition from a description of the video, and never frame a talking person `full` as a stand-in.\n\n## Cut the reel\n\n`scripts/reel_cut.py` builds the scene. Write its input to a file and run\n`python3 scripts/reel_cut.py reel.json`:\n\n```json\n{\n \"width\": 1080, \"height\": 1920,\n \"sources\": [\n {\"id\": \"talk\", \"url\": \"<the url you reframed>\", \"reframe\": \"reframe-talk.json\"},\n {\"id\": \"broll\", \"url\": \"<url>\", \"width\": 1920, \"height\": 1080, \"duration\": 31.5},\n {\"id\": \"photo\", \"type\": \"image\", \"url\": \"<url>\", \"width\": 1600, \"height\": 1200}\n ],\n \"clips\": [\n {\"source\": \"talk\", \"in\": 12.0, \"out\": 18.5},\n {\"source\": \"broll\", \"in\": 3.0, \"out\": 6.0, \"frame\": \"full\", \"dim\": 0.3},\n {\"source\": \"photo\", \"duration\": 2.0},\n {\"source\": \"talk\", \"in\": 40.2, \"out\": 44.0}\n ]\n}\n```\n\n- `width` and `height` are the reel's. The sizes and lengths of sources with no reframe come from\n `picsart_media_probe`, never from memory.\n- Clips play in list order, each `in` to `out` in **its own source's** seconds. A range from one\n source applied to another lands nowhere.\n- A reframed source's clips default to `crop`: the camera follows the subject. Others default to\n `full`: the whole frame over a blurred copy of itself (`dim` darkens the copy), or over black\n with `\"background\": \"black\"`.\n- A photo has no time of its own: its clip gives a `duration`, long enough to read and no longer.\n `full` shows all of it; `\"frame\": \"crop\"` fills the frame from its centre.\n- With no `transition`, every seam is a hard cut. Keep it that way for speech: a crossfade blurs\n the clean sentence edge the cut was placed on. Add one only when the user asks for it.\n\nIt prints one JSON line, `{scene, duration, clips, notes}`. Pass `scene` on as it is: it validates\nas it stands, and every clip is a plain media clip the scene editor opens. If it exits 1, its one\nline on stderr says what to change.\n\n**A re-cut is a new run.** To trim a clip, swap one, or change the order, edit the clip list and\nrun the script again. The reframe result stays as it is.\n\n## Crop or full\n\n**A clip with a person talking is `crop`.** Letterboxing a face into a third of a vertical frame is\nthe defect this skill exists to prevent, not a safe choice. `full` is for a clip with nothing to\nfollow. When a crop looks wrong, fix the crop (below), never switch the clip to `full`.\n\n## When the camera swings\n\nThe reframe follows *a* subject in each frame, not the one speaking. On a two-person shot it can\nswing from one to the other, and the crop then lands between them. The script measures that:\n`notes` names each clip whose camera crosses more of the source than one person moves, with the\ncentre to hold:\n\n```\nclips[1]: the camera crosses 42% of the source, so it may be following two people; to hold one, cut it again with \"hold\": 0.773\n```\n\nAdd that `hold` to the clip and run it again: the clip then holds one still window, as large as\nits own crop was. The transcript says who is speaking in that clip. If the hold sits on the\nlistener, give `hold` that person's side instead, from 0 (the left edge) to 1 (the right). Or\nchoose a stretch of the speech where only the speaker is in the frame.\n\n## Check\n\nBefore the scene is reviewed, run `picsart_scene_validate` on it, then\n`picsart_scene_contact_sheet` at each seam and in the middle of each clip. Look for: a face in\nevery `crop` frame, not cut by the frame's edge; and no clip that opens on a wall or a hand. Fix\nwhat fails in one new run, as the quality-review skill says.\n"
}SHA-256 of public snapshot: bd1b5a1cf92a123280e69cf35e05eed8e46ad34bcaedd905d3f89309d0298438