Skip to content
Back to search

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/unclejobs-ai--motion-video-skill/badge.svg)](/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

i

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.

  1. # motion-video-production
  2. **English** · [한국어](README.ko.md)
  3. [![GitHub stars](https://img.shields.io/github/stars/unclejobs-ai/motion-video-skill?style=flat&color=ff5a14)](https://github.com/unclejobs-ai/motion-video-skill/stargazers) [![License: MIT](https://img.shields.io/badge/license-MIT-0a0a09)](LICENSE) [![Agent Skills](https://img.shields.io/badge/format-Agent%20Skills-5c5a52)](docs/runtimes.md)
  4. ![A paper-craft character snaps a clapperboard shut and presents a three-frame filmstrip](docs/assets/hero-clip.gif)
  5. ![Measure the reference, pass seven gated stages, judge the mp4 against the same targets](docs/assets/hero.png)
  6. 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.
  7. Works in Codex, Claude Code and other runtimes that read Agent Skills.
  8. ## Install
  9. Run this in your video project folder:
  10. ```bash
  11. npx skills add unclejobs-ai/motion-video-skill --skill motion-video-production
  12. ```
  13. Add `--global` to install it for all projects. For manual install and per-runtime paths, see [docs/runtimes.md](docs/runtimes.md).
  14. You need Node.js 24+, ffmpeg, Python 3 and Bash (WSL on Windows).
  15. ## Use
  16. Ask your agent:
  17. > Make a 20-second promo that feels like this reference video.
  18. You can also call it by name: `$motion-video-production` in Codex, `/motion-video-production` in Claude Code and Cursor.
  19. 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.
  20. ## How it works
  21. ![Seven production stages, a gate after each, and the BLOCK loop](docs/assets/workflow.png)
  22. | Stage | Gate | Checks |
  23. |---|---|---|
  24. | 0. Reference | `ref` | Cuts, motion, blur, grain and look as numbers. The final render is measured the same way |
  25. | 1. Story | `story` | BPM, music sync table, scene table |
  26. | 2. Character | `character` | One-paragraph description, colors, sheet image |
  27. | 3. Keyframes | `keyframes` | Duplicates, aspect ratio |
  28. | 4. Clips | `clips` | Duration, frame count, start-frame match, frame strips |
  29. | 5. Music and voice | `audio` | One voice ID, dialogue files |
  30. | 6. Edit | `edit`, `final` | Beat grid, cut continuity, dialogue length, loudness |
  31. ![Three keyframes of the clip above: clapperboard open, shut, and the final pose](docs/assets/keyframes.png)
  32. 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.
  33. 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.
  34. ## How results are verified
  35. `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).
  36. - **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.
  37. - **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.
  38. - **New checks only warn at first** (`observe`). They block a run (`enforce`) only after they have been tried on real work.
  39. ## Try the demo
  40. This renders a 5-second typography clip with Remotion. It takes about 30 seconds.
  41. ```bash
  42. SKILL_ROOT="$PWD/.agents/skills/motion-video-production" # your install path
  43. mkdir engine && cp -R "$SKILL_ROOT/engines/remotion/." engine
  44. cd engine && npm ci
  45. node pipeline/probe.mjs productions/carry-demo # carry 1.00 PASS
  46. node pipeline/render.mjs carry-demo # renders/carry-demo/picture.mp4
  47. ```
  48. ![Animated result of the 5-second carry demo](docs/assets/carry-demo.gif)
  49. The first line shrinks into the label of the next scene. `probe.mjs` checks before rendering that something on screen carries across every cut.
  50. ## What's inside
  51. - **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)
  52. - **Reference analysis.** OpenCV turns a reference video into target numbers. [How it works](skills/motion-video-production/references/reference-analysis.md)
  53. - **Voice and music.** ElevenLabs and Fish Audio voices through the composio CLI, plus a procedural score on the beat.
  54. - **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)
  55. ![Timeline editor with preview, inspector and four tracks on a beat grid](docs/assets/timeline.png)
  56. ## Docs
  57. 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.
  58. - [`SKILL.md`](skills/motion-video-production/SKILL.md): stage order and gate calls
  59. - [`references/`](skills/motion-video-production/references/): art direction, beat grid, consistency, providers, cost
  60. - [`references/gotchas.md`](skills/motion-video-production/references/gotchas.md): 29 known failure modes
  61. - [`docs/runtimes.md`](docs/runtimes.md): install paths, known limitations, what was tested
  62. ## License
  63. 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).
  64. 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 in

Free to use. If it’s helped, pass it on.