Star 历史趋势
数据来源: GitHub API · 生成自 Stargazers.cn
README.md
Bang Motion icon

Bang Motion

An agent skill that turns your AI coding agent into a motion designer.
Openers, promos, product demos, kinetic typography, and explainers — built as a single index.html that plays like video, not like slides.

Version License: MIT Agent Skills Works with

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

What you can make · Style gallery · Workflow · Example prompts · Install · FAQ


Why

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.

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.

What you can make

OutputTypical length
🎬 Openers & promosproduct launches, app promos, campaign spots, teasers15–40 s
🖥️ Product & SaaS demosUI assembled and used on screen, camera following the clicks20–60 s
🔤 Kinetic typographylyric-style statements, event announcements, manifestos10–30 s
📺 Bumpers, idents, channel introsshort brand moments that loop3–10 s
🧭 Explainerssix explainer styles, optional voice-over sync, 16:9 or 9:1630–120 s
🎥 Video layersyour own or generated clips placed like footage — inside devices, frames, and masks, locked to the timeline—
🎞️ After Effects buildscartoon explainers built directly inside AE through the Higgsfield MCP bridge—

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.

Style gallery

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.

Grainy gradient opener
Grainy gradient · opener
Glowing layered shapes, soft grain, a camera that travels through them. Tech, AI, music, premium launches.
Kinetic typography in poster color-block
Poster color-block · kinetic typography
Huge cropped words, solid color fields that slam in on the beat. Events, music, launches.
SaaS product tour
Product tour with claims · SaaS demo
Real UI lifted out of the dashboard, the camera zooms into what gets clicked. SaaS, dashboards, B2B.
Flat vector illustration promo
Flat vector illustration · promo
Solid fills, stylized hands, UI drawn flat, shapes with gentle overshoot. Fintech, consumer apps.
Flat pop with photos promo
Flat pop with photos · promo
Photo cutouts popping in, stickers, brand color fields that change with a visible trigger. Consumer apps, campaigns.
Continuous action explainer
Continuous action · explainer
One subject that never stops, numbers and maps living inside the world. Speed, routes, processes.
Visual journalism explainer
Visual journalism · explainer
Black ground, real photos with source tags, highlighter, dashed annotations. News, current issues.
White catalog explainer
White catalog · explainer
White grid, product cutouts, mixed script and heavy sans. Products, brands.
Vintage sketch explainer
Vintage sketch · explainer
Sepia paper, engraving art, classic serifs, rust notes. History, biography.
Cartoon collage explainer
Cartoon collage · explainer
Cream paper, flat illustration cutouts, color pills, handwriting. Science, education.
Cartoon stage explainer
Cartoon stage · explainer
One living stage per scene, jointed characters, no captions. Education with characters.
Style brief with three concept candidates and one recommended pick
…and many more
10 styles × 19 concepts × 9 render families — three candidates, one pick.

The menus behind the looks

