Skip to content
Back to search

BB-Video

An agent skill that makes videos in pure code — narrated explainers and product promos in 14 visual styles (whiteboard, risograph, ink-wash, shadow puppets, pixel art, toy 3D…), 16:9 and 9:16.

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. Its scripts were only partly scanned.

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/BubbleBrainBB/BB-Video 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/BubbleBrainBB/BB-Video'

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/dylanddeng--bb-video/badge.svg)](/listings/dylanddeng--bb-video)

HTML

<a href="/listings/dylanddeng--bb-video"><img src="/api/listings/dylanddeng--bb-video/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.

With the [`skills`](https://github.com/vercel-labs/skills) CLI (Claude Code, Codex, Cursor, OpenCode and other agents):

npx skills add DylanDDeng/BB-Video                                          # pick interactively
npx skills add DylanDDeng/BB-Video --skill bb-video -a claude-code -g   # globally for Claude Code

Or copy the folder yourself:

git clone https://github.com/DylanDDeng/BB-Video.git
cp -r BB-Video/skills/bb-video ~/.claude/skills/

Requirements

No npm dependencies. It needs:

- **Node.js 18+** - **Google Chrome** or Chromium (set `CHROME_PATH` if it is not in the default location) - **ffmpeg** on your `PATH` - **Python 3** and **[edge-tts](https://github.com/rany2/edge-tts)** for the voiceover (`pip install edge-tts`) - An internet connection for the voiceover, web fonts and the few libraries some styles load from jsDelivr (three.js for `toy3d`; GSAP / Matter.js only if a page asks for them) - Optional: [Blender](https://www.blender.org) 3.6+ for `toy3d` mascots (otherwise three.js builds them)

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 · 374 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. # BB Video
  2. An agent skill for making videos **in pure code** — no editing app, no stock footage.
  3. Every frame is drawn with HTML / SVG / canvas as a pure function of time, rendered frame by frame in headless Chrome, with music and sound effects synthesized in code, and encoded with ffmpeg.
  4. [Chinese version](README.zh-CN.md)
  5. ## The skill
  6. | Skill | What it makes |
  7. |---|---|
  8. | <a href="skills/bb-video"><code>bb&#8288;-&#8288;video</code></a> | **Explainer videos** with voiceover, captions and background music, and **promo / launch videos** for websites, apps and software with beat-synced music and sound effects — 16:9 and 9:16, in 37 visual styles |
  9. You make one choice: **the style**. Everything else (narration, storyboard, voice, music, sound, layout, checks) is the agent's job.
  10. | Style | Looks like |
  11. |---|---|
  12. | `whiteboard` | an infinite hand-drawn board: handwriting, arrows, KaTeX formulas, cartoon characters that talk and point; ends on a numbered "knowledge map" |
  13. | `riso` | risograph print: spot-colour overprint, halftone, slight misregistration, one magazine page per chapter |
  14. | `ink` | ink-wash handscroll: brush strokes, seals, figures in Chinese painting style |
  15. | `launch` | launch-event motion design: big type, product screens, light / dark / brand-colour stages |
  16. | `origami` | folded paper: creases, shading, paper unfolding into the next scene |
  17. | `pop` | pop art: Ben-Day dots, bold outlines, comic panels |
  18. | `op` | op art: moving black-and-white fields (WebGL) |
  19. | `cutout` | Matisse paper cut-outs |
  20. | `ascii` | ASCII character art |
  21. | `shadow` | shadow puppetry: carved, translucent leather puppets on a lamp-lit screen |
  22. | `bauhaus` | constructivism / Bauhaus: geometry, primary colours, diagonal type |
  23. | `pixel` | 8-bit game: sprites, game UI, chiptune |
  24. | `chat` | the story told in a messaging app: bubbles, typing, voice notes, cards |
  25. | `toy3d` | toy 3D: the product's real UI as physical slabs on a desk, a matte vinyl toy hopping across it (three.js) |
  26. | `newsreel` | a 1930s cinema newsreel: archive photos with source tags, supers and rubber stamps on scratchy black-and-white film, intertitles, a brass march |
  27. | `filmroom` | a coach's film session: real footage stops, a pen rings the player and draws her path, rewind and slow-motion replay with a tracked ring; a top-down tactics board and shot charts from game data |
  28. | `mystery` | a deadpan mock-science TV show: a blue 4:3 old-TV picture, an outlined title with red key words, numbered "symptoms" in brush script acted out by rubber-hose cartoon stickers, a chat screen, a storm of words, then a test card; or a case-file look (fog, struck-out guesses, an evidence board, a sourced answer) |
  29. | `isometric` | an isometric miniature world: tiles on plinths, low-poly buildings, belts, vans and little people that move on their own; one thing followed through a whole system, its route painted on the ground, a clock on each stage, the part being talked about lifts while the rest fades (three.js) |
  30. | `trailer` | a Hollywood movie trailer in a 2.39:1 letterbox: code-painted cinematic shots (space, planets, corridors, rim-lit silhouettes) under a teal-orange grade and grain, black one-phrase cards in metallic type, a lone piano ping and a ticking clock, then BRAAMs and taiko as the cuts speed up, a beat of silence, the title slam, the release date and the billing block |
  31. | `dossier` | finance / news commentary made of paper: newspaper clippings with a highlighted headline and halftone photos, real source documents under an invented masthead with the camera pushing into the quoted line and a translation bar or tag landing on it, sheets flying in, ink-brush wipes, thumbnail title cards, data callouts, a chapter bar and outlined captions |
  32. | `manga` | a black-and-white manga page that moves: screentone, panels with gutters, slanted and bleeding frames, speed and focus lines, drawn Japanese sound effects and balloons; the camera reads panel by panel, punches in and shakes on the hits, pages turn or get slashed open, a full-page splash for the climax; original code-drawn characters |
  33. | `map` | an animated map from real geodata: paper land, engraved water lines along the coast, parks, street texture, cartographic labels; routes draw on stroke by stroke, a tram or train travels a line and stops on the word, stations pop in, areas spread like ink, callout cards pinned to places, a year counter and a locator globe; the camera turns the globe, dives to the street, flies between places and tilts to follow a train |
  34. | `swiss` | Swiss poster kinetic typography: giant grotesk type cropped by the frame edge on a grid, black plus one accent taken from the brand; letters rise one by one, digits roll into place, the poster pulls out into a wall of its colour variants, a word repeats into a full-screen pattern; the information is typography too: numbered lists, check-chip grids, giant numerals, bar charts, old / new comparisons, real screenshots annotated like poster elements |
  35. | `lumen` | a dark motivational animated short: a code-drawn room nearly all black, lit by one motivated light — a phone screen on a face, a red alarm clock, a desk lamp, moonlight through blinds, dawn at a window — with rim light, a giant shadow on the wall, haze and grain; one original protagonist (a soft square head, a cowlick that shows the mood) acts everything with eyes and brows; slow push-ins that hold on the face, a low second-person voice, white thumbnail-style title cards; facts told in light: a clock racing, gauges, the night as a line, an x-ray of the head |
  36. | `blueprint` | a blueprint engineering drawing: cyanotype paper with a grid, white line work drafted in construction lines first, dimensions, leaders with numbered balloons, hatched sections, a parts list, a title block and one red pencil; mechanisms really work — gear trains mesh and turn at the right ratios, an escapement locks and releases, springs wind down, cams and levers move — in slow motion or time-lapse shown on the sheet; each subject arrives on a new sheet, and the camera pushes into a detail while the rest of the drawing falls back |
  37. | `collage` | a paper-collage news explainer: one take across a table covered in torn paper — halftone photos with credits, faded poster layers, red rubber stamps, a typewriter quote with a highlighter sweep, tape and push pins; the camera floats, pushes in and travels with depth of field; numbers and history are told with paper props — a paper-doll grid that turns red, a red thread pinned along a timeline, cut-paper bars on notebook paper, a line chart on graph paper with pins riding the lines, a big character printed on a certificate; a fixed frame with channel, date and a source line |
  38. | `grain` | a flat vector illustration with grain shading: warm off-white paper, two spot colours (coral and navy by default) and their tints, no outlines; volume and light are stipple grain that never boils; round-head figures on a thin ground line, buildings, streets and rooms that transform from era to era; very little text — a timeline ruler whose year ticks over, signs and readouts; information drawn into the picture: circular close-up insets, a small navy diagram card, dial needles and clock wedges that move, counters that roll, rows of repeated things, columns rising from the ground line, a spotlight that dims the rest; the camera pushes, travels and opens an iris onto the next scene |
  39. | `storybook` | a hand-drawn storybook with its own mascots: warm grey paper with fibres, ink outlines with a slight hand wobble, coloured-pencil hatching with a soft rim; each project defines its own cast of original cute characters (bean, round, blob, gem, star, capsule or pillar bodies, a sprout or antenna on top) that squash, stretch, blink and hop, acting an invisible process out with tangible props on little stages along one ground line — filing cabinets, an easel sheet, a monitor, a big button, stacking blocks, signposts, paper planes, cards flipping to ✓; small dark monospace tags float above them with a ✓ result line; one character splits into clones that each carry a task card, then they merge back into one; the camera travels from stage to stage |
  40. | `tapestry` | a Bayeux-Tapestry embroidered scroll: undyed linen with a visible weave, everything stitched in a few wool colours — stem-stitch outlines, laid-and-couched fills, bare linen for faces and hands; upper and lower borders of birds and beasts between diagonal bars; stylised trees divide the scenes; flat side-on figures with big gestures; act titles under a branch arch and running captions stitched in Chinese; figures and objects stitch themselves on thread by thread while one long cloth scrolls past, pushing in until single threads show |
  41. | `parable` | a wordless 3D stick-figure parable: a black void with a glossy floor that mirrors everything, glowing white stick figures with round heads, one fixed wide camera; two figures do the same thing in opposite ways — bricks laid one by one, piles, steps — and the contrast is the whole story; one red object carries the meaning; small monospace labels and counters, a single title at the end; vertical first, 15–45 s, music only by default |
  42. | `pencil` | a hand-drawn pencil test: warm animation paper with peg holes and the drawing number, light blue construction lines under a pressure-weighted graphite line, smudge and hatching, drawings on twos with a gentle line boil; one drawing redraws itself into the next instead of a cut, machines really turn (wheels, cranks, chains geared by their teeth), faceless gesture figures, light pools in a graphite haze, one warm bloom at the peak; steps, numbers and contrast are drawn by hand |
  43. | `drawnworld` | one continuous picture drawn by a pen: a black stylus draws a whole invented world stroke by stroke in clean ink on warm white paper, growing outward from one small thing while the camera follows the pen and eases back; lines behind nearer parts never show through, every sign is lettered by the pen in real stroke order, a tag gets crossed out and rewritten as the story moves on; once the whole mechanism is on the page, a colour wash spreads across it and reveals sky, hills and trees, and the held wide shot comes alive as its machines start one by one |
  44. | `goldenage` | a golden-age American theatrical cartoon: a painted gouache night city of Art Deco towers and warm windows behind inked cel characters, drawn on twos with a boiling line and projected as a film print. Cartoon physics carry the telling: a giant ball flattens to a pancake and rebounds, skyscrapers accordion and ring like springs, an impact frame on every hit, characters hang in mid-air, and dead-still pauses set the laughs up; a small hot band and a slide whistle follow every action |
  45. | `rubberhose` | a 1930s black-and-white rubber-hose cartoon: grey watercolour washes and pen work behind an inked cast of things that come alive, with white gloves, pie-cut eyes and rubber-hose limbs, all bouncing on the beat to a hot two-beat band, drawn on twos with a boiling line and projected as a worn print (heavy grain, flicker, dust, scratches, a splice bump on every cut). Gags carry the telling: objects wake up and dance, time itself goes wrong, an alarm clock swells and bursts, and the band stops dead while everyone freezes |
  46. | `supercut` | a beat-cut footage supercut: real-world footage (licence-clean stills with a move and a shutter smear, clips for the holds) hard-cut on the beat two or three shots a second, with one small white caption pill pinned at the exact centre that never moves — a sentence is typed into it word by word across several shots, words arrive scrambled or under a colour bar, its ink takes the colour of the picture under it, hairline guides run from its edges to the frame edges. The key word flashes as giant eroded type, a grid fills cell by cell or splits 1 → 4 → 16, a held shot with two message bubbles says something concrete every few seconds, then single-word end cards. Drums and bass, no sound on ordinary cuts. For brand mood and abstract selling points; promos only, and it needs real footage |
  47. | `cutaway` | a cutaway tour: one complete 3D model of a thing with insides, drawn like a textbook illustration in a single take — flat toon colour in two or three steps with one highlight, outlines in a darker tone of each fill, white paper outside and a cream interior. The closed thing appears with a scale bar tied to the camera, a hole grows in its shell into a cutaway, and the camera flies from part to part: the rest fades back, the part does one small action that shows its job, and a three-row card says its name, what it does and, small and grey, how the drawing differs from the real thing (thicker, larger, fewer, coloured), each with its source in the fact sheet; bordered labels on leader lines, a framed close-up with its own little model, a closing fact on a plate |
  48. | `watercolour` | a watercolour being painted on cold-press paper, with no outlines: colour makes the shapes. Washes are transparent and darken each other like real glazes, so bare paper is the only white; pigment gathers into a slightly darker, uneven rim where a wash dried and settles into the paper's tooth; the painting's ragged edge stays inside the frame. Paint blooms out from where the brush touched, follows a stroke or grows along a branch, dark and soft while wet, then dry and hard-edged. Colour can be washed out again by a wet front that leaves a pale stain, and comes back as a new glaze. Information is told in paint: a counted field of dabs where a share loses or takes colour, swatches whose depth is the number, strokes pulled up from a pencil baseline, a pencil-ringed close-up, one glaze over the whole scene. A slow camera over one sheet, a fresh sheet per chapter, serif notes that soak in, a painted title |
  49. What it covers:
  50. - **Explainers**: phenomena ("why is the sky blue"), problem walkthroughs (including screenshots of problems), vocabulary, concepts, historical stories, how-tos, trivia, news and data.
  51. - **Promos**: give it a URL; it researches the site (text, numbers, colours), captures screenshots, and builds a beat-driven promo with the product's real UI and brand colours.
  52. - **Everything built in**: edge-tts voiceover with word-level timing, captions, music and sound effects synthesized in code, a cover frame, portrait (9:16) versions.
  53. - **Self-checking**: before rendering, a lint check reports overlaps, text that leaves before it can be read, things off-frame, facts on screen that aren't in the brief, thin information, motion problems; after rendering, a frame check reports jumps, one-frame flashes and dead air (seconds of music with nothing new on screen).
  54. - **Speaks your language**: the video follows the language of your request. Chinese and English are fully tuned; other languages work with any [edge-tts voice](https://github.com/rany2/edge-tts).
  55. <!-- gallery:start -->
  56. ## Examples
  57. One sample per style, all made with this skill (GIFs are 7 s cuts; the full mp4s with sound are on the [samples release](https://github.com/BubbleBrainBB/BB-Video/releases/tag/samples)). Narration is in Chinese; the four website promos and the swiss sample are music-only.
  58. <table>
  59. <tr>
  60. <td width="33%" valign="top">
  61. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/whiteboard.mp4"><img src="examples/whiteboard/preview.gif" width="100%" alt="whiteboard"></a><br>
  62. <b><code>whiteboard</code></b> · Liu Bang slays the white snake (a Han-dynasty legend)<br>
  63. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/whiteboard.mp4">Full video</a>
  64. </td>
  65. <td width="33%" valign="top">
  66. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/riso.mp4"><img src="examples/riso/preview.gif" width="100%" alt="riso"></a><br>
  67. <b><code>riso</code></b> · Grok Bot, a kinetic promo<br>
  68. <sub>Footage from its public website</sub><br>
  69. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/riso.mp4">Full video</a>
  70. </td>
  71. <td width="33%" valign="top">
  72. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/ink.mp4"><img src="examples/ink/preview.gif" width="100%" alt="ink"></a><br>
  73. <b><code>ink</code></b> · The Tang poem "On Stork Tower"<br>
  74. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/ink.mp4">Full video</a>
  75. </td>
  76. </tr>
  77. <tr>
  78. <td width="33%" valign="top">
  79. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/launch.mp4"><img src="examples/launch/preview.gif" width="100%" alt="launch"></a><br>
  80. <b><code>launch</code></b> · Grok Bot, a launch film<br>
  81. <sub>Footage from its public website and app</sub><br>
  82. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/launch.mp4">Full video</a>
  83. </td>
  84. <td width="33%" valign="top">
  85. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/origami.mp4"><img src="examples/origami/preview.gif" width="100%" alt="origami"></a><br>
  86. <b><code>origami</code></b> · Why is the sky blue?<br>
  87. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/origami.mp4">Full video</a>
  88. </td>
  89. <td width="33%" valign="top">
  90. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/pop.mp4"><img src="examples/pop/preview.gif" width="100%" alt="pop"></a><br>
  91. <b><code>pop</code></b> · Why is the sky blue?<br>
  92. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/pop.mp4">Full video</a>
  93. </td>
  94. </tr>
  95. <tr>
  96. <td width="33%" valign="top">
  97. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/op.mp4"><img src="examples/op/preview.gif" width="100%" alt="op"></a><br>
  98. <b><code>op</code></b> · Stripe, from its homepage<br>
  99. <sub>Footage from its public website</sub><br>
  100. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/op.mp4">Full video</a>
  101. </td>
  102. <td width="33%" valign="top">
  103. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/cutout.mp4"><img src="examples/cutout/preview.gif" width="100%" alt="cutout"></a><br>
  104. <b><code>cutout</code></b> · Why is the sky blue?<br>
  105. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/cutout.mp4">Full video</a>
  106. </td>
  107. <td width="33%" valign="top">
  108. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/ascii.mp4"><img src="examples/ascii/preview.gif" width="100%" alt="ascii"></a><br>
  109. <b><code>ascii</code></b> · What is ASCII?<br>
  110. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/ascii.mp4">Full video</a>
  111. </td>
  112. </tr>
  113. <tr>
  114. <td width="33%" valign="top">
  115. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/shadow.mp4"><img src="examples/shadow/preview.gif" width="100%" alt="shadow"></a><br>
  116. <b><code>shadow</code></b> · Liu Bang slays the white snake, with character voices<br>
  117. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/shadow.mp4">Full video</a>
  118. </td>
  119. <td width="33%" valign="top">
  120. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/bauhaus.mp4"><img src="examples/bauhaus/preview.gif" width="100%" alt="bauhaus"></a><br>
  121. <b><code>bauhaus</code></b> · The Bauhaus: a school that lasted fourteen years<br>
  122. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/bauhaus.mp4">Full video</a>
  123. </td>
  124. <td width="33%" valign="top">
  125. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/pixel.mp4"><img src="examples/pixel/preview.gif" width="100%" alt="pixel"></a><br>
  126. <b><code>pixel</code></b> · Why old Famicom games had so few colours<br>
  127. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/pixel.mp4">Full video</a>
  128. </td>
  129. </tr>
  130. <tr>
  131. <td width="33%" valign="top">
  132. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/chat.mp4"><img src="examples/chat/preview.gif" width="100%" alt="chat"></a><br>
  133. <b><code>chat</code></b> · Lychees for Lady Yang, told as a group chat<br>
  134. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/chat.mp4">Full video</a>
  135. </td>
  136. <td width="33%" valign="top">
  137. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/toy3d.mp4"><img src="examples/toy3d/preview.gif" width="100%" alt="toy3d"></a><br>
  138. <b><code>toy3d</code></b> · Linear website promo<br>
  139. <sub>Footage from its public website</sub><br>
  140. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/toy3d.mp4">Full video</a>
  141. </td>
  142. <td width="33%" valign="top">
  143. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/newsreel.mp4"><img src="examples/newsreel/preview.gif" width="100%" alt="newsreel"></a><br>
  144. <b><code>newsreel</code></b> · The 2026 Tesla Roadster reveal, as a 1930s newsreel<br>
  145. <sub>Photos from Wikimedia Commons (CC0 / public domain / CC BY 2.0 Steve Jurvetson)</sub><br>
  146. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/newsreel.mp4">Full video</a>
  147. </td>
  148. </tr>
  149. <tr>
  150. <td width="33%" valign="top">
  151. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/filmroom.mp4"><img src="examples/filmroom/preview.gif" width="100%" alt="filmroom"></a><br>
  152. <b><code>filmroom</code></b> · How one basket happened: Fenerbahçe vs Samsun Canik, 2018<br>
  153. <sub>Game footage: TBF, CC BY 3.0, via Wikimedia Commons</sub><br>
  154. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/filmroom.mp4">Full video</a>
  155. </td>
  156. <td width="33%" valign="top">
  157. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/mystery.mp4"><img src="examples/mystery/preview.gif" width="100%" alt="mystery"></a><br>
  158. <b><code>mystery</code></b> · Why your friend should call you dad (a deadpan mock-science proof)<br>
  159. <sub>Fiction, for fun · cartoons drawn in code</sub><br>
  160. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/mystery.mp4">Full video</a>
  161. </td>
  162. <td width="33%" valign="top">
  163. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/isometric.mp4"><img src="examples/isometric/preview.gif" width="100%" alt="isometric"></a><br>
  164. <b><code>isometric</code></b> · How a parcel gets to you: one parcel followed from the warehouse to your door<br>
  165. <sub>Figures: China's State Post Bureau, 2025 · the little world and its courier brand are drawn in code</sub><br>
  166. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/isometric.mp4">Full video</a>
  167. </td>
  168. </tr>
  169. <tr>
  170. <td width="33%" valign="top">
  171. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/trailer.mp4"><img src="examples/trailer/preview.gif" width="100%" alt="trailer"></a><br>
  172. <b><code>trailer</code></b> · Deep Space Echo, the trailer for an original, fictional sci-fi film<br>
  173. <sub>A fictional film · every shot, sound and name made in code</sub><br>
  174. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/trailer.mp4">Full video</a>
  175. </td>
  176. <td width="33%" valign="top">
  177. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/dossier.mp4"><img src="examples/dossier/preview.gif" width="100%" alt="dossier"></a><br>
  178. <b><code>dossier</code></b> · AI's bill: US tech stocks in October 2026, from a record high to the week of the Fed<br>
  179. <sub>News commentary, not investment advice · documents quoted from SEC, TSMC, Federal Reserve and company releases · pictures drawn in code</sub><br>
  180. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/dossier.mp4">Full video</a>
  181. </td>
  182. <td width="33%" valign="top">
  183. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/manga.mp4"><img src="examples/manga/preview.gif" width="100%" alt="manga"></a><br>
  184. <b><code>manga</code></b> · Caffeine's 45 minutes: how a cup of coffee keeps you awake, told as a shōnen battle<br>
  185. <sub>General health information, not medical advice · original characters drawn in code · sources: IOM, EFSA, FDA, Reichert et al. 2022</sub><br>
  186. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/manga.mp4">Full video</a>
  187. </td>
  188. </tr>
  189. <tr>
  190. <td width="33%" valign="top">
  191. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/map.mp4"><img src="examples/map/preview.gif" width="100%" alt="map"></a><br>
  192. <b><code>map</code></b> · The Boston subway: from the 1897 tunnel under Boston Common to today's four-colour network<br>
  193. <sub>Map drawn from MassDOT / MBTA data, U.S. Census TIGER/Line and Natural Earth</sub><br>
  194. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/map.mp4">Full video</a>
  195. </td>
  196. <td width="33%" valign="top">
  197. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/swiss.mp4"><img src="examples/swiss/preview.gif" width="100%" alt="swiss"></a><br>
  198. <b><code>swiss</code></b> · Artificial Analysis Intelligence Index v5: the AI benchmark launched on October 27, 2026 — nine evaluations, the leaderboard, the open-weights gap, cost per task<br>
  199. <sub>Figures and charts from artificialanalysis.ai</sub><br>
  200. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/swiss.mp4">Full video</a>
  201. </td>
  202. <td width="33%" valign="top">
  203. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/lumen.mp4"><img src="examples/lumen/preview.gif" width="100%" alt="lumen"></a><br>
  204. <b><code>lumen</code></b> · Five more minutes: revenge bedtime procrastination — the night that won't end, what it costs the next day, and one small decision<br>
  205. <sub>General health information, not medical advice · original character and sets drawn in code · sources: Kroese et al. 2014, CDC / AASM, Williamson &amp; Feyer 2000, Van Dongen et al. 2003, Chang et al. 2015</sub><br>
  206. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/lumen.mp4">Full video</a>
  207. </td>
  208. </tr>
  209. <tr>
  210. <td width="33%" valign="top">
  211. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/blueprint.mp4"><img src="examples/blueprint/preview.gif" width="100%" alt="blueprint"></a><br>
  212. <b><code>blueprint</code></b> · What happens inside a mechanical watch: mainspring, going train, escapement, balance, motion work — drawn and running at the right ratios<br>
  213. <sub>A generic, illustrative movement · facts from Wikipedia</sub><br>
  214. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/blueprint.mp4">Full video</a>
  215. </td>
  216. <td width="33%" valign="top">
  217. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/collage.mp4"><img src="examples/collage/preview.gif" width="100%" alt="collage"></a><br>
  218. <b><code>collage</code></b> · Gold, from $35 to $5,318: the 1934 peg, Bretton Woods, Nixon closing the gold window, central banks buying, and 2026's record and sell-off<br>
  219. <sub>Photos via Wikimedia Commons: NARA, Oliver F. Atkins (public domain), Stevebidmead (CC0) · prices: COMEX, World Gold Council, Reuters</sub><br>
  220. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/collage.mp4">Full video</a>
  221. </td>
  222. <td width="33%" valign="top">
  223. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/grain.mp4"><img src="examples/grain/preview.gif" width="100%" alt="grain"></a><br>
  224. <b><code>grain</code></b> · How people lit the night: from stone lamps and tallow candles to gas, the electric bulb, fluorescent tubes and LEDs — light got brighter and far cheaper<br>
  225. <sub>Illustrative scenes, no real people drawn · sources: Nordhaus 1996, Fouquet &amp; Pearson 2006, Royal Swedish Academy of Sciences 2014, Edison Papers, IEEE</sub><br>
  226. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/grain.mp4">Full video</a>
  227. </td>
  228. </tr>
  229. <tr>
  230. <td width="33%" valign="top">
  231. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/storybook.mp4"><img src="examples/storybook/preview.gif" width="100%" alt="storybook"></a><br>
  232. <b><code>storybook</code></b> · How the body beats a cold: a rhinovirus copies itself in the cells of the nose, the cells raise the alarm, white cells arrive, one T cell becomes thousands, memory cells stay — and why the next cold still comes<br>
  233. <sub>General health information, not medical advice · original characters drawn in code · sources: CDC, NHS, Jacobs et al. 2013, Foxman et al. 2015, Eccles 2005, Barclay et al. 1989</sub><br>
  234. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/storybook.mp4">Full video</a>
  235. </td>
  236. <td width="33%" valign="top">
  237. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/tapestry.mp4"><img src="examples/tapestry/preview.gif" width="100%" alt="tapestry"></a><br>
  238. <b><code>tapestry</code></b> · How the book came to be: clay tablets, papyrus scrolls, the parchment codex, Cai Lun's paper, the Diamond Sutra, Bi Sheng's movable type, Gutenberg's Bible, the steam press, the first e-book<br>
  239. <sub>Generic stitched figures · sources: British Museum, The Met, Britannica, Book of the Later Han, Dream Pool Essays, British Library, Library of Congress, Project Gutenberg</sub><br>
  240. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/tapestry.mp4">Full video</a>
  241. </td>
  242. <td width="33%" valign="top">
  243. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/parable.mp4"><img src="examples/parable/preview.gif" width="100%" alt="parable"></a><br>
  244. <b><code>parable</code></b> · Compound interest: one figure builds 30 bricks on day one and sleeps for a year; the other adds 1% a day — slow for months, then it passes him (1.01³⁶⁵ ≈ 37.8)<br>
  245. <sub>Wordless · the numbers are computed, 1% a day is an illustration</sub><br>
  246. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/parable.mp4">Full video</a>
  247. </td>
  248. </tr>
  249. <tr>
  250. <td width="33%" valign="top">
  251. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/pencil.mp4"><img src="examples/pencil/preview.gif" width="100%" alt="pencil"></a><br>
  252. <b><code>pencil</code></b> · How the bicycle got its shape: one rider on one road, the machine redrawn into its next generation on the move — the running machine, pedals on the front wheel, the high wheel, the chain, air in the tyres, the diamond frame; each change has a mechanical reason, and every wheel and gear is computed<br>
  253. <sub>Faceless figures, machines drawn in code · sources: Science Museum Group, Stadt Mannheim, Cycling UK, Grace's Guide, DPMA, Library Company of Philadelphia</sub><br>
  254. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/pencil.mp4">Full video</a>
  255. </td>
  256. <td width="33%" valign="top">
  257. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/drawnworld.mp4"><img src="examples/drawnworld/preview.gif" width="100%" alt="drawnworld"></a><br>
  258. <b><code>drawnworld</code></b> · Why inflation happens: one bread stall and one price tag grow into a whole invented town, one area per cause — more money, more buyers than goods, rising costs, expectations feeding themselves; the colour arrives only when the whole mechanism is on the page<br>
  259. <sub>Invented town, nothing real drawn · sources: IMF, U.S. BLS, Federal Reserve History, Hanke &amp; Krus, PBS, National Bureau of Statistics of China</sub><br>
  260. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/drawnworld.mp4">Full video</a>
  261. </td>
  262. <td width="33%" valign="top">
  263. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/goldenage.mp4"><img src="examples/goldenage/preview.gif" width="100%" alt="goldenage"></a><br>
  264. <b><code>goldenage</code></b> · The Moon Fell Down: a tiny worker loosens one screw, the moon drops onto Manhattan and bounces from tower to tower, a crane slings it back into the sky, and then a star comes loose<br>
  265. <sub>A wordless short with an invented cast, no real people or places named</sub><br>
  266. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/goldenage.mp4">Full video</a>
  267. </td>
  268. </tr>
  269. <tr>
  270. <td width="33%" valign="top">
  271. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/rubberhose.mp4"><img src="examples/rubberhose/preview.gif" width="100%" alt="rubberhose"></a><br>
  272. <b><code>rubberhose</code></b> · The Clock Goes Crazy: at midnight a whole clock factory wakes up and dances, time itself goes wrong, an alarm clock explodes, and the night janitor winds the master clock down until everything freezes, except one tiny watch<br>
  273. <sub>A wordless short with an invented cast, no real people or places named</sub><br>
  274. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/rubberhose.mp4">Full video</a>
  275. </td>
  276. <td width="33%" valign="top">
  277. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/supercut.mp4"><img src="examples/supercut/preview.gif" width="100%" alt="supercut"></a><br>
  278. <b><code>supercut</code></b> · Zed, the code editor: "Code at the speed of thought", cut to the beat over fifty pictures of fast things, machines and hands<br>
  279. <sub>Photos and clips from Wikimedia Commons (CC0 / public domain / CC BY 2.0: Bill Bradford, Mark Dumont, Mercado Viagens, Nicholas A. Tonelli, Oregon Department of Transportation, Shixart1985, flowcomm, kennymatic · CC BY 2.5: Greg L. Wright · CC BY 3.0: Gregory Wilson, 极客湾Geekerwan · CC BY 4.0: Henrysz, NOIRLab/NSF/AURA); <a href="examples/supercut/CREDITS.txt">full list</a></sub><br>
  280. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/supercut.mp4">Full video</a>
  281. </td>
  282. <td width="33%" valign="top">
  283. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/cutaway.mp4"><img src="examples/cutaway/preview.gif" width="100%" alt="cutaway"></a><br>
  284. <b><code>cutaway</code></b> · Inside one eyeball: a human eye opens into a cutaway and a beam of light is followed through nine stops — cornea, pupil, lens, vitreous, retina, macula, rods and cones, blind spot, optic nerve; each card also says how the drawing differs from the real thing<br>
  285. <sub>Drawn in code, built in millimetres · sources: EyeWiki (AAO), AAO, Webvision, Purves <i>Neuroscience</i>, StatPearls, Curcio et al. 1990</sub><br>
  286. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/cutaway.mp4">Full video</a>
  287. </td>
  288. </tr>
  289. <tr>
  290. <td width="33%" valign="top">
  291. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/watercolour.mp4"><img src="examples/watercolour/preview.gif" width="100%" alt="watercolour"></a><br>
  292. <b><code>watercolour</code></b> · Why corals are turning white: a reef is painted in, then washed white patch by patch; a pencil-ringed close-up of one polyp shows the algae that give it colour and food being pushed out by warm water; the four global bleaching events as swatches that deepen (21% → 37% → 68% → 84% of reef area under bleaching-level heat) and a hundred dabs of which 84 lose their colour; then what recovery takes<br>
  293. <sub>Painted in code, no photos · sources: NOAA Coral Reef Watch, NOAA Ocean Service, NOAA NESDIS, ICRI, AIMS, GBRMPA, GCRMN</sub><br>
  294. <a href="https://github.com/BubbleBrainBB/BB-Video/releases/download/samples/watercolour.mp4">Full video</a>
  295. </td>
  296. <td width="33%" valign="top"></td>
  297. <td width="33%" valign="top"></td>
  298. </tr>
  299. </table>
  300. <!-- gallery:end -->
  301. ## Install
  302. With the [`skills`](https://github.com/vercel-labs/skills) CLI (Claude Code, Codex, Cursor, OpenCode and other agents):
  303. ```bash
  304. npx skills add BubbleBrainBB/BB-Video # pick interactively
  305. npx skills add BubbleBrainBB/BB-Video --skill bb-video -a claude-code -g # globally for Claude Code
  306. ```
  307. Or copy the folder yourself:
  308. ```bash
  309. git clone https://github.com/BubbleBrainBB/BB-Video.git
  310. cp -r BB-Video/skills/bb-video ~/.claude/skills/
  311. ```
  312. ### Requirements
  313. No npm dependencies. It needs:
  314. - **Node.js 18+**
  315. - **Google Chrome** or Chromium (set `CHROME_PATH` if it is not in the default location)
  316. - **ffmpeg** on your `PATH`
  317. - **Python 3** and **[edge-tts](https://github.com/rany2/edge-tts)** for the voiceover (`pip install edge-tts`)
  318. - An internet connection for the voiceover, web fonts and the few libraries some styles load from jsDelivr (three.js for `toy3d`; GSAP / Matter.js only if a page asks for them)
  319. - Optional: [Blender](https://www.blender.org) 3.6+ for `toy3d` mascots (otherwise three.js builds them)
  320. ## Usage
  321. Just ask your agent, for example:
  322. - "Make a whiteboard explainer: why is the sky blue?"
  323. - "Turn this geometry problem into a walkthrough video" (attach a screenshot)
  324. - "Make a launch video for https://example.com, 16:9 and 9:16"
  325. - "Tell the story of Liu Bang slaying the white snake as a shadow-puppet video"
  326. - "Tell a historical anecdote as a chat-log video"
  327. The agent shows you the facts, narration and storyboard first, then voices, draws and renders. Output goes to `videos/<name>/out/` (mp4, cover, and for whiteboard / riso a board overview image). Open `videos/<name>/index.html` in a browser to preview and scrub.
  328. ## How it works
  329. ```
  330. script.json (narration) ──► tts.py ──► audio + word-level timeline
  331. index.html (drawing code, renderFrame(t)) ──► render.mjs ──► Chrome, frame by frame ──► ffmpeg ──► mp4
  332. ├─► lint check, captions, music + sound effects
  333. └─► frame check (jumps, flashes, dead air)
  334. ```
  335. Each frame is a pure function of time, so renders are deterministic and parallel, and the agent can look at any moment as a still before rendering the whole video.
  336. ## Privacy & security
  337. - **Narration text is sent to Microsoft's online speech service** (that is how edge-tts works). Don't put confidential material in the narration.
  338. - **Promo research opens the website you give it** in headless Chrome and takes screenshots (no logins, no downloads of site files).
  339. - **Archive photo search** (`footage.mjs`, used when a film needs real photos you didn't supply) sends the search words to the Wikimedia Commons API, and downloads only the files you approve, with their licence and credit.
  340. - Web fonts and libraries come from jsDelivr / unpkg at pinned versions. Nothing else goes over the network: no telemetry, no API keys, no accounts.
  341. - `render.mjs` opens a project's `index.html` in headless Chrome with local file access, which means running that project's code. Render only projects you or your agent made.
  342. ## License
  343. [MIT](LICENSE). Bundled third-party code: [KaTeX](https://katex.org) (MIT, see `skills/bb-video/explainer/runtime/katex/LICENSE`). Loaded from CDNs under their own licenses: three.js (MIT), GSAP (Standard "no charge" license), Matter.js (MIT); fonts LXGW WenKai, Excalifont, Noto Sans / Serif SC, Inter, Oswald and others (SIL OFL 1.1).

Ratings and comments

Sign in to rate this skill.

Sign in

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