Skip to content
Back to search

motion-video-skill

Agent skill that produces beat-synced 1080p motion-graphic videos in HyperFrames (HTML + GSAP) with an AI voice-over, karaoke captions, SFX and generated music. MIT.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/bestagentkits--motion-video-skill/badge.svg)](/listings/bestagentkits--motion-video-skill)

HTML

<a href="/listings/bestagentkits--motion-video-skill"><img src="/api/listings/bestagentkits--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.

Any agent, with `npx skills`

The fastest route, and the one that works across agents:

# See what the repository offers without installing
npx skills add bestagentkits/motion-video-skill --list

# Install into the detected agents inside this project
npx skills add bestagentkits/motion-video-skill

# Install globally for Claude Code, without prompts
npx skills add bestagentkits/motion-video-skill -g -a claude-code -y

# Use it once, without installing
npx skills use bestagentkits/motion-video-skill@motion-video | claude

Useful flags: `-g` installs to your user directory instead of the project, `-a <agent>` targets specific agents such as `claude-code` or `codex`, `--copy` copies instead of symlinking, and `-y` skips the prompts.

Claude Code plugin marketplace

/plugin marketplace add bestagentkits/motion-video-skill
/plugin install motion-video@motion-video-skill
/reload-plugins

The same thing from a shell:

claude plugin marketplace add bestagentkits/motion-video-skill
claude plugin install motion-video@motion-video-skill

Invoke the skill as `/motion-video:motion-video`, or just describe the video you want and let Claude route to it.

ChatGPT and Codex plugins

The repository ships a portable [Agent Plugins](https://developers.openai.com/plugins/build/plugins) manifest at the root and a repo marketplace catalog, which is the layout ChatGPT and Codex expect for a skills-only plugin:

codex plugin marketplace add bestagentkits/motion-video-skill
codex plugin marketplace list

In the ChatGPT desktop app, open the Plugins Directory, select the marketplace, and Install. For a personal marketplace instead of a repo one, add an entry to `~/.agents/plugins/marketplace.json` pointing at this repository root.

Public listing in the universal ChatGPT/Codex Plugins Directory is a separate step that goes through OpenAI's [submission portal](https://developers.openai.com/plugins/deploy/submission) and its review process; the package here is already in the submitted shape.

Manual install

Copy `skills/motion-video/` into your agent's skills directory. Any of these locations work, depending on the agent and the scope you want:

| Agent | Project scope | User scope | |---|---|---| | Claude Code | `.claude/skills/motion-video/` | `~/.claude/skills/motion-video/` | | Codex, Cursor, Gemini CLI, OpenCode | `.agents/skills/motion-video/` | `~/.<agent>/skills/motion-video/` | | Pi | `.pi/skills/motion-video/` | `~/.pi/agent/skills/motion-video/` |

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.

.claude-plugin/marketplace.json · Manifest · 33 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
  3. "name": "motion-video-skill",
  4. "description": "Beat-synced motion-graphic video production as an agent skill, from BestAgentKits.",
  5. "version": "1.0.0",
  6. "owner": {
  7. "name": "BestAgentKits"
  8. },
  9. "plugins": [
  10. {
  11. "name": "motion-video",
  12. "displayName": "Motion Video",
  13. "source": "./",
  14. "description": "Produce beat-synced 1080p motion-graphic videos in HyperFrames (HTML + GSAP) with an AI voice-over, Vietnamese karaoke captions, SFX and generated music, in one of two proven styles.",
  15. "version": "1.0.0",
  16. "author": {
  17. "name": "BestAgentKits"
  18. },
  19. "homepage": "https://github.com/bestagentkits/motion-video-skill",
  20. "repository": "https://github.com/bestagentkits/motion-video-skill",
  21. "license": "MIT",
  22. "category": "media",
  23. "tags": [
  24. "video",
  25. "motion-graphic",
  26. "hyperframes",
  27. "gsap",
  28. "voice-over",
  29. "beat-sync"
  30. ]
  31. }
  32. ]
  33. }