10 style directions — the skin, derived from your brand
DirectionBackgroundTypographySignature motionGood for
Cinematic darknear-black gradient, particles, bloom only on objectsbold clean groteskpush-through, light in front of the lenscreative tools, gaming, tech
Poster color-blocklarge solid color fields changing per sceneultra-heavy display, giant cropped lettersblock wipes, text slamming the frame edgeconsumer apps, music, events
Editorial lightwhite/cream, generous space, hairlinesdisplay serif + small groteskcalm slides, lines that drawproductivity, finance, SaaS
Paper & printpaper texture, collage, stamps, tapehandwriting + serifobjects flying in and landingeducation, community, food
Retro / analogfaded color, grain, scanlines70s–90s geometriccontrolled glitch, rough zoom, freezenostalgia, music, entertainment
Brutalist monoblack and white, hard gridmonospace + condensedhard cuts, shifting blocks, blinking cursordeveloper tools
Pastel playfulstacked pastels, big round shapesheavy rounded sanselastic bounce, blooming shapeskids, health, lifestyle
Luxury darkblack + gold/bronze, soft shadowstall wide-tracked serifslow motion, sweeping light, depthfashion, automotive, property
Flat pop with photosneutral light alternating with solid brand fieldsrounded heavy sans + giant cropped wordscutouts popping in, stickers, fields snapping on the beatconsumer apps, fintech, e-commerce
Grainy gradientdeep base, saturated glowing shapes, fine grainsmall clean grotesk or minimal heavy displaylayers opening, camera through the shape, a guiding orbtech, AI, music, creative launches
19 opener concepts — the structure, chosen per product
#ConceptGood for
1One continuous shotcreative tools, hardware, spaces
2Pure typographystrong taglines, events, releases
3Problem → goneproductivity, utilities
4Before / aftereditors, filters, optimization
5Journey inside the UIapps with a distinctive UI
6Product macrohardware, packaging, F&B, fashion
7Object metaphorsecurity, cloud, finance
8Living numbermilestones, performance
9One feature, fully demoedapps with one clear edge
10Diegetic question → answerAI, search, support
11Rhythmic collagemusic, lifestyle, community
12Logo as stagebrands with a strong logo shape
13Object relaye-commerce, delivery, marketplaces
14Brand system showcaselaunches, rebrands, communities
15Claim → how → resultnew features, generative AI, creative tools
16Living UI ecosystemB2B SaaS, AI assistants, workflows
17Flat pop with photosconsumer apps, fintech, campaigns
18Through the gradient shapestech, AI, security, premium launches
19Product tour with claimsSaaS, team tools, dashboards

Each concept ships as principles and a menu of openings, transitions, and endings — never as a script to copy.

6 explainer styles — each with its own starter
StyleLookBest for
Continuous actionflowing vector world, one subject that never leaves, changing viewpointsspeed, routes, processes
Cartoon collagecream paper, flat illustration cutouts, handwriting, color pillsscience, education
Visual journalismblack, real photos with source tags, highlighter, dashed annotationsnews, current issues
White catalogwhite grid, photo cutouts, mixed typography, scribblesproducts, brands
Vintage sketchsepia paper, engraving art, classic serifs, rust annotationshistory, biography
Cartoon stageone stage per scene, jointed characters, no captionseducation with characters

Recommended workflow

flowchart LR
  A[Brief<br>product, logo, audience,<br>length, ratio] --> B[Style brief<br>3 concept candidates,<br>palette with sources]
  B --> C{You approve}
  C --> D[Assets<br>your photos & logo<br>or generated via MCP]
  D --> E[Build<br>index.html]
  E --> F[Verify frames<br>snap.mjs / ?debug=1]
  F --> G[Your feedback]
  G --> E
  G --> H[Deliver<br>HTML · MP4 · voice-over sync]
  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.
  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.
  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.
  4. Let it build. You get one index.html. The agent captures key seconds and checks them against the rules before handing over.
  5. Review and iterate. Open it, scrub with ?debug=1, and describe what feels off. Feedback lands on the same file.
  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.

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.

Example prompts

Make a 30-second opener for my note-taking app. Logo and screenshots attached.
Build a 45-second product tour of our HR dashboard in the "product tour with claims" style, 16:9.
Promo for a ticketing app in the flat pop with photos style — generate fictional people, 9:16, 20 seconds.
Kinetic typography for our festival announcement: "City of Sound, 3 nights, 48 stages". Loud, color-block.
Explain how a container port works in 60 seconds, visual journalism style, no voice-over.
Promo for our editing app with a screen recording playing inside a laptop mockup, 30 seconds. Clip attached.
A cartoon explainer on why volcanoes erupt, for kids, 9:16, I will send a voice-over later.

Getting better results

  • Say which style, not which scenes. "Grainy gradient" gives you the look; listing a reference's scenes gives you a copy.
  • Hand over real brand material — logo, site, app screenshots, photos. The palette and shapes are derived from it.
  • Want one specific moment? Ask for it explicitly; otherwise the agent composes new ones.
  • Keep text short. Openers carry one feeling, explainers one argument.

