motion-video-skill
Claude Code 스킬: 모션 그래픽·영상 제작 순서와 단계별 점검 하네스
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/unclejobs-ai/motion-video-skill with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/unclejobs-ai/motion-video-skill'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/unclejobs-ai--motion-video-skill)HTML
<a href="/listings/unclejobs-ai--motion-video-skill"><img src="/api/listings/unclejobs-ai--motion-video-skill/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
공통 설치 (Codex·Claude Code·다른 런타임)
스킬을 사용할 프로젝트 폴더에서 실행합니다. Node.js와 npx가 필요하며, 사용할 런타임을 선택해 설치합니다.
npx skills add unclejobs-ai/motion-video-skill --skill motion-video-production
Codex만 지정하려면 아래처럼 실행합니다. 개인 범위로 설치하려면 `--global`을 추가합니다.
npx skills add unclejobs-ai/motion-video-skill --skill motion-video-production --agent codex
[Vercel skills CLI](https://github.com/vercel-labs/skills)가 Codex, Claude Code, Gemini CLI, Cursor, GitHub Copilot, OpenCode, Amp, Antigravity, Windsurf 등 지원 대상의 설치 위치를 처리합니다. **설치 호환성과 전체 영상 제작 검증은 다릅니다.** 생성 도구 연결과 이미지 보기·명령 실행 권한은 각 런타임 환경에 달려 있습니다. [런타임별 설치·호출과 검증 범위](docs/runtimes.md)를 참고합니다.
<details> <summary><strong>수동 설치 (Node.js 없이)</strong></summary>
Codex는 프로젝트 `.agents/skills/`와 개인 `~/.agents/skills/`에서 스킬을 읽습니다. 아래는 개인 설치 예시입니다.
git clone https://github.com/unclejobs-ai/motion-video-skill.git mkdir -p ~/.agents/skills cp -r motion-video-skill/skills/motion-video-production ~/.agents/skills/
Claude Code는 프로젝트 `.claude/skills/`와 개인 `~/.claude/skills/`에서 스킬을 읽습니다. 기존 설치 명령도 계속 사용할 수 있습니다.
git clone https://github.com/unclejobs-ai/motion-video-skill.git mkdir -p ~/.claude/skills cp -r motion-video-skill/skills/motion-video-production ~/.claude/skills/
특정 프로젝트에서만 쓰려면 해당 프로젝트의 런타임별 스킬 폴더 아래에 같은 폴더를 복사합니다. 한 런타임에 같은 이름을 여러 경로로 중복 설치하지 않습니다.
</details>
첫 요청
설치한 뒤 런타임의 스킬 목록에서 `motion-video-production`을 확인합니다. 보이지 않으면 런타임을 새로 시작합니다. Codex에서는 `$motion-video-production`, Claude Code와 Cursor에서는 `/motion-video-production`으로 명시적으로 호출하거나 아래처럼 요청합니다.
> 캐릭터가 나오는 30초짜리 오프닝 영상을 만들고 싶어.
에이전트가 먼저 4가지(공개 방식, 길이와 화면비, 쓸 수 있는 도구, 금지 요소)를 묻고, `STORY.md`부터 단계 순서대로 진행합니다. 생성 도구가 없으면 프롬프트를 전달하고 사용자가 생성한 파일을 받아 이어갑니다. 이미지를 볼 수 없으면 사용자의 실제 눈 검수를 요청합니다.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 102 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # motion-video-production
- **English** · [한국어](README.ko.md)
- [](https://github.com/unclejobs-ai/motion-video-skill/stargazers) [](LICENSE) [](docs/runtimes.md)
- 
- 
- An Agent Skill for 15–90 second motion graphics, promo and character videos. The agent works in seven stages. After each stage a script checks the output, and the next stage waits until it passes. At the end, one table shows what was measured in the finished file; a person still looks at the picture and listens to the sound.
- Works in Codex, Claude Code and other runtimes that read Agent Skills.
- ## Install
- Run this in your video project folder:
- ```bash
- npx skills add unclejobs-ai/motion-video-skill --skill motion-video-production
- ```
- Add `--global` to install it for all projects. For manual install and per-runtime paths, see [docs/runtimes.md](docs/runtimes.md).
- You need Node.js 24+, ffmpeg, Python 3 and Bash (WSL on Windows).
- ## Use
- Ask your agent:
- > Make a 20-second promo that feels like this reference video.
- You can also call it by name: `$motion-video-production` in Codex, `/motion-video-production` in Claude Code and Cursor.
- The agent asks six questions first: where the video goes, length and aspect ratio, which tools you have, what to avoid, the reference video, and which engine to use. Then it works through the stages. If you have no image or video generator, it writes the prompts and picks up from the files you bring back.
- ## How it works
- 
- | Stage | Gate | Checks |
- |---|---|---|
- | 0. Reference | `ref` | Cuts, motion, blur, grain and look as numbers. The final render is measured the same way |
- | 1. Story | `story` | BPM, music sync table, scene table |
- | 2. Character | `character` | One-paragraph description, colors, sheet image |
- | 3. Keyframes | `keyframes` | Duplicates, aspect ratio |
- | 4. Clips | `clips` | Duration, frame count, start-frame match, frame strips |
- | 5. Music and voice | `audio` | One voice ID, dialogue files |
- | 6. Edit | `edit`, `final` | Beat grid, cut continuity, dialogue length, loudness |
- 
- The clip at the top is what stages 3 and 4 produce. The three keyframes were drawn first, and the video model filled only the motion between them.
- Exit code `0` means move on. Exit code `1` means fix the lines listed in `qa/gate-<stage>.txt` and run the gate again. Some things only eyes can judge, such as a face drifting a second into a clip. Those pass only after someone looks at the frame strips and writes a review.
- ## How results are verified
- `scripts/verify.sh` checks the finished video, final mix included, and prints one table, cheapest checks first. It saves the table as `qa/VERIFY.md` beside the video. [Commands, limits and coverage](docs/verification.md).
- - **The machine measures the file**: every frame decodes, frame rate and size are right, sound and picture have the same length, average loudness is near −14 LUFS and the loudest peak stays under −1 dBTP. For a Remotion production it also checks that something on screen carries over each scene change instead of a bare jump. Given a plan for graphics laid over filmed footage, it checks that the footage never flashes between two graphics and that no card stays over 9 seconds.
- - **A person checks what numbers can't**: cut timing, clipped text, a face that changes, how the mix sounds. For this the table links a contact sheet (small frames across the whole video) and the last frame. Those rows say LOOK, never PASS, and the final gate waits for a written review.
- - **New checks only warn at first** (`observe`). They block a run (`enforce`) only after they have been tried on real work.
- ## Try the demo
- This renders a 5-second typography clip with Remotion. It takes about 30 seconds.
- ```bash
- SKILL_ROOT="$PWD/.agents/skills/motion-video-production" # your install path
- mkdir engine && cp -R "$SKILL_ROOT/engines/remotion/." engine
- cd engine && npm ci
- node pipeline/probe.mjs productions/carry-demo # carry 1.00 PASS
- node pipeline/render.mjs carry-demo # renders/carry-demo/picture.mp4
- ```
- 
- The first line shrinks into the label of the next scene. `probe.mjs` checks before rendering that something on screen carries across every cut.
- ## What's inside
- - **Two engines.** Remotion has the carry probe and a wordcut template. HyperFrames renders plain HTML/CSS with GSAP. [Which one to use](skills/motion-video-production/references/engines.md)
- - **Reference analysis.** OpenCV turns a reference video into target numbers. [How it works](skills/motion-video-production/references/reference-analysis.md)
- - **Voice and music.** ElevenLabs and Fish Audio voices through the composio CLI, plus a procedural score on the beat.
- - **Timeline editor.** Picture, text, voice and music tracks in the browser. It edits the same `edit.json` the agent does. [Details](skills/motion-video-production/timeline/README.md)
- 
- ## Docs
- The agent reads these as it needs them. Most are written in Korean, and gate output is in Korean too. The agent still answers in your language.
- - [`SKILL.md`](skills/motion-video-production/SKILL.md): stage order and gate calls
- - [`references/`](skills/motion-video-production/references/): art direction, beat grid, consistency, providers, cost
- - [`references/gotchas.md`](skills/motion-video-production/references/gotchas.md): 29 known failure modes
- - [`docs/runtimes.md`](docs/runtimes.md): install paths, known limitations, what was tested
- ## License
- MIT. Remotion needs a paid Company License if your company has four or more people. HyperFrames is Apache-2.0. Third-party terms are in [`NOTICE.md`](NOTICE.md).
- Made by the team behind [SceneSteller](https://www.scenesteller.com/?utm_source=github&utm_medium=readme&utm_campaign=motion-video-skill).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.