README.md · README · 218 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Motion Video
  2. An agent skill that produces a beat-synced 1920×1080 30 fps motion-graphic video:
  3. the scene cuts land on the music's beats, the reveals land on the spoken words,
  4. and the audio is broadcast-clean.
  5. ```bash
  6. npx skills add bestagentkits/motion-video-skill
  7. ```
  8. MIT licensed. Works with Claude Code, Codex, Cursor, OpenCode, Gemini CLI, Pi and
  9. any other agent that reads Agent Skills.
  10. ## Demo
  11. The comic-multiverse edition of the Dewee v3.34 release video, produced by this
  12. skill from a single prompt:
  13. **→ [Watch the 151 s demo on X](https://x.com/goon_nguyen/status/2103332658151555231)**
  14. The same release also has a 144 s glass-keynote edition. Neither working project
  15. is bundled with this repository, because the generated voice-over, music and SFX
  16. are large and provider-licensed.
  17. ## What it does
  18. Each run follows one fixed pipeline, and every step writes the file the next step
  19. reads, so the order matters:
  20. 1. Pin the outcome: topic and sources, style, duration, voice language, ending.
  21. 2. Scaffold `assets/videos/<slug>/` from the bundled templates.
  22. 3. Generate the voice-over, sound effects and music through the `multix` CLI.
  23. 4. Align the voice-over to the script, so every word has a real timestamp.
  24. 5. Fit the beat grid, then splice music bars so the drops fall where the script
  25. needs them.
  26. 6. Build the timeline and the audio mix, then measure the voice/music balance.
  27. 7. Author `index.html` against the composition contract and the chosen style.
  28. 8. Lint, check, snapshot and render with HyperFrames, remux the untouched mix,
  29. and encode a smaller social version.
  30. A run is finished only when the measurable checks pass: `hyperframes lint` and
  31. `check` clean, every music segment within ±2 ms of its target beat, music about
  32. 4–6 dB under speech, 1920×1080 at 30 fps, and EBU R128 around −14 LUFS with a
  33. true peak no higher than −1 dBFS.
  34. ## Two styles
  35. | Style | Style reference | Demo | Feel |
  36. |---|---|---|---|
  37. | Comic multiverse | [`references/style-comic-spiderverse.md`](skills/motion-video/references/style-comic-spiderverse.md) | [151 s edition](https://x.com/goon_nguyen/status/2103332658151555231) | loud, playful, hand-made |
  38. | Glass keynote | [`references/style-glass-keynote.md`](skills/motion-video/references/style-glass-keynote.md) | 144 s edition | premium, calm, clear |
  39. A restyle is a new project directory, so the first edition always stays intact.
  40. ## Install
  41. ### Any agent, with `npx skills`
  42. The fastest route, and the one that works across agents:
  43. ```bash
  44. # See what the repository offers without installing
  45. npx skills add bestagentkits/motion-video-skill --list
  46. # Install into the detected agents inside this project
  47. npx skills add bestagentkits/motion-video-skill
  48. # Install globally for Claude Code, without prompts
  49. npx skills add bestagentkits/motion-video-skill -g -a claude-code -y
  50. # Use it once, without installing
  51. npx skills use bestagentkits/motion-video-skill@motion-video | claude
  52. ```
  53. Useful flags: `-g` installs to your user directory instead of the project,
  54. `-a <agent>` targets specific agents such as `claude-code` or `codex`, `--copy`
  55. copies instead of symlinking, and `-y` skips the prompts.
  56. ### Claude Code plugin marketplace
  57. ```text
  58. /plugin marketplace add bestagentkits/motion-video-skill
  59. /plugin install motion-video@motion-video-skill
  60. /reload-plugins
  61. ```
  62. The same thing from a shell:
  63. ```bash
  64. claude plugin marketplace add bestagentkits/motion-video-skill
  65. claude plugin install motion-video@motion-video-skill
  66. ```
  67. Invoke the skill as `/motion-video:motion-video`, or just describe the video you
  68. want and let Claude route to it.
  69. ### ChatGPT and Codex plugins
  70. The repository ships a portable [Agent Plugins](https://developers.openai.com/plugins/build/plugins)
  71. manifest at the root and a repo marketplace catalog, which is the layout ChatGPT
  72. and Codex expect for a skills-only plugin:
  73. ```bash
  74. codex plugin marketplace add bestagentkits/motion-video-skill
  75. codex plugin marketplace list
  76. ```
  77. In the ChatGPT desktop app, open the Plugins Directory, select the marketplace,
  78. and Install. For a personal marketplace instead of a repo one, add an entry to
  79. `~/.agents/plugins/marketplace.json` pointing at this repository root.
  80. Public listing in the universal ChatGPT/Codex Plugins Directory is a separate
  81. step that goes through OpenAI's
  82. [submission portal](https://developers.openai.com/plugins/deploy/submission) and
  83. its review process; the package here is already in the submitted shape.
  84. ### Manual install
  85. Copy `skills/motion-video/` into your agent's skills directory. Any of these
  86. locations work, depending on the agent and the scope you want:
  87. | Agent | Project scope | User scope |
  88. |---|---|---|
  89. | Claude Code | `.claude/skills/motion-video/` | `~/.claude/skills/motion-video/` |
  90. | Codex, Cursor, Gemini CLI, OpenCode | `.agents/skills/motion-video/` | `~/.<agent>/skills/motion-video/` |
  91. | Pi | `.pi/skills/motion-video/` | `~/.pi/agent/skills/motion-video/` |
  92. ## Requirements
  93. | Requirement | Why |
  94. |---|---|
  95. | Node.js 20+ | The pipeline scripts are ESM and run with `node`. |
  96. | Python 3.10+ with `numpy` and `scipy` | Beat-grid fitting, arrangement verification, mix-balance measurement. |
  97. | `ffmpeg` and `ffprobe` on `PATH` | Decoding, mixing, remuxing, loudness and black-frame checks. |
  98. | The `multix` CLI, authenticated with a Gemini key and an ElevenLabs key | Voice-over, sound effects, music composition plans and forced alignment. |
  99. | `npx --yes hyperframes@0.7.99` | Lint, check, snapshot, preview and render. No install step is needed. |
  100. Keep API keys in the `multix` CLI's own configuration. The skill never prints key values
  101. and never writes them into project files, plans or reports.
  102. ## Quick start
  103. Install the skill, then ask your agent for the video:
  104. ```text
  105. Make a 100-second launch video for the 3.34 release with a voice-over,
  106. captions and music, in the comic multiverse style.
  107. ```
  108. To drive the pipeline yourself, start from the templates:
  109. ```bash
  110. mkdir -p assets/videos/my-video
  111. cp -r skills/motion-video/assets/templates/scripts skills/motion-video/assets/templates/data \
  112. skills/motion-video/assets/templates/hyperframes.json \
  113. skills/motion-video/assets/templates/index-skeleton.html \
  114. assets/videos/my-video/
  115. cd assets/videos/my-video
  116. # rename data/*.example.json to data/*.json,
  117. # and index-skeleton.html to index.html
  118. ```
  119. Then follow
  120. [`references/production-pipeline.md`](skills/motion-video/references/production-pipeline.md)
  121. step by step. In the skill's own documentation, `<skill>` means the installed
  122. skill directory, for example `~/.claude/skills/motion-video`.
  123. ## What is in the box
  124. ```text
  125. .
  126. ├── .agents/plugins/marketplace.json ChatGPT / Codex repo marketplace catalog
  127. ├── .claude-plugin/
  128. │ ├── marketplace.json Claude Code marketplace catalog
  129. │ └── plugin.json Claude Code plugin manifest
  130. ├── plugin.json Portable Agent Plugins 1.0 manifest
  131. ├── skills/motion-video/
  132. │ ├── SKILL.md Routing and the definition of done
  133. │ ├── references/
  134. │ │ ├── production-pipeline.md Every command, scaffold to social encode
  135. │ │ ├── audio-and-beat-sync.md Voice, cues, music plans, splice, mix
  136. │ │ ├── composition-contract.md TIMING shape, helpers, determinism
  137. │ │ ├── style-glass-keynote.md Tokens, layers, transitions, captions
  138. │ │ └── style-comic-spiderverse.md The second style, same contract
  139. │ ├── scripts/
  140. │ │ ├── fit-beat-grid.py BPM, BEAT0 and a per-bar kick/energy table
  141. │ │ ├── verify-arrangement.py Splice lag per segment; exits 1 on drift
  142. │ │ ├── measure-mix-balance.py Music under speech versus in the gaps
  143. │ │ └── tests/ Regression tests on synthetic audio
  144. │ └── assets/templates/
  145. │ ├── index-skeleton.html Composition skeleton
  146. │ ├── hyperframes.json Renderer configuration
  147. │ ├── scripts/ Voice, SFX, music, alignment, timeline
  148. │ └── data/ Example script, cues, SFX, music, outro
  149. ├── AGENTS.md Operating notes for agents working here
  150. ├── README.md
  151. └── LICENSE
  152. ```
  153. The plugin root is the repository root, so `skills/` sits at the top level and no
  154. file is duplicated between the skill package and the plugin manifests.
  155. ## Tests
  156. ```bash
  157. python -m unittest discover -s skills/motion-video/scripts/tests
  158. ```
  159. The suite runs the beat-grid fitter and the arrangement checker against synthetic
  160. audio, so it needs `ffmpeg`, `numpy` and `scipy`, and no network access.
  161. ## License
  162. MIT. See [LICENSE](LICENSE).
  163. No generated media is bundled. The skill instructs the agent to use open-licensed
  164. (SIL OFL or Apache) fonts from Google Fonts, and it produces its voice-over, music
  165. and sound effects inside your own provider accounts.

Ratings and comments

Sign in to rate this skill.

Sign in

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