Text to motion graphics for Claude Code and Codex: write a brief, get a checked MP4. 30 art forms from claymation and paper cut-out to anime and pixel art, 2D explainers, Shorts, 3D products. Installs brief2motion for websites. MIT.
Python 3dagent-skillsai-videoanimationblenderclaude-codeclaude-skillsclaymationcodexexplainer-videoffmpeggsaphyperframeskinetic-typographymanimmotion-graphicstext-to-videothreejsvideo-generationyoutube-shorts
feat: 0.2.0, Claude Code and Codex plugins, logo, stronger README
Varun Pratap Bhardwajfda69b51ac0e
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.jsonnew file mode 100644index 0000000..8e81772--- /dev/null+++ b/.claude-plugin/marketplace.json@@ -0,0 +1,24 @@+{+ "name": "brief2mp4",+ "owner": {+ "name": "Varun Pratap Bhardwaj",+ "url": "https://github.com/qualixar"+ },+ "metadata": {+ "description": "brief2mp4: write a brief, get a checked MP4. One skill for Claude Code and Codex."+ },+ "plugins": [+ {+ "name": "brief2mp4",+ "source": "./plugin",+ "description": "Turn a written brief into a finished, checked MP4 motion graphic with HyperFrames, Three.js, Blender and ffmpeg.",+ "version": "0.2.0",+ "author": { "name": "Varun Pratap Bhardwaj" },+ "homepage": "https://github.com/qualixar/brief2mp4",+ "repository": "https://github.com/qualixar/brief2mp4",+ "license": "MIT",+ "keywords": ["video", "motion-graphics", "hyperframes", "threejs", "blender", "ffmpeg", "skill"],+ "category": "productivity"+ }+ ]+}diff --git a/README.md b/README.mdindex 07ff846..4688f0b 100644--- a/README.md+++ b/README.md@@ -1,39 +1,104 @@-# brief2mp4+<p align="center">+ <img src="assets/banner.png" alt="brief2mp4: write a brief, get a checked MP4" width="100%">+</p>-A free skill that teaches Claude Code and Codex to turn a written brief into a finished, checked MP4: kinetic type, 3D scenes, product shots. MIT licensed. No account, no paywall.+<p align="center">+ <a href="LICENSE"><img alt="MIT licence" src="https://img.shields.io/badge/licence-MIT-16130F"></a>+ <img alt="Claude Code plugin" src="https://img.shields.io/badge/Claude%20Code-plugin-FF5A1F">+ <img alt="Codex plugin" src="https://img.shields.io/badge/Codex-plugin-FF5A1F">+ <img alt="Version 0.2.0" src="https://img.shields.io/badge/version-0.2.0-16130F">+</p>++**brief2mp4 is a free skill for Claude Code and Codex. You paste a written video brief; the agent builds the video, renders it, measures the file, checks every line of your brief against real frames, fixes what fails, and hands you `final.mp4` with a report.**++It covers kinetic type and 2D motion (HyperFrames), stylised 3D (Three.js) and realistic product shots (Blender), and finishes every file with ffmpeg. Everything runs on your own machine.++## What it made from one brief++This is example brief 01, pasted as written. The agent wrote a spec, built it in HyperFrames, rendered, finished the file and checked it, with no edits by hand.++<p align="center">+ <img src="assets/demo-brief01.gif" alt="Kinetic type film: Ideas are cheap. Finished is rare. Finish something today." width="800">+</p>++The file it delivered measures 12.000 s, 1920x1080, 30 fps, H.264 with AAC 48 kHz stereo, and the delivery check passed. Its [report](examples/01-kinetic-type/SAMPLE-REPORT.md) lists each requirement of the brief with the evidence for it: which still shows which line, the measured headline height (126 px against a 120 px minimum), the text bounds against the safe margins, the loudness at each sound accent.++## Watch the video++The video that goes with this repo is on YouTube: [youtu.be/l9mEZQon6JM](https://youtu.be/l9mEZQon6JM).++## Install++There are two ways in each app. Pick one per app; installing both ways gives you two copies of the same skill.++### Claude Code++As a plugin, inside Claude Code:++```+/plugin marketplace add qualixar/brief2mp4+/plugin install brief2mp4@brief2mp4+```++On Claude Code 2.1.275 or later this also works in one line: `/plugin install brief2mp4 --marketplace qualixar/brief2mp4`.++### Codex++As a plugin, in a terminal:++```bash+codex plugin marketplace add qualixar/brief2mp4+codex plugin add brief2mp4@brief2mp4+```++The Codex desktop app reads the same settings, so the plugin shows up there too.++### Both apps at once, with the script```bashgit clone https://github.com/qualixar/brief2mp4.git && bash brief2mp4/install.sh```-That installs the skill into `~/.claude/skills/brief2mp4` and `~/.codex/skills/brief2mp4`. Start a new session in either app and ask:+This copies the skill into `~/.claude/skills/brief2mp4` and `~/.codex/skills/brief2mp4` and checks that Node, ffmpeg and Blender are on your machine. Use `--claude` or `--codex` for one app only.-> Use the brief2mp4 skill to make the video in this brief: *(paste one of the briefs below)*+### No terminal++Paste this into Claude Code or Codex and let the agent do it:++> Clone https://github.com/qualixar/brief2mp4 into a temporary folder and run its install.sh.++Whichever way you install, start a new session afterwards so the app loads the skill.++## Use it++Open a folder for the video, start a session and send:++> Use the brief2mp4 skill to make the video in this brief: *(paste your brief)*When it says it is done, send one follow-up:> Check it against the brief.-The skill treats that as an instruction to re-read your original brief line by line, show the evidence for each line, fix what fails, and render again.+The skill reads that as an instruction to go back to your original brief, line by line, show the evidence for each line, fix anything that falls short and render again. In our test of brief 01 this follow-up caught a real miss: the headlines cleared the 120 px minimum by only a few pixels, so it enlarged them and rendered again, and the delivery check still passed.-## What it does+## How it works-The skill gives the agent one working loop and the tools to run it:+The skill gives the agent one loop and the scripts to run it.-1. **Spec.** Before writing code it writes `SPEC.md`: the delivery spec (size, frame rate, exact duration, codecs, loudness), every on-screen word copied exactly, the palette, a beat sheet with times, and a "done when" checklist with one checkable line per requirement.-2. **Build.** It picks the right tool for the brief and starts from a template that already renders.-3. **Self-check.** It measures the file (`check_delivery.sh`), pulls stills at the important moments (`contact_sheet.sh`), looks at them, and marks every checklist line met or not met with evidence.-4. **Fix.** It fixes the worst miss first and re-renders, up to three rounds.-5. **Deliver.** `final.mp4` plus a `REPORT.md` that says what was checked, how, and what is still open.+1. **Spec.** Before any code it writes `SPEC.md`: size, frame rate, exact duration, codecs and loudness; every on-screen word copied exactly; the palette; a beat sheet with times; and a "done when" list with one checkable line per requirement.+2. **Build.** It picks the tool that fits the brief and starts from a template that already renders.+3. **Self-check.** It measures the file with `check_delivery.sh`, pulls stills at the important moments with `contact_sheet.sh`, looks at them, and marks every line of the list met or not met, with evidence.+4. **Fix.** It fixes the worst miss first and renders again, for up to three rounds.+5. **Deliver.** You get `final.mp4` and a `REPORT.md` that says what was checked, how, and what is still open.| The brief asks for | The skill uses ||---|---|-| Type, layouts, UI, charts, 2D motion | [HyperFrames](https://github.com/heygen-com/hyperframes) (HTML + CSS + GSAP to MP4) |-| Stylised 3D, particles, camera moves | [Three.js](https://threejs.org) inside HyperFrames, driven by the timeline so every frame is repeatable |+| Type, layouts, UI, charts, 2D motion | [HyperFrames](https://github.com/heygen-com/hyperframes) (HTML, CSS and GSAP to MP4) |+| Stylised 3D, particles, camera moves | [Three.js](https://threejs.org) inside HyperFrames, driven by the timeline so every frame renders the same way twice || Realistic products, materials, soft light | [Blender](https://www.blender.org), scripted in Python and rendered without opening a window || Sound, joins, exact length, loudness, encoding | [ffmpeg](https://ffmpeg.org) |-## Try it: three example briefs+## Example briefs| Brief | Tool | Length ||---|---|---|@@ -41,51 +106,77 @@ The skill gives the agent one working loop and the tools to run it:| [02 Three.js](examples/02-threejs-orbit/BRIEF.md): a low-poly planet, three moons, "ORBIT" | Three.js | 10 s || [03 Blender](examples/03-blender-product/BRIEF.md): a smart-speaker turntable, "LISTEN." | Blender | 8 s |-Copy a brief, paste it after the request above, and let it run. Then write your own: say how long, what size, which colours, the exact words, and what should happen when. The more of that you write down, the less the agent has to guess.+## Write your own brief++The agent guesses less when the brief says more. A brief that works well has these parts:++```markdown+Length and size: 15 s, 1920x1080, 30 fps.+Look: background #F2EDE4, text #16130F, one accent #FF5A1F. Font: Space Grotesk Bold.+Words on screen, exactly: "First line." / "Second line." / "Last line."+What happens when:+- 0.0 to 4.0 s: the first line types on, one word at a time.+- 4.0 s: a hard cut to the second line.+- 9.0 s: the last line lands and holds still until the end.+Sound: a quiet bed with a low hit at 4.0 s.+Done when: every line is readable, nothing touches the frame edge, headlines are at least 100 px tall.+```++The "done when" lines matter most, because they are what the self-check measures. The free guide at [qualixar.com/learn/guides/brief2mp4-guide](https://qualixar.com/learn/guides/brief2mp4-guide) goes through brief writing, each tool and the checks in more detail.## Requirements-- Claude Code or Codex (desktop app or CLI)-- Node.js 22 or newer and ffmpeg, for every brief-- Blender, only for Blender briefs (tested with 5.2; 4.2 or newer should work)+- Claude Code or Codex, desktop app or command line.+- Node.js 22 or newer and ffmpeg, for every brief.+- Blender, only for Blender briefs (tested with 5.2; 4.2 or newer should work).-The installer checks these and tells you what is missing. HyperFrames runs through `npx`, so there is nothing else to install.+HyperFrames runs through `npx`, so there is nothing else to install. The install script tells you what is missing.-## What is inside+## FAQ-```-skill/brief2mp4/- SKILL.md the loop the agent follows- references/ HyperFrames, Three.js, Blender, ffmpeg notes- scripts/- finish.sh any render -> delivery MP4 (exact length, H.264/AAC, -14 LUFS)- check_delivery.sh PASS/WARN/FAIL against the delivery spec- contact_sheet.sh stills at chosen moments, plus a grid- sound_bed.sh a quiet original placeholder soundtrack- templates/- SPEC.md the spec the agent fills in- threejs/index.html a Three.js scene that renders frame by frame- blender/scene.py a scripted Blender turntable-examples/ three briefs-install.sh install, update or remove-```+**Does it cost anything?** The skill is free and MIT licensed. The agent runs on your own Claude Code or Codex plan, and the rendering happens on your machine.-The scripts also work on their own, for any video:+**Which models has it been tested with?** Claude Code on Sonnet made brief 01 in 98 seconds, start to finish, with the delivery check passing. Stronger models handle harder briefs better, but the loop and the checks are the same for all of them.-```bash-bash ~/.claude/skills/brief2mp4/scripts/check_delivery.sh my-video.mp4 --seconds 30-```+**Does it upload my files anywhere?** No. Rendering, checks and the report all stay in your project folder. The only network traffic is what the tools themselves fetch: HyperFrames and Three.js packages through npm, and any web fonts your brief names.-## Update or remove+**What about music?** `sound_bed.sh` makes a quiet original placeholder so the file is never silent. For a real soundtrack, pass your own licensed track to `finish.sh --audio`.++**Can I use the scripts without an agent?** Yes. They are plain bash and ffmpeg. For example, from a clone of this repo:```bash-cd brief2mp4 && git pull && bash install.sh # update-bash brief2mp4/install.sh --uninstall # remove from both apps-bash brief2mp4/install.sh --claude # only Claude Code (or --codex)+bash plugin/skills/brief2mp4/scripts/check_delivery.sh my-video.mp4 --seconds 30```-The installer only replaces or removes a folder it created itself. If you already had a folder called `brief2mp4` in your skills, it is moved aside with a timestamp, never deleted.+**Does it work on Windows or Linux?** It is tested on macOS. The scripts are bash and ffmpeg, so Linux should work. On Windows, use WSL; that is untested.++**How do I update or remove it?** Claude Code plugin: `claude plugin update brief2mp4@brief2mp4`, or `claude plugin uninstall brief2mp4@brief2mp4`. Codex plugin: `codex plugin marketplace upgrade`, or `codex plugin remove brief2mp4@brief2mp4`. Script install: `git pull` then `bash install.sh` again, or `bash install.sh --uninstall`. The script only replaces or removes a folder it created; if you already had a `brief2mp4` folder in your skills, it is moved aside with a timestamp, never deleted.++## What is inside++```+.claude-plugin/marketplace.json marketplace entry, read by Claude Code and Codex+plugin/+ .claude-plugin/plugin.json Claude Code plugin manifest+ .codex-plugin/plugin.json Codex plugin manifest+ skills/brief2mp4/+ SKILL.md the loop the agent follows+ references/ HyperFrames, Three.js, Blender and ffmpeg notes+ scripts/+ finish.sh any render to a delivery MP4 (exact length, H.264/AAC, -14 LUFS)+ check_delivery.sh PASS, WARN or FAIL against the delivery spec+ contact_sheet.sh stills at chosen moments, plus a grid+ sound_bed.sh a quiet original placeholder soundtrack+ templates/+ SPEC.md the spec the agent fills in+ threejs/index.html a Three.js scene that renders frame by frame+ blender/scene.py a scripted Blender turntable+examples/ three briefs and a sample report+install.sh script install, update or removal for both apps+```## LicenceMIT. Use it, change it, ship videos with it. HyperFrames (Apache-2.0), Three.js (MIT), GSAP, Blender (GPL) and ffmpeg (LGPL/GPL) keep their own licences; this repo does not bundle them.++Made by [Varun Pratap Bhardwaj](https://github.com/qualixar).diff --git a/VERSION b/VERSIONindex 6e8bf73..0ea3a94 100644--- a/VERSION+++ b/VERSION@@ -1 +1 @@-0.1.0+0.2.0diff --git a/assets/banner.png b/assets/banner.pngnew file mode 100644index 0000000..2f5b79eBinary files /dev/null and b/assets/banner.png differdiff --git a/assets/brief01-stills.png b/assets/brief01-stills.pngnew file mode 100644index 0000000..779141dBinary files /dev/null and b/assets/brief01-stills.png differdiff --git a/assets/demo-brief01.gif b/assets/demo-brief01.gifnew file mode 100644index 0000000..1c5e2a7Binary files /dev/null and b/assets/demo-brief01.gif differdiff --git a/assets/logo.svg b/assets/logo.svgnew file mode 100644index 0000000..b2733bb--- /dev/null+++ b/assets/logo.svg@@ -0,0 +1,12 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="512" height="512">+ <title>brief2mp4</title>+ <rect x="16" y="16" width="480" height="480" rx="104" fill="#16130F"/>+ <g transform="translate(-14 -19)">+ <g fill="#F2EDE4">+ <rect x="96" y="150" width="216" height="40" rx="20"/>+ <rect x="96" y="236" width="216" height="40" rx="20"/>+ <rect x="96" y="322" width="250" height="40" rx="20"/>+ </g>+ <path d="M330 270 Q330 252 346 261 L430 316 Q444 326 430 336 L346 391 Q330 400 330 382 Z" fill="#FF5A1F"/>+ </g>+</svg>diff --git a/assets/social-preview.png b/assets/social-preview.pngnew file mode 100644index 0000000..d9c3d07Binary files /dev/null and b/assets/social-preview.png differdiff --git a/examples/01-kinetic-type/SAMPLE-REPORT.md b/examples/01-kinetic-type/SAMPLE-REPORT.mdnew file mode 100644index 0000000..5349460--- /dev/null+++ b/examples/01-kinetic-type/SAMPLE-REPORT.md@@ -0,0 +1,34 @@+# REPORT: Brief 01, "Finish something today"++Deliverable: `brief01-kinetic-type/final.mp4`. It runs 12.0 s at 1920x1080 and 30 fps, encoded as H.264 yuv420p with AAC 48 kHz stereo.++## Done when, checked against the original brief++| Requirement | Status | Evidence |+|---|---|---|+| final.mp4 1920x1080, 30 fps, exactly 12.0 s, H.264 + AAC | met | `check_delivery.sh`: h264, yuv420p, 1920x1080, 30/1, duration 12.000000s, aac 48 kHz stereo. Result: PASS |+| Paper #F2EDE4, ink #16130F, accent #FF5A1F, Space Grotesk Bold | met | CSS tokens in `index.html`. Snapshots show Space Grotesk loaded (its single-storey "y" and the shape of the "g"), not a fallback face |+| Line 1 "Ideas are cheap." from 0.3 to 3.5 s | met | `checks/t_000.30s.png` is empty paper as the first word starts; `t_001.50s.png` shows the full line, spelled exactly |+| Line 2 "Finished is rare." from 3.5 to 7.0 s, replacing line 1 | met | `t_005.00s.png` shows line 2 alone |+| Line 3 "Finish something today." from 7.0 to 12 s | met | `t_008.00s.png` and `t_011.90s.png`. Set on two rows ("Finish something" / "today."); see Decisions |+| Each word arrives with a masked rise, one word at a time | met | Snapshots at 0.45, 0.6 and 0.75 s show "Ideas" landed, "are" mid-rise and "cheap." starting, each clipped by its mask |+| Orange bar wipes at 3.5 s and 7.0 s | met | `t_003.35s.png` bar mid-wipe; `t_003.50s.png` frame fully orange; `t_006.85s.png` second wipe mid-way |+| After the last wipe the bar shrinks into an underline under "today." | met | `t_007.40s.png` bar mid-shrink; `t_008.00s.png` underline sits under "today." and clears the descender of the "y" |+| Hero lands by 8.0 s, holds still and readable until 12.0 s | met | Last word tween ends at 7.88 s. `freezedetect` (n=0.001) reports a freeze from 7.73 s to the end. The small pixel differences between held frames are encoder noise, because they do not shrink over time (10.0 s differs from 11.9 s more than 8.1 s does) |+| Quiet soundtrack with a low accent at 3.5 s and 7.0 s | met | Sub-80 Hz level: 2.9 s gives -21.8 dB, 3.5 s gives -10.9 dB, 5.5 s gives -29.6 dB, 7.0 s gives -11.1 dB. Mix is -18.0 LUFS, true peak -1.8 dBTP |+| Text never touches the frame edge | met | Ink spans x 277–1648 and y 380–728 at 11.9 s, x 300–1628 at 1.5 s and x 336–1592 at 5 s. All of it is inside the 96/54 px safe margins |+| Headlines at least 120 px tall | met | Measured capital height is 126 px on every line (font-size 180 px) |++## Decisions+- Line 3 does not fit on one row at a 120 px cap height inside the safe area, so it sets on two rows. The words, their order and the punctuation are unchanged.+- I read "quiet" as -18 LUFS rather than the skill's -14 default. The bed is the skill's original sine-wave pad and pulse, with low booms at 3.5 s and 7.0 s.+- The bar is a full-frame orange panel. It enters from the left, the text swaps underneath it, and then it either exits to the right (first wipe) or collapses into the underline (second wipe).++## Render settings+- Picture: `npx hyperframes render . -o render.mp4 --quality delivery --fps 30 --workers 8`, which rendered in 4.5 s.+- Sound: `sound_bed.sh bed.wav --seconds 12 --hits 3.5,7.0`+- Finish: `finish.sh --in render.mp4 --out final.mp4 --seconds 12 --audio bed.wav --lufs -18` (CRF 18, AAC 192k)++## Open+- `check_delivery.sh` WARNs about 3 frozen stretches. These are the three intended holds (line 1, line 2 and the hero), not dead air.+- Lint shows 3 warnings suggesting sub-compositions for each line. That is a Studio-organisation hint and has no effect on the render.diff --git a/install.sh b/install.shindex fe3e58e..c0f6b25 100755--- a/install.sh+++ b/install.sh@@ -12,7 +12,7 @@ set -euo pipefailNAME="brief2mp4"HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"-SRC="$HERE/skill/$NAME"+SRC="$HERE/plugin/skills/$NAME"VERSION="$(cat "$HERE/VERSION" 2>/dev/null || echo dev)"CLAUDE_DIR="${CLAUDE_CONFIG_DIR:-$HOME/.claude}/skills"CODEX_DIR="${CODEX_HOME:-$HOME/.codex}/skills"diff --git a/plugin/.claude-plugin/plugin.json b/plugin/.claude-plugin/plugin.jsonnew file mode 100644index 0000000..e7ed1d4--- /dev/null+++ b/plugin/.claude-plugin/plugin.json@@ -0,0 +1,10 @@+{+ "name": "brief2mp4",+ "version": "0.2.0",+ "description": "Turn a written brief into a finished, checked MP4 motion graphic with HyperFrames, Three.js, Blender and ffmpeg.",+ "author": { "name": "Varun Pratap Bhardwaj", "url": "https://github.com/qualixar" },+ "homepage": "https://github.com/qualixar/brief2mp4",+ "repository": "https://github.com/qualixar/brief2mp4",+ "license": "MIT",+ "keywords": ["video", "motion-graphics", "hyperframes", "threejs", "blender", "ffmpeg"]+}diff --git a/plugin/.codex-plugin/plugin.json b/plugin/.codex-plugin/plugin.jsonnew file mode 100644index 0000000..8707c1c--- /dev/null+++ b/plugin/.codex-plugin/plugin.json@@ -0,0 +1,27 @@+{+ "name": "brief2mp4",+ "version": "0.2.0",+ "description": "Turn a written brief into a finished, checked MP4 motion graphic with HyperFrames, Three.js, Blender and ffmpeg.",+ "author": { "name": "Varun Pratap Bhardwaj", "url": "https://github.com/qualixar" },+ "homepage": "https://github.com/qualixar/brief2mp4",+ "repository": "https://github.com/qualixar/brief2mp4",+ "license": "MIT",+ "keywords": ["video", "motion-graphics", "hyperframes", "threejs", "blender", "ffmpeg"],+ "skills": "./skills/",+ "interface": {+ "displayName": "brief2mp4",+ "shortDescription": "Write a brief, get a checked MP4",+ "longDescription": "Paste a written video brief and the agent writes a spec, picks HyperFrames, Three.js or Blender, renders, finishes the file with ffmpeg, checks it against the brief and writes a report.",+ "developerName": "Varun Pratap Bhardwaj",+ "category": "Productivity",+ "capabilities": ["Interactive", "Write"],+ "websiteURL": "https://github.com/qualixar/brief2mp4",+ "composerIcon": "./assets/icon.png",+ "logo": "./assets/icon.png",+ "defaultPrompt": [+ "Use the brief2mp4 skill to make the video in this brief:",+ "Check it against the brief."+ ],+ "brandColor": "#FF5A1F"+ }+}diff --git a/plugin/assets/icon.png b/plugin/assets/icon.pngnew file mode 100644index 0000000..7ebc980Binary files /dev/null and b/plugin/assets/icon.png differdiff --git a/plugin/assets/icon.svg b/plugin/assets/icon.svgnew file mode 100644index 0000000..b2733bb--- /dev/null+++ b/plugin/assets/icon.svg@@ -0,0 +1,12 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="512" height="512">+ <title>brief2mp4</title>+ <rect x="16" y="16" width="480" height="480" rx="104" fill="#16130F"/>+ <g transform="translate(-14 -19)">+ <g fill="#F2EDE4">+ <rect x="96" y="150" width="216" height="40" rx="20"/>+ <rect x="96" y="236" width="216" height="40" rx="20"/>+ <rect x="96" y="322" width="250" height="40" rx="20"/>+ </g>+ <path d="M330 270 Q330 252 346 261 L430 316 Q444 326 430 336 L346 391 Q330 400 330 382 Z" fill="#FF5A1F"/>+ </g>+</svg>diff --git a/skill/brief2mp4/SKILL.md b/plugin/skills/brief2mp4/SKILL.mdsimilarity index 97%rename from skill/brief2mp4/SKILL.mdrename to plugin/skills/brief2mp4/SKILL.mdindex 8056f0b..8725c96 100644--- a/skill/brief2mp4/SKILL.md+++ b/plugin/skills/brief2mp4/SKILL.md@@ -23,7 +23,7 @@ On macOS Blender is often not on the PATH: use `/Applications/Blender.app/ContenWork inside one project folder. Never write outside it.-The scripts and templates named below sit next to this SKILL.md. Call them by their full path, for example `<this skill's folder>/scripts/finish.sh`; after installing they are in `~/.claude/skills/brief2mp4/` or `~/.codex/skills/brief2mp4/`.+The scripts and templates named below sit next to this SKILL.md. Call them by their full path, for example `<this skill's folder>/scripts/finish.sh`; use the folder this SKILL.md was loaded from. A script install puts it in `~/.claude/skills/brief2mp4/` or `~/.codex/skills/brief2mp4/`; a plugin install puts it in the app's plugin cache.## 1. Spec: write SPEC.md before any codediff --git a/skill/brief2mp4/references/blender.md b/plugin/skills/brief2mp4/references/blender.mdsimilarity index 100%rename from skill/brief2mp4/references/blender.mdrename to plugin/skills/brief2mp4/references/blender.mddiff --git a/skill/brief2mp4/references/ffmpeg.md b/plugin/skills/brief2mp4/references/ffmpeg.mdsimilarity index 100%rename from skill/brief2mp4/references/ffmpeg.mdrename to plugin/skills/brief2mp4/references/ffmpeg.mddiff --git a/skill/brief2mp4/references/hyperframes.md b/plugin/skills/brief2mp4/references/hyperframes.mdsimilarity index 100%rename from skill/brief2mp4/references/hyperframes.mdrename to plugin/skills/brief2mp4/references/hyperframes.mddiff --git a/skill/brief2mp4/references/threejs.md b/plugin/skills/brief2mp4/references/threejs.mdsimilarity index 100%rename from skill/brief2mp4/references/threejs.mdrename to plugin/skills/brief2mp4/references/threejs.mddiff --git a/skill/brief2mp4/scripts/check_delivery.sh b/plugin/skills/brief2mp4/scripts/check_delivery.shsimilarity index 100%rename from skill/brief2mp4/scripts/check_delivery.shrename to plugin/skills/brief2mp4/scripts/check_delivery.shdiff --git a/skill/brief2mp4/scripts/contact_sheet.sh b/plugin/skills/brief2mp4/scripts/contact_sheet.shsimilarity index 100%rename from skill/brief2mp4/scripts/contact_sheet.shrename to plugin/skills/brief2mp4/scripts/contact_sheet.shdiff --git a/skill/brief2mp4/scripts/finish.sh b/plugin/skills/brief2mp4/scripts/finish.shsimilarity index 100%rename from skill/brief2mp4/scripts/finish.shrename to plugin/skills/brief2mp4/scripts/finish.shdiff --git a/skill/brief2mp4/scripts/sound_bed.sh b/plugin/skills/brief2mp4/scripts/sound_bed.shsimilarity index 100%rename from skill/brief2mp4/scripts/sound_bed.shrename to plugin/skills/brief2mp4/scripts/sound_bed.shdiff --git a/skill/brief2mp4/templates/SPEC.md b/plugin/skills/brief2mp4/templates/SPEC.mdsimilarity index 100%rename from skill/brief2mp4/templates/SPEC.mdrename to plugin/skills/brief2mp4/templates/SPEC.mddiff --git a/skill/brief2mp4/templates/blender/scene.py b/plugin/skills/brief2mp4/templates/blender/scene.pysimilarity index 100%rename from skill/brief2mp4/templates/blender/scene.pyrename to plugin/skills/brief2mp4/templates/blender/scene.pydiff --git a/skill/brief2mp4/templates/threejs/index.html b/plugin/skills/brief2mp4/templates/threejs/index.htmlsimilarity index 100%rename from skill/brief2mp4/templates/threejs/index.htmlrename to plugin/skills/brief2mp4/templates/threejs/index.html