Skip to content
Back to search

bang-motion

MarketplaceWorks with Claude CodeGitHub

Bang Motion — an agent skill for browser motion graphics that move like video, not slides.

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/bangtutorial--bang-motion/badge.svg)](/listings/bangtutorial--bang-motion)

HTML

<a href="/listings/bangtutorial--bang-motion"><img src="/api/listings/bangtutorial--bang-motion/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.

Bang Motion follows the open **Agent Skills** layout: a folder with `SKILL.md` (frontmatter + instructions), `references/`, `assets/`, `scripts/`. It also ships as a Claude Code **plugin**.

As a plugin (Claude Code)

/plugin marketplace add bangtutorial/bang-motion
/plugin install bang-motion@bang-motion

Update later with `/plugin marketplace update bang-motion`.

Manual (any agent)

git clone https://github.com/bangtutorial/bang-motion

| Agent | Where it goes | |---|---| | Claude Code | `~/.claude/skills/bang-motion` (Windows: `C:\Users\<you>\.claude\skills\bang-motion`) | | Codex CLI | your Codex skills folder, or add to `AGENTS.md`: *"For motion graphics / explainers, read and follow `bang-motion/SKILL.md`."* | | Gemini CLI · Cursor · others | copy into the project and reference `SKILL.md` from `GEMINI.md`, `.cursor/rules`, or the system prompt | | Plain chat (no agent) | paste `SKILL.md` + the relevant file in `references/` as instructions; attach a starter from `assets/` |

> Install **one copy** only. Two copies with the same skill name (for example a plugin and a manual folder) conflict, and the plugin wins.

The skill triggers on requests like "make an opener…", "promo video…", "explainer…", or a complaint that a web animation "looks like PowerPoint".

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 · 32 lines

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

  1. {
  2. "name": "bang-motion",
  3. "description": "Bang Motion — an agent skill for browser motion graphics that move like video, not slides.",
  4. "owner": {
  5. "name": "Bang Tutorial"
  6. },
  7. "plugins": [
  8. {
  9. "name": "bang-motion",
  10. "source": "./",
  11. "displayName": "Bang Motion",
  12. "description": "Openers, promos, bumpers, kinetic typography, and five explainer styles — built as a single index.html that autoplays and loops. Style is derived from the brand via a required style brief, never inherited from the starter or a reference.",
  13. "version": "1.19.0",
  14. "author": {
  15. "name": "Bang Tutorial",
  16. "url": "https://youtube.com/bangtutorial"
  17. },
  18. "homepage": "https://github.com/bangtutorial/bang-motion",
  19. "license": "MIT",
  20. "keywords": [
  21. "motion-graphics",
  22. "explainer",
  23. "opener",
  24. "promo",
  25. "animation",
  26. "kinetic-typography",
  27. "gsap",
  28. "video"
  29. ]
  30. }
  31. ]
  32. }
