{
 "schema_version": 1,
 "generated": "2026-10-20",
 "id": "tugrawork-creator-saas-motion-kit--break-down-reference-film",
 "repo": "tugrawork-creator/saas-motion-kit",
 "repo_url": "https://github.com/tugrawork-creator/saas-motion-kit",
 "repo_slug": "tugrawork-creator-saas-motion-kit",
 "title": "Break a reference film into shots and rhythm notes",
 "page_title": "How to break a reference film into shots and rhythm notes with Saas Motion Kit",
 "summary": "Turn a video you admire into a shot list, rhythm stats and a contact sheet to learn its grammar.",
 "who": "A creative lead who wants to learn the pacing and cut structure of a launch film they admire before writing their own storyboard.",
 "problem": "Watching a reference over and over does not show how many cuts it has, how long shots run, or how fast the opening moves.",
 "outcome": "Shot breakdown, cuts per 10 seconds, shot lengths, a contact sheet and a draft ledger, filed under the git-ignored .references/ folder with a credit header.",
 "steps": [
  "Save the reference video file locally, with the creator's permission or under the rules of your use.",
  "Run `python tools/breakdown.py launch.mp4 --id 01 --creator \"@handle\" --title \"v2 launch\" --url https://x.com/handle/status/…`, replacing the file, handle, title and link with your own.",
  "Open the contact sheet and the draft ledger in .references/.",
  "Add the reference to REFERENCES.md and credit it in any shot notes that borrow from it with ref:01.",
  "Borrow only grammar such as rhythm, structure, transition types and camera ideas, not assets."
 ],
 "agent_prompt": "Use the saas-motion-kit repo. Run `python tools/breakdown.py <video file> --id 01 --creator \"<creator>\" --title \"<title>\" --url <link>` on the reference video. Expected output: a shot breakdown, rhythm stats, a contact sheet and a draft ledger in .references/. Verify that the credit header names the creator and link before any output is reused.",
 "agents": [
  "any"
 ],
 "difficulty": "Intermediate",
 "time": "30 minutes",
 "basis": "readme",
 "caveat": "The breakdown only detects hard cuts and grammar, so it does not capture the reference's sound, copy or assets, and those must not be reused.",
 "category": "Content",
 "tags": [
  "Content"
 ],
 "lang": "python",
 "requirements": [
  "Python to run the tools in tools/",
  "A copy of the repo, or a new repo created from the template with Use this template",
  "A storyboard file written from templates/STORYBOARD.md",
  "HyperFrames, if you build the film itself (the README links to it but does not describe the install steps)",
  "Claude Code, if you want the /saas-motion-video skill to run the process with you"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": false,
 "score": 0.8,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/tugrawork-creator-saas-motion-kit/break-down-reference-film/",
 "md": "https://dedupedai.com/use-cases/tugrawork-creator-saas-motion-kit/break-down-reference-film/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/tugrawork-creator-saas-motion-kit--break-down-reference-film.json",
 "api_version": "v1"
}