Install

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
AgentWhere it goes
Claude Code~/.claude/skills/bang-motion (Windows: C:\Users\<you>\.claude\skills\bang-motion)
Codex CLIyour Codex skills folder, or add to AGENTS.md: "For motion graphics / explainers, read and follow bang-motion/SKILL.md."
Gemini CLI · Cursor · otherscopy 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".

Requirements

To…You need
Watch the resulta browser + internet (GSAP and fonts load from a CDN). Nothing else.
Verify frames automaticallyNode + puppeteer (scripts/snap.mjs) — optional; ?debug=1 works by hand
Export MP4Node + puppeteer + ffmpeg (scripts/export-frames.mjs) — optional
Sync to voice-overffmpeg, or nothing: scripts/vo-pauses.html detects pauses in the browser
Use video clipsMP4 (H.264) or WebM files in assets/ — optional
Generate imagesany image MCP the agent can call — optional
Build in After EffectsAfter Effects + the Higgsfield MCP bridge — optional

A deliverable never needs npm install to be watched.

How the rules work

  • Style brief before code — concept, structure fingerprint, palette with sources, display font, background surface and motion, render family, transitions, one special moment.
  • Structure from a menu — three concept candidates per project, at most two "canonical" components, and a different fingerprint from the previous video.
  • 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.
  • Living typography — sentence case, emphasis by order, size, or pause; word highlights and punctuation only when they add meaning.
  • A background that never sits still — a chosen background motion, and color changes with a visible trigger.
  • Video as footage layers — clips follow the timeline clock, so scrubbing and MP4 export stay frame-accurate.
  • A camera that works — breathing drift, motivated push-throughs, and in UI demos a camera that follows the important clicks.
  • Structural anti-slide checks — no fading sections, a persistent subject or world, at most two text levels, varied transitions with real depth.
  • Readable on phones — no text under 30 px on a 1080-wide stage.

Full detail lives in SKILL.md and references/.

Repository layout

SKILL.md                         rules & workflow (read by the agent)
.claude-plugin/                  plugin + marketplace manifests
references/
  opener-konsep.md               19 opener concepts, UI animation, photos in openers
  anti-ppt.md                    slide patterns → fixes
  techniques.md                  typography, camera, transitions, backgrounds, render families
  explainer.md                   explainer styles, camera recipes, VO re-timing
  kartun-panggung.md             cartoon stage explainers
  architecture.md                stage, camera rig, determinism, export
  ae-bridge-higgsfield.md        building inside After Effects via the MCP bridge
  roadmap.md                     where the skill is heading
assets/
  starter-opener.html            opener / promo architecture (GSAP + Three.js)
  starter-explainer*.html        one starter per explainer style
scripts/
  snap.mjs                       verify: capture key seconds
  export-frames.mjs              export: frame-by-frame PNG → MP4
  vo-pauses.html                 voice-over pause detection, no ffmpeg needed
  serve.py                       no-cache dev server (optional)
  ae/bridge/                     After Effects bridge helpers
docs/gallery/                    README preview images

FAQ

Is the output a video file?

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.

Will every video end up looking the same?

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.

Can I give it a reference video?

Yes. The agent takes rhythm, energy, and motion language from it — not the palette, fonts, layout, scene order, or signature moments.

Do I need photos?

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.

Can I use video clips?

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.

Can it build in After Effects?

Yes, for cartoon explainers: with After Effects open and the Higgsfield MCP bridge connected, the agent builds compositions, characters, and keyframes directly in AE.

Contributing

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.

License

MIT © 2026 Bang Tutorial

关于 About

Agent skill for browser motion graphics — openers, promos, bumpers, kinetic typography, and five explainer styles that move like video, not slides. Single index.html output. Works with Claude Code, Codex, Gemini CLI, Cursor.

语言 Languages

HTML85.1%
Python10.9%
JavaScript4.0%

提交活跃度 Commit Activity

代码提交热力图
过去 52 周的开发活跃度
3
Total Commits
峰值: 3次/周
Less
More

核心贡献者 Contributors