README.md · README · 321 lines

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

  1. <div align="center">
  2. <img src="icon.svg" width="112" alt="Bang Motion icon">
  3. # Bang Motion
  4. **An agent skill that turns your AI coding agent into a motion designer.**<br>
  5. Openers, promos, product demos, kinetic typography, and explainers — built as a single `index.html` that plays like video, not like slides.
  6. [![Version](https://img.shields.io/badge/version-1.19.0-2f6fd6?style=flat-square)](CHANGELOG.md)
  7. [![License: MIT](https://img.shields.io/badge/license-MIT-3fa34d?style=flat-square)](LICENSE)
  8. [![Agent Skills](https://img.shields.io/badge/format-Agent%20Skills-1c2a4a?style=flat-square)](#install)
  9. [![Works with](https://img.shields.io/badge/works%20with-Claude%20Code%20%C2%B7%20Codex%20%C2%B7%20Gemini%20CLI%20%C2%B7%20Cursor-7a5af5?style=flat-square)](#install)
  10. <img src="docs/gallery/hero.jpg" alt="A grid of styles Bang Motion can build: grainy gradient opener, SaaS product tour, flat pop promo with photos, visual journalism explainer, continuous action explainer, cartoon collage explainer" width="100%">
  11. [What you can make](#what-you-can-make) · [Style gallery](#style-gallery) · [Workflow](#recommended-workflow) · [Example prompts](#example-prompts) · [Install](#install) · [FAQ](#faq)
  12. </div>
  13. ---
  14. ## Why
  15. Ask an AI agent for "a video" and you usually get **slides**: one section per idea, a title, a photo, a fade between them. Bang Motion encodes what a working motion designer insists on — one continuous world, a camera that actually moves, a subject that persists, text that lives inside the scene — as **rules an agent can check in its own code**, plus starters that make the right architecture the easy path.
  16. It also stops every project from looking the same. The look is **derived from your brand** through a required style brief, the structure is **chosen from a menu of concepts**, and nothing is inherited from the starter or copied from a reference.
  17. ## What you can make
  18. | | Output | Typical length |
  19. |---|---|---|
  20. | 🎬 **Openers & promos** | product launches, app promos, campaign spots, teasers | 15–40 s |
  21. | 🖥️ **Product & SaaS demos** | UI assembled and used on screen, camera following the clicks | 20–60 s |
  22. | 🔤 **Kinetic typography** | lyric-style statements, event announcements, manifestos | 10–30 s |
  23. | 📺 **Bumpers, idents, channel intros** | short brand moments that loop | 3–10 s |
  24. | 🧭 **Explainers** | six explainer styles, optional voice-over sync, 16:9 or 9:16 | 30–120 s |
  25. | 🎥 **Video layers** | your own or generated clips placed like footage — inside devices, frames, and masks, locked to the timeline | — |
  26. | 🎞️ **After Effects builds** | cartoon explainers built directly inside AE through the Higgsfield MCP bridge | — |
  27. Every deliverable is one `index.html`: double-click to play, autoplay + loop, `?debug=1` for a scrub bar, and an optional frame-by-frame export to MP4.
  28. ## Style gallery
  29. > Each frame below is a **single static scene** built for this README with **fictional brands and data**. The portrait, product photos, port photo, engraving, and cartoon cutouts were generated with GPT Image 2.5; everything else is HTML, CSS, and SVG. Real projects take their palette, type, and imagery from your brand.
  30. <table>
  31. <tr>
  32. <td width="50%"><img src="docs/gallery/01-grainy-gradient.jpg" alt="Grainy gradient opener"><br><b>Grainy gradient</b> · opener<br><sub>Glowing layered shapes, soft grain, a camera that travels through them. Tech, AI, music, premium launches.</sub></td>
  33. <td width="50%"><img src="docs/gallery/02-kinetic-colorblock.jpg" alt="Kinetic typography in poster color-block"><br><b>Poster color-block</b> · kinetic typography<br><sub>Huge cropped words, solid color fields that slam in on the beat. Events, music, launches.</sub></td>
  34. </tr>
  35. <tr>
  36. <td><img src="docs/gallery/03-saas-ui-tour.jpg" alt="SaaS product tour"><br><b>Product tour with claims</b> · SaaS demo<br><sub>Real UI lifted out of the dashboard, the camera zooms into what gets clicked. SaaS, dashboards, B2B.</sub></td>
  37. <td><img src="docs/gallery/04-flat-vector.jpg" alt="Flat vector illustration promo"><br><b>Flat vector illustration</b> · promo<br><sub>Solid fills, stylized hands, UI drawn flat, shapes with gentle overshoot. Fintech, consumer apps.</sub></td>
  38. </tr>
  39. <tr>
  40. <td><img src="docs/gallery/07-flat-pop-photo.jpg" alt="Flat pop with photos promo"><br><b>Flat pop with photos</b> · promo<br><sub>Photo cutouts popping in, stickers, brand color fields that change with a visible trigger. Consumer apps, campaigns.</sub></td>
  41. <td><img src="docs/gallery/05-continuous-action.jpg" alt="Continuous action explainer"><br><b>Continuous action</b> · explainer<br><sub>One subject that never stops, numbers and maps living inside the world. Speed, routes, processes.</sub></td>
  42. </tr>
  43. <tr>
  44. <td><img src="docs/gallery/09-visual-journalism.jpg" alt="Visual journalism explainer"><br><b>Visual journalism</b> · explainer<br><sub>Black ground, real photos with source tags, highlighter, dashed annotations. News, current issues.</sub></td>
  45. <td><img src="docs/gallery/08-white-catalog.jpg" alt="White catalog explainer"><br><b>White catalog</b> · explainer<br><sub>White grid, product cutouts, mixed script and heavy sans. Products, brands.</sub></td>
  46. </tr>
  47. <tr>
  48. <td><img src="docs/gallery/10-vintage-sketch.jpg" alt="Vintage sketch explainer"><br><b>Vintage sketch</b> · explainer<br><sub>Sepia paper, engraving art, classic serifs, rust notes. History, biography.</sub></td>
  49. <td><img src="docs/gallery/11-cartoon-collage.jpg" alt="Cartoon collage explainer"><br><b>Cartoon collage</b> · explainer<br><sub>Cream paper, flat illustration cutouts, color pills, handwriting. Science, education.</sub></td>
  50. </tr>
  51. <tr>
  52. <td><img src="docs/gallery/06-cartoon-stage.jpg" alt="Cartoon stage explainer"><br><b>Cartoon stage</b> · explainer<br><sub>One living stage per scene, jointed characters, no captions. Education with characters.</sub></td>
  53. <td><img src="docs/gallery/12-more-combinations.jpg" alt="Style brief with three concept candidates and one recommended pick"><br><b>…and many more</b><br><sub>10 styles × 19 concepts × 9 render families — three candidates, one pick.</sub></td>
  54. </tr>
  55. </table>
  56. ## The menus behind the looks
  57. <details>
  58. <summary><b>10 style directions</b> — the skin, derived from your brand</summary>
  59. | Direction | Background | Typography | Signature motion | Good for |
  60. |---|---|---|---|---|
  61. | Cinematic dark | near-black gradient, particles, bloom only on objects | bold clean grotesk | push-through, light in front of the lens | creative tools, gaming, tech |
  62. | Poster color-block | large solid color fields changing per scene | ultra-heavy display, giant cropped letters | block wipes, text slamming the frame edge | consumer apps, music, events |
  63. | Editorial light | white/cream, generous space, hairlines | display serif + small grotesk | calm slides, lines that draw | productivity, finance, SaaS |
  64. | Paper & print | paper texture, collage, stamps, tape | handwriting + serif | objects flying in and landing | education, community, food |
  65. | Retro / analog | faded color, grain, scanlines | 70s–90s geometric | controlled glitch, rough zoom, freeze | nostalgia, music, entertainment |
  66. | Brutalist mono | black and white, hard grid | monospace + condensed | hard cuts, shifting blocks, blinking cursor | developer tools |
  67. | Pastel playful | stacked pastels, big round shapes | heavy rounded sans | elastic bounce, blooming shapes | kids, health, lifestyle |
  68. | Luxury dark | black + gold/bronze, soft shadows | tall wide-tracked serif | slow motion, sweeping light, depth | fashion, automotive, property |
  69. | Flat pop with photos | neutral light alternating with solid brand fields | rounded heavy sans + giant cropped words | cutouts popping in, stickers, fields snapping on the beat | consumer apps, fintech, e-commerce |
  70. | Grainy gradient | deep base, saturated glowing shapes, fine grain | small clean grotesk or minimal heavy display | layers opening, camera through the shape, a guiding orb | tech, AI, music, creative launches |
  71. </details>
  72. <details>
  73. <summary><b>19 opener concepts</b> — the structure, chosen per product</summary>
  74. | # | Concept | Good for |
  75. |---|---|---|
  76. | 1 | One continuous shot | creative tools, hardware, spaces |
  77. | 2 | Pure typography | strong taglines, events, releases |
  78. | 3 | Problem → gone | productivity, utilities |
  79. | 4 | Before / after | editors, filters, optimization |
  80. | 5 | Journey inside the UI | apps with a distinctive UI |
  81. | 6 | Product macro | hardware, packaging, F&B, fashion |
  82. | 7 | Object metaphor | security, cloud, finance |
  83. | 8 | Living number | milestones, performance |
  84. | 9 | One feature, fully demoed | apps with one clear edge |
  85. | 10 | Diegetic question → answer | AI, search, support |
  86. | 11 | Rhythmic collage | music, lifestyle, community |
  87. | 12 | Logo as stage | brands with a strong logo shape |
  88. | 13 | Object relay | e-commerce, delivery, marketplaces |
  89. | 14 | Brand system showcase | launches, rebrands, communities |
  90. | 15 | Claim → how → result | new features, generative AI, creative tools |
  91. | 16 | Living UI ecosystem | B2B SaaS, AI assistants, workflows |
  92. | 17 | Flat pop with photos | consumer apps, fintech, campaigns |
  93. | 18 | Through the gradient shapes | tech, AI, security, premium launches |
  94. | 19 | Product tour with claims | SaaS, team tools, dashboards |
  95. Each concept ships as principles and a menu of openings, transitions, and endings — never as a script to copy.
  96. </details>
  97. <details>
  98. <summary><b>6 explainer styles</b> — each with its own starter</summary>
  99. | Style | Look | Best for |
  100. |---|---|---|
  101. | Continuous action | flowing vector world, one subject that never leaves, changing viewpoints | speed, routes, processes |
  102. | Cartoon collage | cream paper, flat illustration cutouts, handwriting, color pills | science, education |
  103. | Visual journalism | black, real photos with source tags, highlighter, dashed annotations | news, current issues |
  104. | White catalog | white grid, photo cutouts, mixed typography, scribbles | products, brands |
  105. | Vintage sketch | sepia paper, engraving art, classic serifs, rust annotations | history, biography |
  106. | Cartoon stage | one stage per scene, jointed characters, no captions | education with characters |
  107. </details>
  108. ## Recommended workflow
  109. ```mermaid
  110. flowchart LR
  111. A[Brief<br>product, logo, audience,<br>length, ratio] --> B[Style brief<br>3 concept candidates,<br>palette with sources]
  112. B --> C{You approve}
  113. C --> D[Assets<br>your photos & logo<br>or generated via MCP]
  114. D --> E[Build<br>index.html]
  115. E --> F[Verify frames<br>snap.mjs / ?debug=1]
  116. F --> G[Your feedback]
  117. G --> E
  118. G --> H[Deliver<br>HTML · MP4 · voice-over sync]
  119. ```
  120. 1. **Brief the agent.** Name the product, attach the logo or site, say who it is for, the length, and the ratio. Mention a style if you have one in mind — the name is enough.
  121. 2. **Approve the style brief.** The agent answers with three concept candidates, one recommendation, a structure fingerprint, and a palette where every color states its source. Change anything before a line of code is written.
  122. 3. **Settle the assets.** Your own photos and logo come first. If you have none, the agent can generate them through an image MCP (fictional faces, logos added in code) — or pick a concept that needs no photos.
  123. 4. **Let it build.** You get one `index.html`. The agent captures key seconds and checks them against the rules before handing over.
  124. 5. **Review and iterate.** Open it, scrub with `?debug=1`, and describe what feels off. Feedback lands on the same file.
  125. 6. **Deliver.** Keep the HTML, export MP4 with `scripts/export-frames.mjs`, or send a voice-over and the timeline re-times itself to it.
  126. > **Tip:** start each new video in a **new chat**. The skill is read when it is first invoked, and a long chat keeps earlier decisions in context.
  127. ## Example prompts
  128. ```text
  129. Make a 30-second opener for my note-taking app. Logo and screenshots attached.
  130. ```
  131. ```text
  132. Build a 45-second product tour of our HR dashboard in the "product tour with claims" style, 16:9.
  133. ```
  134. ```text
  135. Promo for a ticketing app in the flat pop with photos style — generate fictional people, 9:16, 20 seconds.
  136. ```
  137. ```text
  138. Kinetic typography for our festival announcement: "City of Sound, 3 nights, 48 stages". Loud, color-block.
  139. ```
  140. ```text
  141. Explain how a container port works in 60 seconds, visual journalism style, no voice-over.
  142. ```
  143. ```text
  144. Promo for our editing app with a screen recording playing inside a laptop mockup, 30 seconds. Clip attached.
  145. ```
  146. ```text
  147. A cartoon explainer on why volcanoes erupt, for kids, 9:16, I will send a voice-over later.
  148. ```
  149. **Getting better results**
  150. - Say *which style*, not *which scenes*. "Grainy gradient" gives you the look; listing a reference's scenes gives you a copy.
  151. - Hand over real brand material — logo, site, app screenshots, photos. The palette and shapes are derived from it.
  152. - Want one specific moment? Ask for it explicitly; otherwise the agent composes new ones.
  153. - Keep text short. Openers carry one feeling, explainers one argument.
  154. ## Install
  155. Bang Motion follows the open **Agent Skills** layout: a folder with `SKILL.md` (frontmatter + instructions), `references/`, `assets/`, `scripts/`. It also ships as a Claude Code **plugin**.
  156. ### As a plugin (Claude Code)
  157. ```
  158. /plugin marketplace add bangtutorial/bang-motion
  159. ```
  160. ```
  161. /plugin install bang-motion@bang-motion
  162. ```
  163. Update later with `/plugin marketplace update bang-motion`.
  164. ### Manual (any agent)
  165. ```bash
  166. git clone https://github.com/bangtutorial/bang-motion
  167. ```
  168. | Agent | Where it goes |
  169. |---|---|
  170. | Claude Code | `~/.claude/skills/bang-motion` (Windows: `C:\Users\<you>\.claude\skills\bang-motion`) |
  171. | Codex CLI | your Codex skills folder, or add to `AGENTS.md`: *"For motion graphics / explainers, read and follow `bang-motion/SKILL.md`."* |
  172. | Gemini CLI · Cursor · others | copy into the project and reference `SKILL.md` from `GEMINI.md`, `.cursor/rules`, or the system prompt |
  173. | Plain chat (no agent) | paste `SKILL.md` + the relevant file in `references/` as instructions; attach a starter from `assets/` |
  174. > Install **one copy** only. Two copies with the same skill name (for example a plugin and a manual folder) conflict, and the plugin wins.
  175. The skill triggers on requests like "make an opener…", "promo video…", "explainer…", or a complaint that a web animation "looks like PowerPoint".
  176. ## Requirements
  177. | To… | You need |
  178. |---|---|
  179. | **Watch** the result | a browser + internet (GSAP and fonts load from a CDN). Nothing else. |
  180. | Verify frames automatically | Node + puppeteer (`scripts/snap.mjs`) — optional; `?debug=1` works by hand |
  181. | Export MP4 | Node + puppeteer + ffmpeg (`scripts/export-frames.mjs`) — optional |
  182. | Sync to voice-over | ffmpeg, **or** nothing: `scripts/vo-pauses.html` detects pauses in the browser |
  183. | Use video clips | MP4 (H.264) or WebM files in `assets/` — optional |
  184. | Generate images | any image MCP the agent can call — optional |
  185. | Build in After Effects | After Effects + the Higgsfield MCP bridge — optional |
  186. A deliverable never needs `npm install` to be watched.
  187. ## How the rules work
  188. - **Style brief before code** — concept, structure fingerprint, palette with sources, display font, background surface and motion, render family, transitions, one special moment.
  189. - **Structure from a menu** — three concept candidates per project, at most two "canonical" components, and a different fingerprint from the previous video.
  190. - **Examples are principles, not scripts** — openings and endings differ from the concept's example, signature moments are transformed, and the example's colors and shapes never carry over.
  191. - **Living typography** — sentence case, emphasis by order, size, or pause; word highlights and punctuation only when they add meaning.
  192. - **A background that never sits still** — a chosen background motion, and color changes with a visible trigger.
  193. - **Video as footage layers** — clips follow the timeline clock, so scrubbing and MP4 export stay frame-accurate.
  194. - **A camera that works** — breathing drift, motivated push-throughs, and in UI demos a camera that follows the important clicks.
  195. - **Structural anti-slide checks** — no fading sections, a persistent subject or world, at most two text levels, varied transitions with real depth.
  196. - **Readable on phones** — no text under 30 px on a 1080-wide stage.
  197. Full detail lives in `SKILL.md` and `references/`.
  198. ## Repository layout
  199. ```
  200. SKILL.md rules & workflow (read by the agent)
  201. .claude-plugin/ plugin + marketplace manifests
  202. references/
  203. opener-konsep.md 19 opener concepts, UI animation, photos in openers
  204. anti-ppt.md slide patterns → fixes
  205. techniques.md typography, camera, transitions, backgrounds, render families
  206. explainer.md explainer styles, camera recipes, VO re-timing
  207. kartun-panggung.md cartoon stage explainers
  208. architecture.md stage, camera rig, determinism, export
  209. ae-bridge-higgsfield.md building inside After Effects via the MCP bridge
  210. roadmap.md where the skill is heading
  211. assets/
  212. starter-opener.html opener / promo architecture (GSAP + Three.js)
  213. starter-explainer*.html one starter per explainer style
  214. scripts/
  215. snap.mjs verify: capture key seconds
  216. export-frames.mjs export: frame-by-frame PNG → MP4
  217. vo-pauses.html voice-over pause detection, no ffmpeg needed
  218. serve.py no-cache dev server (optional)
  219. ae/bridge/ After Effects bridge helpers
  220. docs/gallery/ README preview images
  221. ```
  222. ## FAQ
  223. <details>
  224. <summary><b>Is the output a video file?</b></summary>
  225. The deliverable is an `index.html` that plays like a video: autoplay, loop, no player chrome. When you need a file, `scripts/export-frames.mjs` renders it frame by frame to MP4.
  226. </details>
  227. <details>
  228. <summary><b>Will every video end up looking the same?</b></summary>
  229. That is the main thing the skill prevents. The palette and shapes come from your brand, the structure comes from a concept chosen for your product, and each project must differ from the previous one in both skin and structure.
  230. </details>
  231. <details>
  232. <summary><b>Can I give it a reference video?</b></summary>
  233. Yes. The agent takes rhythm, energy, and motion language from it — not the palette, fonts, layout, scene order, or signature moments.
  234. </details>
  235. <details>
  236. <summary><b>Do I need photos?</b></summary>
  237. Only for photo-based styles. Use your own, a licensed stock set, or let the agent generate fictional people and props through an image MCP. Otherwise pick an illustrated or typographic style.
  238. </details>
  239. <details>
  240. <summary><b>Can I use video clips?</b></summary>
  241. Yes. Clips become footage layers: trimmed, masked, graded, and animated with the rest of the scene, always in sync with the timeline — including frame-by-frame MP4 export. Use your own footage, licensed stock, or clips generated through a video MCP.
  242. </details>
  243. <details>
  244. <summary><b>Can it build in After Effects?</b></summary>
  245. Yes, for cartoon explainers: with After Effects open and the Higgsfield MCP bridge connected, the agent builds compositions, characters, and keyframes directly in AE.
  246. </details>
  247. ## Contributing
  248. Issues and pull requests are welcome. When you add a rule, describe which failure it prevents and offer it as a menu option rather than a single "right answer". Bump `version` in `SKILL.md` and the plugin manifests, and add a line to `CHANGELOG.md`.
  249. ## License
  250. [MIT](LICENSE) © 2026 [Bang Tutorial](https://youtube.com/bangtutorial)

Ratings and comments

Sign in to rate this skill.

Sign in

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