bang-motion — Claude Code skill: what it does, how to install
bang-motion is a Claude Code skill for cinematic browser animation. It activates for promo videos, animated openers, explainers, and requests to export web animation as MP4.
MIT 579 installs ★ 2,890 updated 2026-09-15
npx skills add bangtutorial/bang-motion --skill bang-motion -a claude-codeWhat bang-motion does
bang-motion provides rules and techniques for building motion graphics with HTML, CSS, and GSAP; Three.js is an option when needed. It guides the agent toward scenes connected by camera movement and a shared visual world, rather than a sequence of fading slides. Requests for kinetic typography, animated intros, and visual explainers can trigger it too.
The finished index.html runs in a modern browser, and internet access is needed to load GSAP and fonts from CDNs. Python and Node are only for supporting scripts; frame-by-frame MP4 export uses Node, while producing an MP4 also requires FFmpeg. Voice-over timing has a browser-based route in scripts/vo-pauses.html that does not use FFmpeg.
What it helps with
- build a browser-based promo video or animated opener
- create an explainer with kinetic type and camera movement
- replace web animation that feels like a slide deck
- prepare browser animation for MP4 export
Example prompts for the agent
- Create a cinematic browser promo for this project.
- Make an animated explainer with kinetic typography, not a slide deck.
- Prepare this web animation for MP4 export.
How to install bang-motion
1Skills CLI (Vercel)
npx skills add bangtutorial/bang-motion --skill bang-motion -a claude-code2Manually: put the files in place
~/.claude/skills/bang-motion/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/bang-motion/
1Skills CLI (Vercel)
npx skills add bangtutorial/bang-motion --skill bang-motion -a codex2Manually: put the files in place
.agents/skills/bang-motion/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add bangtutorial/bang-motion --skill bang-motion -a cursor2Manually: put the files in place
.cursor/skills/bang-motion/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install bangtutorial/bang-motion bang-motion2Manually: put the files in place
.github/skills/bang-motion/SKILL.md1Skills CLI (Vercel)
npx skills add bangtutorial/bang-motion --skill bang-motion -a gemini-cli2Platform CLI
gemini skills install https://github.com/bangtutorial/bang-motionManually: put the files in place
.devin/skills/bang-motion/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add bangtutorial/bang-motion --skill bang-motion -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about bang-motion
How do I install bang-motion in Claude Code?
Run npx skills add bangtutorial/bang-motion --skill bang-motion -a claude-code. The skill file is at ~/.claude/skills/bang-motion/SKILL.md.
What does bang-motion do?
It guides an agent through making cinematic browser motion graphics with HTML, CSS, and GSAP. Its techniques focus on connected scenes and camera movement rather than slide-style transitions.
What does bang-motion need to run?
The output needs a modern browser and internet access for CDN-hosted GSAP and fonts. Python and Node are only used by helper tools; Node is used for frame export, and FFmpeg is required to produce an MP4.
Source text
SKILL.md · MIT
---
name: bang-motion
description: Membangun motion graphic sinematik di browser (promo video, opener, intro, bumper, kinetic typography, explainer/video penjelasan bergambar 16:9 atau 9:16) memakai HTML + CSS + GSAP (+ Three.js bila perlu), dengan hasil yang bergerak seperti video sungguhan — bukan slide presentasi. Gunakan skill ini setiap kali user meminta "video promo", "opener", "intro animasi", "motion graphic", "bumper", "kinetic typography", "animasi teks sinematik", "explainer", "video penjelasan" (jurnalisme visual, kartun edukasi, kolase), atau menunjukkan referensi video promosi/explainer dan ingin dibuatkan versi web-nya — bahkan bila mereka tidak menyebut kata "motion graphic" secara eksplisit. Juga gunakan bila user mengeluh hasil animasi web "seperti PPT/presentasi" dan ingin lebih sinematik, atau ingin merender animasi web menjadi file video MP4, atau ingin explainer kartun/animasi dibangun LANGSUNG di After Effects lewat bridge/MCP Higgsfield.
license: MIT
metadata:
author: Bang Tutorial
author_url: https://youtube.com/bangtutorial
version: "1.19.0"
updated: "2026-09-14"
homepage: https://github.com/bangtutorial/bang-motion
---
# Bang Motion — motion graphic web yang bukan PPT
**v1.19.0 · by [Bang Tutorial](https://youtube.com/bangtutorial) · MIT.** Riwayat perubahan di `CHANGELOG.md`;
cara pasang di `README.md`.
Skill ini untuk AI coding agent apa pun (format Agent Skills terbuka).
Isinya hukum dan resep untuk motion graphic yang bergerak seperti video, bukan
presentasi — patuhi sebelum menulis kode.
## Prasyarat — hanya browser
Deliverable (`index.html`) hanya butuh browser modern + internet untuk CDN
(GSAP, font). Python dan Node **opsional**, dipakai hanya untuk alat kerja:
`scripts/serve.py` (server no-cache, cuma perlu bila memakai module lokal),
puppeteer (snapshot/verifikasi otomatis, `scripts/export-frames.mjs` → MP4).
Kalau user tidak punya keduanya: (1) tetap bangun satu-berkas, buka lewat
klik dua kali; (2) verifikasi visual lewat `?debug=1` (panel scrub) dan
screenshot manual per detik kunci; (3) MP4 lewat rekam layar (OBS / rekam
tab browser) — jelaskan bahwa hasil rekam layar bisa drop frame, dan render
frame-by-frame butuh Node. Jangan pernah membuat deliverable yang butuh
`npm install` untuk DITONTON.
**ffmpeg juga opsional.** Cek dulu (`ffmpeg -version`); bila tidak ada:
| Kebutuhan | Dengan ffmpeg | Tanpa ffmpeg |
|---|---|---|
| Sinkron VO (batas kalimat/paragraf) | `silencedetect` | `scripts/vo-pauses.html` — buka di browser, pilih audio, salin `SEG`/`PARA`; hasilnya sama persis (Web Audio, tanpa instal) |
| Durasi/format audio | `ffprobe` | angka `DUR` dari vo-pauses.html; browser memutar wav/mp3/m4a/ogg langsung |
| Export MP4 | gabung PNG dari export-frames.mjs | tidak ada MP4 — tawarkan instal satu perintah (`winget install Gyan.FFmpeg` / `brew install ffmpeg`) atau rekam layar |
| Mempelajari video referensi (ekstrak frame) | `fps=` + `tile=` | minta user mengirim screenshot di detik kunci, atau buka videonya di browser dan potret pada detik tertentu |
Tanpa ffmpeg alur explainer tetap lengkap sampai sinkron VO; hanya MP4 yang
butuh instalasi.
## Player — tidak ada, autoplay, loop
Default deliverable: **tanpa panel/player apa pun di layar**, langsung
memutar saat dibuka, dan mengulang dari awal saat selesai (`onComplete →
play(0)`; bila ada suara, audio ikut diulang). Kontrol tersembunyi: R ulang,
Space jeda. Panel scrub/jam hanya muncul dengan `?debug=1` (alat review),
dan `?clean=1` menahan autoplay untuk export. Ada suara? Coba `play()`
langsung; bila diblokir browser, tahan di frame 0 dan mulai pada klik
pertama — tanpa teks "ketuk untuk mulai". Ini sudah tertanam di kedua
starter.
## Larangan struktural — uji PPT yang bisa diperiksa mekanis
Model lain (dan kamu, bila lelah) akan jatuh ke pola ini walau sudah membaca
hukum di bawah. Sebelum menyerahkan, cek KODE, bukan perasaan:
1. `grep -c "class=\"scene\"\|<section" index.html` — bila ≥ 3 adegan
berupa `<section>` yang dinyalakan-dimatikan dengan `autoAlpha`/opacity
→ itu slide deck. Adegan harus berganti karena DUNIA/KAMERA bergerak
(kamera bergerak, whip ke sudut lain, push-through, latar berganti),
bukan karena section di-fade. Pengecualian yang sah: **kartun panggung**
(`references/kartun-panggung.md`) memakai cut/geser 96 px antar panggung
— boleh, karena tiap panggung hidup penuh (≥10 benda beraksi), bukan
gambar diam yang di-fade.
2. Ada benang merah visual yang bertahan: satu subjek (aksi kontinu) ATAU
satu dunia kolase/kertas/putih yang disusuri kamera (kartun, foto,
katalog, sketsa). Foto full-bleed berganti-ganti tanpa dunia bersama →
PPT. Satu gambar + satu kalimat per adegan, berganti tiap adegan →
tetap slideshow walau kameranya bergerak: tiap adegan 3–5 elemen yang
masuk bertahap per frasa (explainer.md "Satu adegan = 3–5 elemen").
3. Per adegan hitung node teks: eyebrow/kicker + judul + body/kredit = 3
tingkat → PPT. Maksimum dua: satu angka/kalimat besar + satu label dunia.
Dokumen/stempel/blok tanggal berisi ≤ 3 baris pendek dihitung objek,
bukan tingkat teks.
4. Ken Burns (scale 1.0→1.05 pada foto) sebagai satu-satunya gerak → PPT.
Gerak tiap detik harus datang dari BAHASA GERAK LATAR yang dipilih di
style brief dari menu `techniques.md` §7c (kamera bernapas di latar
bertekstur, gradien berpindah, blob mengambang, grain hidup, sapuan
cahaya per segmen, bentuk besar berputar lambat, partikel naik, grid
bernapas, teks hantu bergeser, Ken Burns + parallax…). Batang/garis/
potongan yang melintas ke samping ("lane", "range", "streak", hujan
partikel horizontal) SUDAH dipakai dua proyek berturut-turut dengan nama
berbeda — itu bukan default; hanya bila tema memang kecepatan/aliran,
dan tidak boleh dua proyek berturut-turut.
5. Transisi hanya fade + scale bump + light leak di semua cut → template PPT.
Whip ke sudut lain, cut ke instrumen (peta/speedometer/profil), push-through.
6. Explainer dimulai dari starter GAYANYA: `starter-explainer-kartun`,
`-jurnalisme`, `-katalog`, `-sketsa` (mode kolase: kamera menyusuri aset
diam), `starter-explainer` (aksi kontinu: dunia mengalir), atau
`starter-explainer-panggung` (kartun panggung: satu panggung per adegan,
rig sendi, kamera hanya di dalam panggung). Yang kolase satu rig; yang
panggung rignya lain. BUKAN dari `assets/starter-opener.html`
(opener teks), dan bukan dari nol.
7. **Miniatur adalah slide.** Kamera zoom < 1,08 sehingga rumah sebesar ibu
jari dan tanah kosong mengisi separuh layar → PPT walau semua bergerak.
Dunia dipecah jadi panggung seukuran frame, bukan satu peta besar yang
dijelajahi (`kartun-panggung.md` Hukum 1).
8. **Kerangka template (opener/promo).** Cek rundown dan kode: adegan pertama
berupa teks yang diperbesar lalu keluar ke kiri; tiga tile/kartu fitur
sejajar; kotak input/searchbar yang diketik; urutan hook → fitur → fitur →
janji → logo → CTA. Dua atau lebih tanpa tuntutan konsep → template, walau
kulitnya baru. Pilih ulang kerangka dari `references/opener-konsep.md`.
Gagal satu poin saja → rombak sebelum ditunjukkan ke user.
## Jenis pekerjaan yang dicakup
Skill ini untuk motion graphic web secara UMUM. Explainer hanya salah satu
jenis — ia punya dokumen sendiri karena strukturnya beda, bukan karena ia
yang utama.
Starter dinamai menurut kategorinya: `starter-opener.html` untuk opener, promo,
bumper, intro, dan kinetic typography; `starter-explainer-*.html` untuk explainer,
dengan akhiran mode/gaya (`-kartun`, `-jurnalisme`, `-katalog`, `-sketsa` = kolase;
tanpa akhiran = aksi kontinu; `-panggung` = kartun panggung). Kartun panggung adalah
mode explainer (gaya 6), bukan kategori sendiri: tujuannya tetap menjelaskan dengan
VO, yang berbeda hanya cara produksinya.
| Jenis | Durasi lazim | Ciri | Resep |
|---|---|---|---|
| Opener / promo produk | 25–40 dtk | satu konsep dari menu (kerangka lahir dari produk, bukan urutan baku), satu momen istimewa, penutup brand | `references/opener-konsep.md` + alur kerja di bawah + `references/techniques.md` |
| Bumper / ident / logo sting | 3–8 dtk | logo build-on, satu gerak tanda tangan, selesai sebelum penonton sadar | `techniques.md` (logo build-on, light leak) |
| Intro / outro kanal | 5–12 dtk | nama kanal + tanda tangan gerak yang sama tiap episode | alur kerja di bawah |
| Kinetic typography / lirik | 15–60 dtk | teks adalah subjek; split per kata/huruf; ritme mengikuti audio | `techniques.md` (split + blur berarah, pan 3D per kata) |
| Title / lower third / bumper segmen | 2–6 dtk | elemen kecil di atas footage, masuk-keluar bersih, latar transparan | `techniques.md` |
| Explainer / video penjelasan | 30–90 dtk | fakta bersumber, entitas tampil, sudut pandang berganti, lima gaya | `references/explainer.md` + starter per gaya |
## Explainer dan karakter: baca sebelum menentukan shot
Untuk explainer kartun edukasi flat berkarakter (gaya keenam, **kartun
panggung**), atau revisi yang terasa seperti slideshow/miniatur, baca
`references/kartun-panggung.md`: satu panggung per adegan, zoom 1,08–1,95,
kontinu di dalam panggung dan cut/geser 96 px di antaranya, rig sendi dengan
transform manual, nol caption, palet flat cerah. Bedakan kalimat, beat visual,
framing, dan pergantian panggung. Untuk membangunnya langsung di After Effects, baca
`references/ae-bridge-higgsfield.md`. Pedoman khusus explainer ini memperjelas
aturan opener di bawah; contoh font, jumlah scene, dan efek bukan resep universal.
## Hukum #1 — Ini video, bukan slide
Penyakit paling umum: model menyusun adegan seperti slide — judul + sub-judul
+ body copy + deretan badge. Itu langsung terbaca "PPT" dan akan ditolak.
Aturan kerasnya:
- **Untuk opener: satu kalimat pendek + maksimal satu objek utama per adegan.** Tidak ada
kicker ("01 — FITUR"), sub-judul, paragraf keterangan, chip/badge fitur,
atau metadata teknis (nama package, URL panjang). Chip, tombol, dan label yang
merupakan bagian UI produk yang sedang dipakai tidak termasuk.
- **Informasi baru = respons visual baru.** Pada explainer, ubah keadaan/aksi
di dunia yang sama bila masih berhubungan; pergantian kalimat tidak wajib mengganti shot.
- **Daftar poin diganti visual, bukan otomatis tiga tile.** Pilih cara dari
menu fitur di `references/opener-konsep.md` (satu fitur didemokan, kata
berganti, objek bertransformasi, kartu dikocok, grid tile…); dua opener
berturut-turut tidak memakai cara yang sama.
- **Adegan harus hidup.** Kamera boleh menetap saat objek membawa aksi.
Gerakkan kamera untuk mengikuti atau mengungkap sesuatu; jangan mengandalkan
teks fade/slide di atas latar diam, atau pan/zoom berulang di semua segmen.
- **"Zoom in-out" = ukuran shot, bukan napas kamera.** Bila video terasa statis atau
user meminta zoom, kamera mendekat ke elemen yang sedang bercerita (medium close-up
/ close-up) lalu mundur ke wide mengikuti ketukan isi; napas beberapa persen hampir
tak terlihat (`techniques.md` §3b).
Baca `references/anti-ppt.md` SEBELUM mendesain adegan — berisi daftar
pelanggaran nyata beserta perbaikannya.
## Hukum #2 — Deterministik atau mati
Tidak ada satu baris pun yang membaca jam sistem. Semua visual adalah fungsi
murni dari `tl.time()` (waktu timeline GSAP): spektrum, angka berjalan,
partikel, getar kamera (sinus frekuensi tinggi, bukan `Math.random()`),
posisi objek yang "mengalir" (tween JARAK, bukan akumulasi kecepatan per
frame). Konsekuensinya: scrub akurat seperti timeline After Effects, dan
render frame-by-frame ke MP4 menghasilkan gambar identik setiap kali.
## Hukum #3 — Gaya lahir dari tema, bukan dari starter, bukan dari referensi
Kegagalan yang umum: opener untuk produk lain keluar dengan kulit PERSIS
opener produk sebelumnya — gelap, aksen biru, glow, nebula, font yang sama —
karena model mengambil gayanya dari starter. Animasinya bisa bagus, tetap
gagal: opener adalah wajah produk, dan dua produk tidak boleh berwajah sama.
1. **Style brief dulu, kode belakangan.** Sebelum menyentuh starter, tulis
enam baris ini dan tunjukkan ke user bersama rundown adegan:
- tema/produk + tiga kata sifat perasaan yang ingin ditinggalkan;
- **konsep & sidik jari struktur** (opener/promo): tiga kandidat konsep dari
`references/opener-konsep.md`, satu dipilih dengan alasan dari produk, lalu
`konsep · jumlah adegan · objek utama tiap adegan · pembuka · penutup`;
- palet: satu warna utama DARI brand/tema (logo, ikon aplikasi, situs,
kemasan), satu warna latar, satu aksen — sebutkan hex DAN sumber tiap
warna; warna yang bukan dari brand ditulis "turunan: alasan";
- font display yang punya karakter sesuai perasaan itu (bukan
Poppins/Inter/Roboto/Montserrat/Arial) + font pendamping; pengecualian:
konsep klaim → cara → hasil memakai font UI produk sendiri
(`references/opener-konsep.md`);
- penekanan teks: tanpa sorotan kata, atau satu bentuk sorotan (sebutkan) —
sorotan kata OPSIONAL, bukan bawaan setiap opener;
- bahasa latar per segmen: satu arah dari tabel "Arah gaya" untuk semua,
atau rencana pergantian (segmen mana ganti, ke apa, kenapa, dipicu apa);
- tanda tangan gerak: satu jenis gerak yang diulang sebagai identitas
(wipe objek, roll 3D per kata, kertas terbang, garis yang menggambar,
blok warna menabrak tepi…);
- gerak latar: satu bahasa dari menu `techniques.md` §7c — bukan hal yang
sama dengan tanda tangan gerak, dan bukan otomatis "benda melintas";
- permukaan latar: dari menu §7d (gradien/cahaya/tekstur/grainy gradient,
≥ 2 lapis) — bukan flat;
- gaya render objek: satu keluarga dari menu `techniques.md` §7e (flat, clay,
glossy, kaca, isometrik, realistis, garis neon…);
- aset foto (bila konsep memakai foto orang/tempat/produk): sumbernya — foto
user, generate lewat MCP Higgsfield, atau stok berlisensi — DITANYAKAN ke
user, plus daftar shot per babak (`references/opener-konsep.md` "Foto dalam
opener");
- transisi: tentukan batas mana yang memerlukan efek dan mana yang cukup cut;
pilih dari menu §4c sesuai konteks, bukan wajib dua jenis atau wajib 3D;
- satu momen istimewa (di mana efek termahal dipakai, sekali).
2. **Starter adalah arsitektur, bukan gaya.** Warna abu-abu, font sistem,
dan latar WebGL di `assets/starter-opener.html` adalah PLACEHOLDER. Kalau salah
satunya masih terlihat di hasil, gaya belum diturunkan. Latar WebGL
(nebula, debu, grid, bloom) hanya satu bahasa latar dari delapan;
matikan bila arah gayanya lain.
3. **Referensi = ritme, bukan kulit.** Dari video referensi ambil: durasi per
shot, jenis transisi, hierarki atensi, energi, bahasa gerak. JANGAN ambil:
palet, font, tekstur, tata letak, bentuk ornamen, kalimat, urutan adegan,
dan momen unik (pembuka/penutup khas, gimmick satu kali). "Buatkan
seperti ini" berarti "seenergik ini", bukan "berwarna seperti ini";
"pakai style X" berarti kulit dan bahasa gerak X, bukan adegan X. Contoh
urutan di `references/opener-konsep.md` diperlakukan sama: prinsip, bukan
naskah (Hukum kerangka #7).
Menjiplak kulit referensi = pelanggaran, walau user yang menyodorkannya —
sebutkan itu satu kalimat lalu tawarkan versi yang lahir dari tema.
4. **Berbeda dari proyek sebelumnya — kulit DAN kerangka.** Dua produk berbeda harus berbeda di
minimal tiga dari empat: palet, font, bahasa latar, tanda tangan gerak —
termasuk bentuk sorotan kata bila dipakai (pill + bintang milik satu
proyek tidak boleh muncul lagi di proyek lain). Kerangkanya juga: konsep
berbeda, atau ≥ 3 dari 5 elemen sidik jari struktur berbeda
(`references/opener-konsep.md`). Warna baru di atas urutan adegan lama
tetap template.
Jangan membuka folder proyek lama untuk "contoh" — yang boleh diwarisi
hanya aturan di skill ini.
5. **Latar tidak default gelap.** Tanpa aturan ini semua opener cenderung
keluar gelap dengan nebula karena starter dan contoh-contohnya gelap. Latar mengikuti
tema: gradien terang, warna lembut, blok warna, kertas, foto, atau gelap
— tabel "Arah gaya" punya sepuluh pilihan dan sebagian besar tidak gelap.
Contoh-contoh di skill ini (kertas terang, nebula) hanya contoh, bukan
templat yang dikunci.
**Latar tidak pernah statis.** Selalu ada gerak latar (§7c), dan warna
latar BOLEH berganti kapan pun dibutuhkan: mood/topik segmen berubah
(masuk ke produk, masalah → solusi, klaim → CTA), brand warna-warni
menuntut ritme warna, atau aksi di layar memang mengubahnya (toggle
dinyalakan, benda menutup lensa, ikon membesar memenuhi frame). Yang
dijaga hanya dua: pergantian punya pemicu yang terlihat (wipe, benda, aksi
UI, push ke bidang warna, cut di ketukan) — bukan cross-fade tanpa sebab
yang terasa "ganti slide" — dan latar tidak dibiarkan satu warna diam
hanya karena tidak pernah dipertimbangkan. Rencananya ditulis di style brief.
6. **Bebas berekspresi.** Hukum-hukum di sini mengunci STRUKTUR (bukan
slide), KONTRAS (teks terbaca), dan KEBARUAN (tidak mengulang proyek
lain) — bukan ekspresi. Gradien kaya, cahaya, 3D, kedalaman, tekstur,
warna berani dianjurkan bila cocok dengan tema. Yang dilarang hanya
mengambil default termurah dan mengulanginya: balok datar menyapu, garis
melintas, latar flat, kulit proyek lain. Kalau dua pilihan sama-sama
memenuhi hukum, pilih yang lebih berani.
7. **Yang boleh sama di semua pekerjaan:** hukum anti-PPT, rig kamera,
determinisme, ritme masuk-keluar asimetris, ukuran teks minimum.
### Arah gaya (pilih satu; boleh memadukan dua dengan sadar)
| Arah | Latar | Tipografi | Gerak khas | Cocok untuk |
|---|---|---|---|---|
| Sinematik gelap | gradasi nyaris hitam, partikel/nebula WebGL, bloom hanya di objek | grotesk tebal bersih | push-through, cahaya di depan lensa | alat kreatif, gaming, teknologi |
| Poster color-block | bidang warna solid besar berganti tiap adegan, tanpa gradasi | display sangat tebal, huruf raksasa terpotong tepi | wipe blok, teks menabrak tepi frame | app konsumen, musik, event |
| Editorial terang | putih/krem, ruang kosong luas, garis tipis | serif display + grotesk kecil | geser halus, garis menggambar, kamera tenang | produktivitas, finansial, SaaS |
| Kertas & cetak | tekstur kertas, potongan kolase, stempel, selotip | tulisan tangan + serif | benda terbang lalu mendarat, sudut miring | edukasi, komunitas, kuliner |
| Retro / analog | warna pudar, grain, garis scan, bingkai VHS | geometris 70–90-an | glitch terkendali, zoom kasar, freeze | nostalgia, musik, hiburan |
| Brutalis mono | hitam-putih, grid keras, kotak bergaris | monospace + kondensasi | cut keras, blok bergeser, kursor berkedip | developer tools, teknis |
| Pastel ceria | pastel bertumpuk, bentuk bulat besar | rounded sans tebal | mantul elastis, bentuk mekar | anak, kesehatan, lifestyle |
| Mewah gelap | hitam + emas/perunggu, bayangan lembut, kilau | serif tinggi berspasi lebar | gerak lambat, sinar menyapu, kedalaman | fashion, otomotif, properti |
| Flat pop berfoto | netral terang bergantian dengan medan warna brand user yang solid; bentuk flat dan stiker turunan geometri logo user + ilustrasi 3D lembut | sans geometris membulat tebal + kata raksasa terpotong tepi | foto orang potongan pop dari bawah, stiker meletup elastis, medan warna menyapu/snap di ketukan | app konsumen, fintech, e-commerce, brand anak muda |
| Grainy gradient | dasar gelap/warna dalam; bentuk bergradien jenuh 2–3 warna yang bercahaya dari dalam; butiran halus di seluruh frame | grotesk bersih kecil, atau display tebal minimal | lapisan bentuk membuka/berputar pelan, kamera menembus lubang bentuk, bola cahaya pemandu | tech, AI, musik, fintech, peluncuran kreatif |
Dua opener berturut-turut memakai baris tabel yang sama = tanda bahaya;
pilih baris lain atau padukan dua baris dengan cara yang belum dipakai.
## Hukum #4 — Teks hidup, latar tunduk
Dua opener dengan rig yang sama bisa berakhir sangat baik atau sangat buruk
hanya karena tipografi dan kontrasnya. Yang buruk: setiap judul KAPITAL
SEMUA bobot 800 di tengah, masuk dengan cara yang sama, di atas ladang cahaya
putih yang lebih terang daripada hurufnya. Yang baik: sentence case bobot
500, penekanan pada kata kunci (mis. pill + bintang — itu tanda tangan
satu proyek, bukan aturan; sorotan kata sendiri opsional), tanda baca
hanya bila perlu, ukuran/arah/
posisi bergantian, latar tenang di bawah teks, latar berganti mengikuti
segmen. Resep lengkap dengan kode: `techniques.md`
bagian 1 dan 1b. Ringkasnya:
- Sentence case bobot 500–600. Kapital-tebal hanya untuk satu adegan penekanan.
- Judul, klaim, dan frase pendek DEFAULT TANPA TITIK — terutama frase ≤ 4 kata
dan kalimat satu baris. Tanda baca hanya bila mengubah arti atau irama: `?`
untuk pertanyaan sungguhan, titik untuk gaya dua kalimat pendek berturut-turut
yang disengaja, `!` sangat jarang. Gaya tanda baca diputuskan sekali di style
brief dan konsisten; bila dipakai, ia elemen terpisah yang muncul terakhir.
- Sorotan kata (pill, garis bawah, marker, kotak, warna, coret) OPSIONAL dan
diputuskan di style brief. Tanpa sorotan pun kalimat tetap punya penekanan:
kata per kata dari redup ke penuh, ukuran/bobot, jeda, atau objek (ikon,
UI) yang berdiri di samping kata. Bila dipakai: satu bentuk per video,
tidak wajib di setiap kalimat, berbeda dari proyek lain; ornamen hanya bila
diturunkan dari bentuk brand.
- Dua adegan berturut-turut tidak boleh sama dalam ukuran, arah masuk, dan
posisi teks.
- Di KANTONG TEKS (bukan seluruh frame), latar harus GELAP (≤ 25 %
luminance) atau TERANG (≥ 80 %), tidak pernah "ramai sedang". Di luar
kantong, latar justru harus kaya: gradien, cahaya, tekstur (§7d) — flat
satu warna ditolak. Elemen latar apa pun (partikel, bentuk,
tekstur, garis): warna dari sisi gelap palet, opacity ≤ .35 di kantong
teks, ≤ 40 elemen terang terlihat.
- Pertimbangkan selang-seling gelap–terang bila segmennya memang berganti
mood; bukan kewajiban mekanis.
## Alur kerja
0. **Kenali jenisnya** (tabel "Jenis pekerjaan"). Explainer → buka
`references/explainer.md` dan ikuti "Langkah nol" di sana: SATU
pertanyaan berisi gaya (lima pilihan + rekomendasi), rasio, durasi,
suara, plus pagar durasi. Jenis lain → lanjut; tanya hanya hal yang
benar-benar tidak bisa diturunkan dari brief (rasio, durasi, ada
musik/VO atau tidak), dalam satu pertanyaan.
0b. **Tulis style brief** (Hukum #3) dan tunjukkan bersama rundown. Tanpa
style brief yang disetujui, jangan menyentuh kode.
1. **Serap referensi & sumber brand.** Minta screenshot/potongan video
referensi bila ada; petakan per shot (durasi, gerakan, jenis transisi,
urutan atensi) — hanya RITMENYA, bukan kulitnya (Hukum #3). Warna, logo
(path vektor ASLI, jangan digambar ulang), font, dan klaim fitur diambil
dari sumber resmi PRODUK yang sedang dibuat — bukan dari referensi, bukan
dari proyek lain, bukan karangan.
2. **Tulis rundown dari konsep yang dipilih** — tabel `detik | adegan |
kalimat | visual`. Jumlah dan jenis adegan mengikuti konsep
(`references/opener-konsep.md`), bukan pola hook → fitur → fitur → janji →
logo → CTA. Total 25–40 detik. Minta persetujuan user atas rundown ini
sebelum menulis kode; merombak rundown murah, merombak kode mahal.
3. **Scaffold arsitektur.** Opener/promo/bumper/typography: salin
`assets/starter-opener.html` (stage 1920×1080, rig kamera `#world`, scene
Three.js ber-state, helper timeline) lalu SEGERA ganti token warna, font,
dan bahasa latarnya sesuai style brief — starter sengaja abu-abu. Explainer: salin starter sesuai gaya —
`starter-explainer-kartun/-jurnalisme/-katalog/-sketsa.html` (mode
kolase: kamera into/settle/look/home di atas cutout/foto, say/unsay per
kata, draw anotasi, push-through antar adegan) atau
`starter-explainer.html` (aksi kontinu: dunia mengalir, hero, objek
dunia, view peta, whip). Semua sudah autoplay + loop tanpa player. Struktur multi-file dan
penjelasan tiap keputusan ada di `references/architecture.md`.
4. **Bangun adegan satu per satu** dengan resep di
`references/techniques.md` (split per huruf + motion blur berarah,
pan 3D per kata, menu transisi, mockup UI). Resep adalah perkakas, bukan
daftar belanja: pakai hanya yang dituntut konsep.
5. **Verifikasi VISUAL, bukan cuma "kode jalan".** Kamu tidak bisa menonton
video; kamu hanya bisa melihat FRAME. Potret 6–20 detik kunci (awal
tiap adegan, saat teks muncul, transisi) dengan `scripts/snap.mjs`
(puppeteer, buka `file://`, tanpa server), susun jadi lembar kontak, dan
nilai seperti sutradara: teks kepotong? tumpang tindih? teks muncul
sebelum kamera selesai? masih terasa slide? Perbaiki, potret lagi.
JANGAN merender semua frame untuk mengecek — itu ribuan gambar dan bukan
verifikasi; render penuh hanya untuk export MP4 (langkah 6) bila user
memintanya. Tanpa Node: buka `?debug=1`, scrub manual, screenshot.
6. **Serahkan sebagai SATU `index.html` yang bisa diklik dua kali.** Output
akhir tidak boleh butuh server/Node: CSS dan JS ditulis INLINE di dalam
berkas (module lokal `<script type="module" src="…">` diblokir CORS saat
dibuka lewat `file://`, module inline tidak), library dari CDN, aset
(ikon/gambar) relatif di folder yang sama. Server no-cache
(`scripts/serve.py`) hanya alat KERJA saat mengedit, bukan syarat
menonton. Tanpa player di layar (lihat "Player"); sebutkan `?debug=1`
untuk scrub. **Export MP4 hanya bila user memintanya**: `scripts/
export-frames.mjs` merender tiap frame (60 fps) ke PNG lalu ffmpeg
menggabungkannya — cara ini bebas frame drop, tapi mahal, jadi bukan
langkah rutin dan bukan alat pengecekan.
7. **Khusus explainer: naskah VO + ajakan merekam** — pesan penutup wajib
memuat naskah VO lengkap dan meminta user merekam/generate lalu mengirim
ulang audionya untuk disinkronkan. Detail bentuk naskah, petunjuk rekam,
dan retime di `references/explainer.md` → "Penyerahan".
## Checklist sebelum menyerahkan
- [ ] Style brief (tema, palet dari brand, font display berkarakter, satu
bahasa latar, tanda tangan gerak, momen istimewa) ditulis dan disetujui
SEBELUM kode
- [ ] Tidak ada sisa placeholder starter (abu-abu, font sistem, nebula bila
arah gayanya lain) dan tidak ada kulit referensi yang disalin (palet,
font, tekstur, tata letak, kalimat)
- [ ] Berbeda dari opener/promo sebelumnya: minimal tiga dari palet, font,
bahasa latar, tanda tangan gerak
- [ ] Opener/promo: tiga kandidat konsep ditulis dan satu dipilih; sidik jari
struktur tertulis dan berbeda dari opener sebelumnya; paling banyak dua
komponen kanonik (teks zoom → keluar kiri, tiga tile, input diketik,
push-through, light leak, logo + CTA di tengah), masing-masing dituntut
konsep (`references/opener-konsep.md`); tidak menyalin contoh konsep
(pembuka/penutup berbeda dari contohnya, ≤ 1 momen ✦ yang ditransformasi,
palet dan bentuk dari brand user)
- [ ] App/SaaS: minimal satu babak UI hidup — dirakit, dipakai, menghasilkan —
dari komponen produk user, bukan screenshot diam yang di-zoom
(`references/opener-konsep.md` bagian animasi UI); bila demo terasa
statis, klik penting diikuti kamera (dekat → klik → mundur/geser),
tidak di setiap klik (`techniques.md` §8)
- [ ] Teks hidup (Hukum #4): sentence case bobot 500–600, penekanan jelas,
tanpa titik otomatis (tanda baca hanya bila mengubah arti/irama),
ukuran/arah/posisi bergantian antar adegan;
kapital-tebal hanya di satu adegan. Sorotan kata hanya bila style brief
memilihnya (bukan otomatis di setiap kalimat, bukan pill + bintang
warisan proyek lain)
- [ ] Latar tunduk (Hukum #4): di bawah teks luminance ≤ 25 % atau ≥ 80 %,
elemen latar redup dan berwarna gelap di kantong teks; uji grayscale —
tidak ada latar seterang huruf
- [ ] Transisi dipilih pada batas yang membutuhkan; tidak otomatis semua
batas diberi efek atau semua efek dihapus. Objek penyapu punya makna
dalam adegan; kecepatan, amplitudo, dan jeda sudah diperiksa.
- [ ] Permukaan latar dari menu §7d: ≥ 2 lapis (dasar + cahaya/tekstur/
blob), warna dari palet — tidak flat satu warna, bukan hitam/putih murni
- [ ] Gaya render objek satu keluarga (§7e), atau pergantiannya dijadikan momen
- [ ] Opener berfoto: sumber foto disepakati user (foto user / generate MCP /
stok berlisensi), wajah fiktif bila di-generate, logo/teks brand ditambahkan
di kode, foto dianimasikan (pop, parallax, wadah) — bukan Ken Burns saja
- [ ] Bila memakai grainy gradient/butiran: butiran masih terlihat di MP4 hasil encode
dan gradien tidak banding
- [ ] Bila memakai video: klip dipasang lewat `clip()` (tanpa `autoplay`/`loop`), dibungkus
elemen yang dianimasikan, sumbernya disepakati user, folder `assets/` disebutkan saat
penyerahan, dan detik yang berisi klip sudah dipotret (`snap.mjs`)
- [ ] Gerak latar dipilih dari menu §7c dan BERBEDA dari proyek sebelumnya;
tidak ada batang/garis melintas ke samping kecuali tema kecepatan/
aliran dan belum dipakai di proyek sebelumnya
- [ ] Latar bergerak di setiap adegan (tidak ada latar diam); pergantian warna
latar boleh kapan dibutuhkan asal punya pemicu terlihat
- [ ] Lolos 6 poin "Larangan struktural" (bukan section yang di-fade, ada
benang merah visual, ≤ 2 tingkat teks, gerak tiap detik, transisi
bervariasi, starter yang benar)
- [ ] Tanpa player di layar; autoplay; loop; `?debug=1` untuk scrub
- [ ] Opener: satu gagasan utama tanpa tumpukan badge; explainer: satu
peristiwa dapat memuat beberapa beat dan objek yang saling berhubungan.
- [ ] Kamera, cut, dan gerak objek dipilih sesuai konteks; tidak ada keharusan
menggerakkan kamera di tiap segmen. Saat kamera bergerak, seluruh dunia ikut.
- [ ] Tidak ada hold panjang yang mati: babak tanpa aksi o...
© Bang Tutorial · MIT · bangtutorial/bang-motion