luckiest-co 1.0.40 → 1.0.42

package/skills/video-studio/references/styles/3d-render.md

@@ -0,0 +1,39 @@
+# Soft 3D Render
+
+- id: `3d-render`
+- Source: mg-styles-15 `prompts/04-3d-render.md` (MIT, Vincentwei1021)
+- Best for: premium product ident, brand sting, phone/drink/sneaker spots, satisfying loops
+- Not for: fast cutty edits, flat graphic looks, long runtimes on a weak GPU
+- Triggers: 3D, C4D, Cinema 4D, Octane, Redshift, Blender render, clay render, soft pastel 3D, jelly, glossy plastic, cloner, satisfying, ASMR, product ident, Maxon reel
+- Tone cell: calm-soft
+- Clock: smooth 24 fps
+
+## Look
+Pastel studio with an infinite cyc backdrop, big soft area lights plus an HDRI, shallow depth of field (about f/1.8 feel), real motion blur. Material trio: SSS gummy (candy pink, peach), glossy plastic (cream, lilac), frosted glass or chrome accent. AO, soft reflections, subtle subsurface glow. Hero is an inflated, bevelled 3D wordmark or glossy jelly logo with an invented brand name. Clean hero composition at the end.
+
+## Motion
+Cloner-style grid of glossy pills or spheres ripples with an effector wave. Hero drops in with squash and stretch via a damped spring, collides with and displaces the field. Long-tail ease on the camera: about 80% of the move in the first 20% of the time, very slow finish. Physics-feel everywhere, nothing linear. Impacts drive the cuts.
+
+## Signature features (judged against these)
+- Physically plausible materials: SSS soft gel, glossy plastic, glass or chrome.
+- Soft studio three-point lighting plus HDRI and AO.
+- Shallow depth of field with real motion blur.
+- Cloner array with a wave effector.
+- Damped-spring jiggle and soft-body collision on the hero.
+- Camera long-tail ease, final hero held about 1s.
+- 24 fps cinematic feel, candy palette.
+
+## 10-second beat seed
+- 0-1.2s: pastel cyc, cloner field already rippling, first drop of the hero.
+- 1.2-5s: wave builds, hero lands and displaces the field.
+- 5-7s (hero at 60-75%): collision, wordmark inflates and jiggles, camera long-tail push.
+- 7-10s: settle to a clean composition, hold 1s with a slow idle wobble.
+
+## Sound
+Airy cinematic pad with ASMR-style soft thuds, squishes and bubbly pops, frame-synced to impacts.
+
+## Build it in HyperFrames
+Blender is not available. Use Three.js (WebGL2) with MeshPhysicalMaterial (clearcoat, sheen, transmission, thickness for SSS-like glow), RoomEnvironment or an HDRI for lighting, SSAO plus a bokeh pass for DOF, and a sub-frame accumulation buffer (render 8-16 sub-times per frame, average) for real motion blur. Instanced mesh for the cloner, the wave as a closed-form function of (distance, t). Hero springs are closed-form damped oscillators, no stateful physics.
+
+## Watch out
+Browser render cost: cap sub-frames and instance counts. Muddy transmission on dark backgrounds. SSS is faked, tune with a rim light. Without DOF and motion blur it reads as a game engine.

package/skills/video-studio/references/styles/anime-light.md

@@ -0,0 +1,55 @@
+# Anime Light (volumetric cel)
+
+- id: `anime-light`
+- Source: huashu-art-motion `35_shinkai.md` (MIT)
+- Best for: romantic or nostalgic brand films, travel, music visuals, summer campaigns, product reveals with a sky
+- Not for: flat UI, data, gritty or dark-edgy brands
+- Triggers: makoto shinkai, your name, anime sky, lens flare, god rays, cumulonimbus, cel shading, golden hour, anime light
+- Tone cell: calm-soft
+- Clock: smooth 30/60 fps
+
+## Look
+A near-realistic background (cool-warm wall gradients, window frames, wires, rooftops) lit by a huge sky, with cel-shaded subjects on top.
+- Skin `#ffe8dc / #f2b6a8`, hair highlight `#f8d681 / #d8a050`, white `#fbfbfe / #b9c3dc`, navy `#2c3a66 / #1b2446`, line `#6a4632` at 2.2 px.
+- Cloud silhouettes `#b7c6e6` to `#8297c6` with bright white cores toward the sun.
+- Light comes from the window: shadow falls lower right (light dir -1, -0.55). Backlit subjects (against a window) put shadow below and add a thin warm rim `rgba(255,220,160,0.55)`.
+- Eyes: white 8x12, vertical iris gradient `#1f3f7a` to `#3f7fd0` to `#9fd4ff`, two highlights.
+- Final grade: bloom plus soft-light split toning (cool shadows, warm highlights).
+
+## Motion
+- Clouds boil and drift at about 10 px/s, each puff breathing `0.05*sin(1.3t)`.
+- Light shafts pulse `0.75+0.25*sin(3.4t)`, 60 dust motes twinkle.
+- Lens flare: sun core radius 130, 10 spikes rotating 0.25 rad/s, a horizontal streak 840x4, five hexagon ghosts along the sun-to-center line.
+- A droplet slides down glass leaving a trail; sheer curtain and its shadow sway; birds flap; hair moves in wind.
+- Transition family: a diagonal sweep of light flare, bright band with streaks and ghosts, wipes the old frame.
+
+## Signature features (judged against these)
+- Hard-edged cel shadow shifted off the shape toward the lit side (evenodd clip), plus a rim line.
+- Cumulus clouds from silhouette, offset bright core and a blur plus sharp double layer.
+- Triangular or wedge light shafts with floating dust.
+- Hexagonal flare ghosts aligned on one axis.
+- Window-shaped light patches on floors and walls.
+- Bloom pass (render small, blur 6 px, screen at 0.28).
+- Sun inside the glass, never on the frame edge.
+
+## 10-second beat seed
+- 0-1.2s: wide sky, clouds already moving, shaft of light.
+- 1.2-6s: subject action, curtain, droplet, birds.
+- 6-7.5s (hero): sun peeks, flare sweeps across the frame.
+- 8.8-10s: hold with dust and cloud drift.
+
+## Sound
+Piano and strings with a pop-rock lift, 110-130 BPM. Airy shimmer on the flare sweep.
+
+## Build it in HyperFrames
+Canvas 2D layers or Three.js sky plane.
+- Cel function: clip to the shape, subtract the shape shifted by `(lx*sd, ly*sd)` (evenodd) for shadow; same with reverse shift for rim. Order: fill, shadow, rim, line, so occlusion is correct without hidden-line removal.
+- Clouds: draw all puffs as blue-gray silhouettes, add a bright radial 0.82r sphere offset toward the sun per puff, blur 3 px, overlay 55% sharp.
+- Cache light shafts blurred 18 px, composite with screen.
+
+## Watch out
+- Current weak spot: interior backgrounds lack detail density.
+- Sun on a window corner makes the flare spill onto the wall like a lamp. Keep it inside the glass, flare radius 130 or less.
+- One radial gradient per cloud with a rim arc reads as soap bubbles.
+- A full-width flare streak (1800 px) looks like a bug line. Keep it near 840 px at alpha 0.35.
+- Droplets drawn solid look like bubbles. Draw only a lower arc, alpha 0.22, and one highlight.

package/skills/video-studio/references/styles/aurora-glass.md

@@ -0,0 +1,40 @@
+# Aurora Liquid Glass
+
+- id: `aurora-glass`
+- Source: mg-styles-15 `prompts/12-aurora-glass.md` (MIT, Vincentwei1021)
+- Best for: AI product launch, premium software reveal, OS or app feature film, slow luxurious tech brand pieces
+- Not for: high energy, comedy, hand-made looks, anything fast
+- Triggers: glassmorphism, liquid glass, aurora, mesh gradient, frosted glass, blur gradient, iOS 26, AI launch, translucent, soft glow, premium tech
+- Tone cell: calm-soft
+- Clock: smooth 30/60 fps
+
+## Look
+Deep indigo-black base. 4-5 aurora blobs in adjacent hues only (violet, blue, cyan, magenta), blurred 80-150px, blended into a mesh gradient. 3-5% noise dither across the frame to kill banding. Frosted glass cards: backdrop blur about 30px (range 20-40), 5-10% white fill, 1px inner highlight at 30% white, large corner radius. Micro-UI inside (chat bubble, voice waveform, toggles). Light elegant sans for the title, for example an invented "Aurora, think in light". Dark base with bright blobs works better than a light base.
+
+## Motion
+Everything slow. Blobs drift on bezier paths, 20-40 second loops. Cards float in with parallax depth and slight 3D tilt. Micro-UI enters with opacity plus an 8px rise only. Easing is sine or near-linear breathing. The wow moment: a Liquid-Glass lens (true refraction, chromatic dispersion on the rim, specular edge) glides across and magnifies the aurora and cards. Nothing fast.
+
+## Signature features (judged against these)
+- Large blurred color blobs drifting slowly, adjacent hues only.
+- Glass cards with blur, 5-10% white fill, 1px 30% white edge, big radius.
+- Refracting lens with rim dispersion and specular edge.
+- 3-5% noise dither, no banding.
+- Sine or linear easing, text enters by opacity plus 8px rise.
+- Parallax depth and subtle 3D tilt on cards.
+- No sudden or fast motion anywhere.
+
+## 10-second beat seed
+- 0-1.2s: aurora already breathing, first card eases in.
+- 1.2-4s: cards float in with parallax, micro-UI animates.
+- 4-7s (hero at 60-75%): glass lens glides across, magnifying cards and aurora.
+- 7-8.5s: title fades in with the 8px rise.
+- 8.5-10s: hold, blobs still drifting.
+
+## Sound
+Ambient cinematic pad, soft shimmer, very subtle UI ticks.
+
+## Build it in HyperFrames
+WebGL2 shader for the aurora: sum of soft radial falloffs at Bezier/Lissajous positions, plus blue-noise dither. Glass cards in DOM with CSS backdrop-filter, or draw them in the same shader by sampling a blurred copy. Lens: SDF rounded shape that offsets the sample UV by the SDF gradient and splits RGB with slightly different offsets. Positions are closed-form sines of t, so every frame is deterministic.
+
+## Watch out
+backdrop-filter may not render in headless capture: test, and fall back to a shader blur. Banding in the dark gradient. Muddy colors if non-adjacent hues blend. Do not speed it up to fill time.

package/skills/video-studio/references/styles/bauhaus.md

@@ -0,0 +1,46 @@
+# Bauhaus Kinetic Poster
+
+- id: `bauhaus`
+- Source: mg-styles-15 `prompts/09-bauhaus.md` (MIT, Vincentwei1021)
+- Best for: beat-driven kinetic posters, music and festival intros, design-studio identity, exhibition promos
+- Not for: organic or soft subjects, long copy, character stories
+- Triggers: Bauhaus, geometric, Swiss, International Typographic, kinetic poster, grid, modular, Kandinsky, constructivist, primary colors, beat-synced shapes, p5.js
+- Tone cell: calm-sharp
+- Clock: smooth 30 fps (motion quantised to the 120 BPM beat grid)
+
+## Look
+Cream paper #F1E9DA, red #E03C31, yellow #F2B705, blue #1E4FA3, black #111. Strict modular grid (for example 240px modules). Basic geometry only: quarter circles, semicircles, triangles, squares. Heavy geometric sans, small caps tagline. Subtle paper tooth and slight print misregistration allowed.
+
+## Motion
+Everything anchors to the grid: every move is an integer number of modules, every landing on a grid line. 120 BPM (0.5s per beat), one module acts per beat: quarter circles rotate 90 degrees about a corner pivot, semicircles slide one module, triangles flip, squares split. Rotation pivots alternate between own centre, corner, and frame centre. Easing is power2.inOut or linear. No overshoot, mechanical is the feature. Phase-shifted cascade wave across the grid on the drop.
+
+## Signature features (judged against these)
+- Only circle, triangle, rectangle forms in red, yellow, blue, black on cream.
+- Every displacement is a whole number of grid modules.
+- One action per beat, hits on the 0.5s grid.
+- Rotation pivot alternates centre, corner, frame centre.
+- No overshoot, power2.inOut or linear only.
+- Phase-offset cascade across the grid.
+- Final freeze is a balanced poster with vertical heavy sans word and small caps line.
+
+## 10-second beat seed
+- 0-2s: grid lines draw, first red circle lands on a beat.
+- 2-6s: composition assembles, one module per beat.
+- 6-8s (hero at 60-75%): phase-shifted cascade wave across the grid.
+- 8-10s: freeze into the finished poster, type set ("BAUHAUS", "FORM, FARBE, FUNKTION"), hold with a tiny paper-grain drift.
+
+## Sound
+Minimal techno and clicks. Each flip is a pitched click or blip, kick on quarters, 120 BPM.
+
+## Build it in HyperFrames
+SVG or Canvas with GSAP on a module-based coordinate system (x = col * 240). Compute beat = t / 0.5 and drive each module's step with floor and an eased fraction of the beat. Cascade phase = (col + row) * beat offset. Cue sheet shared with the audio so clicks match the flips exactly.
+
+## Watch out
+Any overshoot or bounce breaks the style. Off-grid positions from sub-pixel rounding. Colour count creep. Keep the type grid-aligned too.
+
+## Art-history variant (huashu-art-motion `12_bauhaus`)
+- Ground: aged cream paper `#ebe3cf` with soft mottling, one diagonal hairline. Palette adds blue `#2a58b4`, light blue `#b9cee0`, gray `#c6c3bb`, orange `#ee8a2a` to black `#161514`, red `#d3262b`, yellow `#efc12f`.
+- Figures are circles, squares, triangles and thick rods with joint discs (cream disc, 5px black ring, black dot). No curved outlines.
+- Motif motion: a long pole sweeps like a clock hand about a fixed hub (28 to 49.5 deg, ease out); a grid of window cells swaps colors at 13 fps (6 of 16 cells, never black); concentric arcs pulse outward; a ball rolls with rotation = distance / radius.
+- Transition in: red, yellow and blue shapes rotate and scale up to cover the frame in 0.20s.
+- Watch out: derive grid cell size from the inner width minus gaps, or cells overflow.

package/skills/video-studio/references/styles/cel-boil.md

@@ -0,0 +1,41 @@
+# Hand-Drawn Cel Boil
+
+- id: `cel-boil`
+- Source: mg-styles-15 `prompts/05-cel-boil.md` (MIT, Vincentwei1021)
+- Best for: playful brand films, hand-made crafts, FX-driven stingers, anti-digital warmth
+- Not for: precise data, luxury minimal, glossy tech
+- Triggers: hand-drawn, frame by frame, cel animation, line boil, boiling lines, traditional animation, on twos, smear frame, cartoon FX, paper texture, Buck, Giant Ant
+- Tone cell: kinetic-soft
+- Clock: on twos (24 fps timeline, draws change every 2 frames; 1s for fast action, 3s on holds)
+
+## Look
+Warm cream paper ground with paper grain multiplied at 10-15%. Ink linework that boils. Fills slightly off-register like hand coloring. Palette of 3-4: ink black, tomato red, sunny yellow, cream paper. Hand-lettered title, also boiling. Cel FX (smoke puffs, sparks, star bursts, speed lines) drawn rather than generated.
+
+## Motion
+Animate on 2s (effective 12 fps) as the default, switch to 1s for fast action, 3s for still holds. Line boil: 3-4 slightly different line variants cycled every 2 frames (or noise displacement amount 2-5, size 50, re-seeded each 2 frames). Smear frame: stretch the object 150-300% along the move for a single frame. Anticipation and squash on the character. FX burst on top of the main animation as the transition.
+
+## Signature features (judged against these)
+- Lines visibly boil every 2 frames, never static.
+- On-twos rhythm with on-ones for fast action and on-threes for holds.
+- At least one smear frame, 150-300% stretch, lasting 1 frame.
+- Hand-drawn FX (smoke, sparks, stars, speed lines) layered on the main animation.
+- Paper grain multiply 10-15% across the frame.
+- Fills off-register from the lines.
+- 3-4 colour palette.
+- Title keeps boiling on the hold.
+
+## 10-second beat seed
+- 0-1s: matchstick strike, smear frame, spark.
+- 1-3s: flame spirit jumps out, anticipation and squash.
+- 3-6s: it dances on twos; FX burst with smoke, sparks, star bursts, speed lines.
+- 6-8.5s (hero at 60-75%): FX re-form into the hand-lettered title.
+- 8.5-10s: title boils on 3s, held.
+
+## Sound
+Playful jazzy pizzicato or xylophone bed with cartoon SFX (strike, fwoosh, pop, poof, sparkle), synced to the frame.
+
+## Build it in HyperFrames
+Canvas 2D custom brush: centreline plus a pressure curve turned into an outline polygon. Generate 3-4 seeded jitter variants per stroke and choose the variant by floor(frame/2) mod N. Hold time with floor(t*12) for twos. Paper texture as a multiply-blended image or seeded noise canvas. Everything is a function of the frame index and seeded random.
+
+## Watch out
+Jitter that is too large reads as shake, keep it subtle. Random without a seed breaks determinism. Do not smooth the stepped timing. Off-register fills should be small offsets (1-3px).

package/skills/video-studio/references/styles/chiaroscuro.md

@@ -0,0 +1,53 @@
+# Chiaroscuro Candlelight
+
+- id: `chiaroscuro`
+- Source: huashu-art-motion `32_rembrandt.md` (MIT)
+- Best for: drama, luxury and heritage brands, documentary intros, whisky or coffee, serious narration
+- Not for: bright playful products, flat explainers, kids' content
+- Triggers: rembrandt, chiaroscuro, candlelight, caravaggio, dutch golden age, dark portrait, tenebrism, oil painting lighting
+- Tone cell: calm-sharp
+- Clock: smooth 30/60 fps
+
+## Look
+Everything is painted in full light first, then a light map multiplies the whole frame so only a few pools of light remain.
+- Ambient floor rgb(30,21,13) (about 13% light).
+- Light pools stacked with lighter, then multiplied: window shaft (blurred wedge, alpha 0.8-0.95), window itself radius 330, face pool radius 250 alpha 0.95, chest 230 alpha 0.55, second subject 240 alpha 0.8, table 280 alpha 0.6, candle `190+40*flame` radius.
+- A rim "separation light" on the wall behind the dark side (radius 300, alpha 0.35) lifts the figure from the background.
+- Brown palette; heavy impasto only where light lands (hair, collar, porcelain, pearls, highlights).
+- Glaze: soft-light `rgba(200,140,60,0.35)`, craquelure alpha 0.28, grain density 0.05 alpha 0.12, vignette 0.75.
+- Lost edges: the subject layer is drawn once blurred 2.4 px, then overlaid sharp at 0.62.
+
+## Motion
+- Flame flicker `flick(t) = 0.5*noise(2.2t) + 0.25*noise(6.5t)`; light pools drift +/-14 px on `noise(0.9t)`.
+- Cloud shadow: `cloud = 0.5+0.5*sin(2.2t-0.6)` dims the window light by up to 35% while a dark patch crosses the glass at 260 px/s.
+- 70 dust motes visible only inside the shaft, 24-frame flicker; steam rises.
+- Transition family: an old-film iris, the picture closes to a black circle then pops open on the next scene.
+
+## Signature features (judged against these)
+- Full-frame multiply light map, dark 87% of the image.
+- Warm pools with one clear key, one dim fill.
+- Bristle-stroke impasto highlights (parallel hairs), not offset stripes.
+- Soft lost edges on the shadow side, sharp edges in the light.
+- Rim light on the background behind the shadowed side.
+- Flicker and cloud-shadow modulate the light, not the geometry.
+- Amber glaze and craquelure on top.
+
+## 10-second beat seed
+- 0-1.2s: near-black frame, candle flare, face emerges.
+- 1.2-6s: slow reveal of subject, dust in the shaft, cloud passes the window.
+- 6-7.5s (hero): light pool settles on the key object or title.
+- 8.8-10s: hold, flame keeps flickering.
+
+## Sound
+Low cello and lute, 55-70 BPM, room tone, soft crackle. Single warm swell on the reveal.
+
+## Build it in HyperFrames
+Canvas 2D: paint bright version, then build the light map on an offscreen canvas and composite with multiply.
+- Impasto stroke = `round(w/1.3)` parallel bristles, brightness +/-17, ends shortened 0-25%, line width 1.4-2.6, a shadow stroke at alpha 0.28.
+- Props go on their own layer after the brush pass. Do not copy back regions from the base image (rectangular patches).
+- Draw hands before cups so the oval does not cover the vessel.
+
+## Watch out
+- Current weak spot: figures read flat (review 5/10). This style most needs a redo that gives volume to subjects.
+- Three tidy offset lines for highlights read like a sticker or bandage. Use bristles.
+- Grain density 0.12 alpha 0.22 makes the face look dirty. Use 0.05 / 0.12.

package/skills/video-studio/references/styles/collage.md

@@ -0,0 +1,46 @@
+# Paper Cut Collage (stop-motion)
+
+- id: `collage`
+- Source: mg-styles-15 `prompts/06-collage.md` (MIT, Vincentwei1021)
+- Best for: music and street-culture shorts, editorial magazine motion, surreal brand teasers, poster-like end cards
+- Not for: clean corporate, data-heavy, precise product demos
+- Triggers: collage, cutout, cut-out animation, paper-cut, papercut, paper cut, stop-motion, stop motion, handmade, not AI-looking, Dada, surreal, torn paper, newspaper, halftone, zine, constructivist, scissor cut, Monty Python, Terry Gilliam, Soviet poster
+- Tone cell: kinetic-sharp
+- Clock: stepped 12 fps (some holds at 6 fps), rendered on a 30 fps timeline
+
+## Look
+Newsprint or kraft paper ground. Public-domain photo cutouts with a rough 2-4px white scissor edge plus halftone dots. Deep-space imagery spilling out of a flipped-open head. Bold constructivist red and black diagonal typography. Layer stack from back to front: paper texture, large color shapes, photo cutouts, handwritten doodles and tape stickers, grain adjustment layer. Disproportionate head-to-body sizes on purpose.
+
+## Motion
+All motion is held on a 12 fps grid (6 fps for some holds) for a stop-motion feel, with random plus or minus 2px position jitter as hand placement. Puppet-style joint rotation with anchors at shoulder, elbow, jaw. Mouth opens and closes with 2-3 swap frames. The top of the head flips open like a lid. Transitions: a hand slaps an element onto the page, torn-paper strips, or a full paper flip to the end card.
+
+## Signature features (judged against these)
+- White 2-4px scissor edge on every cutout plus halftone texture.
+- Motion visibly stepped at 12 fps (or 6), not smooth.
+- Plus or minus 2px placement jitter.
+- Jaw or mouth on a separate piece, flapping with sound.
+- Disproportionate surreal assembly.
+- Layered paper stack with grain on top.
+- Diagonal constructivist type in red and black.
+- Hand-slap or paper-flip transition.
+
+## 10-second beat seed
+- 0-1.2s: portrait slaps onto kraft paper, jaw flaps.
+- 1.2-4s: head lid flips open, space revealed, first objects spill out.
+- 4-7s (hero at 60-75%): flowers, birds, planets, pointing hands, rocket pile out; torn strips slide.
+- 7-8.5s: paper flip transition.
+- 8.5-10s: end card with diagonal headline, held with 6 fps jitter.
+
+## Sound
+Vinyl crackle, jazzy boom-bap bed, paper rustles, scissors snips, slaps, and a comic pop when the lid opens.
+
+## Build it in HyperFrames
+DOM or Canvas with PNG cutouts (public-domain or CC0, backgrounds removed in advance). White edge by SVG feMorphology dilate on alpha, halftone by an SVG filter or a canvas dot pass. Quantise time with t12 = floor(t*12)/12 and drive every animation from t12. Jitter is a seeded hash of (element id, t12 step). Paper grain as a multiply layer.
+
+## Watch out
+Smooth easing on the hold grid ruins the stop-motion feel. Do not use trademarked or recognisable-person photos, use public domain only. Halftone moire at export: keep dots larger than 4px.
+
+## Already built in Luckiest (reuse before building new)
+- **Showreel paper-cut look:** a `logo` scene with `"recipe": "showreel"` and `data-look="papercut"` on `<html>` (`luckiest-video-studio-showreel`). Gives torn edges from a fixed-seed SVG displacement filter, paper grain, hard offset shadows, white gaps between tiles, a seeded tilt of about 1 degree per piece, and a 12 fps stepped master timeline. Verbs: slide, drop, rotate, tumble, tip, swing, snap, lift, scatter. Never morph, fold, bend, draw in place or glide.
+- **Cards pack `01-paper-collage`** (`luckiest-video-studio-cards`): title, stat, section and lower-third cards in this look. Paper `#efe9dc` (kraft `#e6dcc4`), ink `#17130e`, one signature blue `#4F8CFF` per beat, red `#e23b2e`, sticker orange `#f26a1b`, serif headlines (Fraunces). Image slots render as halftone cutouts with a colored sticker outline until a real image goes in.
+- Use the showreel look for the brand-film or logo scene and the cards pack for titles and stats, so the whole video shares one paper, one ink and one 12 fps clock.

package/skills/video-studio/references/styles/comic-pop.md

@@ -0,0 +1,49 @@
+# Comic Pop (Ben-Day dots)
+
+- id: `comic-pop`
+- Source: huashu-art-motion `13_pop.md` (MIT)
+- Best for: sale and promo spots, social shorts, youth brands, product comparisons, reaction clips
+- Not for: luxury, calm wellness, serious finance
+- Triggers: pop art, lichtenstein, warhol, comic book, ben-day dots, halftone, speech bubble, onomatopoeia, four-panel
+- Tone cell: kinetic-sharp
+- Clock: on twos (color swaps about every 5.5 frames, shake locked to 30 fps)
+
+## Look
+Flat primaries with thick black outline (5 px) and no gradients.
+- Black `#141414`, paper `#f3eedb`, blue `#2f5cc8`, yellow `#f7d52c`, red `#d8232a` / `#a8161c`, white `#fbf8ee`.
+- Skin tone is `#fae0cc` with red dots (`#e2483c`). Four swap palettes for panels: `#9ccf3a #e0359a #2fc0b0 #f08a2a`.
+Dots: blue background pitch 24, radius 5.6, 45 degree grid (diagonal spacing about 17 px); skin pitch 13, radius 3.3; a faint yellow print dot pitch 14, radius 2.2, alpha 0.18. Shadows are black diagonal hatching (10 px spacing, 3.5 px wide). Lettering is a bold comic face (Bangers) with 12 px black outline and a 4 px drop shadow. Compose in a panel with a heavy 6 px black frame.
+
+## Motion
+- Four-panel color swap: `step = floor(lt*11)`, panel i uses palette `(i+step)%4`, with a slightly misregistered black shadow plate for screen-print error.
+- Thinking dots: three dots in sequence, dot k is lit when `((f-2k) mod 12) < 4`, radius 20 vs 12, 6 px jump.
+- Sound-effect burst shakes: hash jitter +/-8 px, +/-6 px, +/-0.03 rad at 30 fps; 10 black action lines pulse `0.85+0.25*sin(40t+2i)`.
+- Subject squash and wiggle at 6 Hz, weight by distance from the pivot.
+- Transition family: a lightning-bolt flash that turns the old frame into dots, then reveals the new panel.
+
+## Signature features (judged against these)
+- Dots are screen-aligned (a pattern fill), they do not swim with moving subjects.
+- Thick black outline plus flat fill on everything.
+- Hatching for shadow, white short strokes for highlight.
+- Burst shape with two layers (white outer, yellow inner) and lettered effect text.
+- Color-swapped repeat panels with a black misregistration shadow.
+- Hair or large shapes built from a union outline (stroke all black first, then fill all).
+
+## 10-second beat seed
+- 0-1.2s: panel slams in with a burst and effect word.
+- 1.2-4s: thinking dots, subject wiggle.
+- 4-7s (hero): four-panel color swap at 11 Hz with the key message.
+- 8.8-10s: freeze on one panel, burst keeps shaking.
+
+## Sound
+Brass stabs and a snare, 120-140 BPM. Comic "pop" SFX per swap, whoosh on the bolt transition.
+
+## Build it in HyperFrames
+Canvas 2D `createPattern` for dots: a small tile with 5 circles (four corners plus center) gives a 45 degree grid at near-zero cost, much faster than per-dot pixel sampling.
+- Cache the static panel layer; draw with one `ink(path, fill, lw)` helper for all outlined shapes.
+- Union outlines: stroke all sub-shapes at double width in black, then fill them all.
+
+## Watch out
+- In the source this style scored top marks with no weak spot logged (index shows none).
+- A large shape filled with one flat color reads like a cloth. Add the interior curl lines and black arcs for the sculpted comic look.
+- A subject drawn in its resting position can float above a crouched pose. Move the head down into the body when squashing.

package/skills/video-studio/references/styles/constructivist.md

@@ -0,0 +1,54 @@
+# Constructivist Poster
+
+- id: `constructivist`
+- Source: huashu-art-motion `22_constructivism.md` (MIT)
+- Best for: bold announcements, campaign slogans, manifestos, rallies, protest or movement style, tech-ops "state of" posts (narrow use)
+- Not for: soft lifestyle, luxury, children's, long reading
+- Triggers: constructivism, rodchenko, lissitzky, soviet poster, red and black, propaganda poster, agitprop, photomontage, slogan
+- Tone cell: kinetic-sharp
+- Clock: smooth 30/60 fps
+
+## Look
+Aged paper (`#e9dfc4`, dark `#d9c9a4`) with diagonal black bars, a red square, thin slanted lines, a big black circle behind the focal subject and a slanted red floor (12 px black top edge).
+- Red `#c8231c / #8f1711`, black `#151311`, cream `#f4ecd6`, accent gold `#e3b03e`.
+- Photos are grayscale halftone: variable-diameter dots at 45 degrees (cell 4.6 for faces, 7 for scenery, gain 0.74-0.8), set on cream with a 7 px cream cut-out border like a clipped photograph. Hand-drawn clean black lines (a tower, lettering) sit on top of the halftone for a photo plus drawing collage.
+- Clothes are flat cut paper with 3 px black lines; shadows are dot patterns.
+- Lettering is geometric, drawn from rectangles and polygons on a 5x7 module grid (Cyrillic-style blocks), vertical lettering allowed. Each part is filled separately.
+
+## Motion
+- A red wedge stabs into the black circle: apex moves along a 0.34 rad axis, `70*(0.5-0.5*cos(2*pi*1.6*t))`.
+- Dashed red ring around the circle: dash [46,22], `lineDashOffset = -260*t`.
+- Radio-wave arcs from the tower top: `r = 18 + ((1.4t + k/4) mod 1)*230`, alpha and width fade.
+- Slogan stamps letter by letter (0.045 s apart, 1.5x to 1x in 0.12 s) then a wave `-10*max(0, sin(11t-0.8k))`; every fourth letter black.
+- Headwear tails sway `sin(9t)*6`; steam is three black polylines going up.
+- Transition family: not specified in the source (the style opened its sample film).
+
+## Signature features (judged against these)
+- Diagonals, circle, wedge and block shapes in red, black and cream only.
+- Halftone photograph with a clipped cream border.
+- Geometric block lettering with the letters drawn as paths.
+- Slogan text overlaps the figure (poster lettering sits on top).
+- Red wedge into black circle.
+- Heavy text bars and line rules.
+- Aged paper noise.
+
+## 10-second beat seed
+- 0-1.2s: slogan blocks slam in with stamp sound.
+- 1.2-5s: wedge stabs the circle, rings and radio waves pulse.
+- 5-7s (hero): the slogan bounce wave.
+- 8.8-10s: hold, wedge keeps moving.
+
+## Sound
+Marching snare and brass stabs, 110-128 BPM, a stamp hit per letter. Distorted radio crackle.
+
+## Build it in HyperFrames
+Canvas 2D, base layer cached.
+- `halftone(src, cell, gain, angle)`: sample a rotated grid, dot diameter `cell*gain*sqrt(1-L)`, only where alpha > 128, all dots in one path filled once (about 3,000 dots for a face, under 2 ms).
+- Letters: each part one fill; letters that overlap in one path cancel under nonzero fill (an A read as a B).
+- Place text by glyph center, not baseline, to avoid cut-off descenders.
+
+## Watch out
+- Current weak spot: missing the horn-shaped text cone (megaphone shape) typical of the style; consider red and black wedge text radiating from the subject.
+- Breve and diacritic marks drawn above the letter cell get covered by neighbors. Draw the whole glyph inside its 7 cells.
+- Shadows under the cheeks looked like a beard after halftone. Use about half the flat alpha in the gray source.
+- Narrow use: it looks forced on warm or playful subjects.

package/skills/video-studio/references/styles/cubist.md

@@ -0,0 +1,49 @@
+# Cubist Facets
+
+- id: `cubist`
+- Source: huashu-art-motion `11_cubism.md` (MIT)
+- Best for: art-forward brand films, music, multi-perspective stories ("many sides of..."), fashion, newspaper and collage looks
+- Not for: friendly softness, children's content, clean UI
+- Triggers: cubism, picasso, braque, analytic cubism, faceted, fragmented, collage, newsprint, multiple viewpoints
+- Tone cell: kinetic-sharp
+- Clock: on twos (stencil text steps at 12 fps, facet boil 8 fps)
+
+## Look
+Transparent overlapping planes in a brown, ochre and gray-blue range: paper `#d6c8ac`, cream `#ece3cf`, ochre `#b8975f`, brown `#6e5538`, dark brown `#3a2c1e`, gray `#a8a395`, blue-gray `#8e9eab`, deep gray `#5a5852`. Window views `#c9d3da #8fa3b3 #e4e6e2 #6f8597`. Planes are polygons with a three-stop linear gradient (cream-mixed 25%, base, dark-mixed 40%), alpha 0.18-0.7, with 46 thin straight passage lines (1.3 px) running through all of them. A fine short-dash sand texture (9,000 dashes, 3-8 x 1.5 px) gives a gritty surface. Faux wood grain and woven chair patterns appear as textures. Compose for the subject but overlap shapes the same way.
+
+## Motion
+- The same background view is shown in several panes, each offset by `dx = sin(9t+1.7i)*18` (plus 10 fps jitter +/-3) so it reads as multiple viewpoints.
+- Stencil lettering swaps order at 12 fps, each letter jumps +/-13 px and tilts +/-0.11 rad.
+- Newspaper block trembles at 8 fps (+/-0.0125 rad), corner flips on `sin(20t)`.
+- Subject facets re-jitter at 8 fps (vertices +/-8% of cell, 16-35% of triangles flicker +/-12% light).
+- Transition family: geometric shards slide and reassemble into the next picture.
+
+## Signature features (judged against these)
+- Triangles are not clipped to the silhouette, so planes overflow the outline.
+- Large facet cells (about 58 px) for the body, finer cells (26 px) for hair or small things. 34 px reads as low-poly 3D.
+- Straight-line outlines with ends sticking out 10-16 px.
+- Face with a profile plus a front-view eye (two viewpoints at once).
+- Stencil text with cut gaps that show the planes below.
+- 5 translucent planes (alpha 0.2) overlap the subject so it sits inside the space.
+- Dark brown masses balance the light planes.
+
+## 10-second beat seed
+- 0-1.2s: planes slide in, stencil word lands.
+- 1.2-6s: panes show shifting viewpoints, subject facets boil.
+- 6-7.5s (hero): planes lock into a clean facing view with the title.
+- 8.8-10s: hold with small boil.
+
+## Sound
+Muted jazz piano and upright bass, 90-110 BPM, paper-rustle hits on shard moves.
+
+## Build it in HyperFrames
+Canvas 2D.
+- Facetize: fill the subject flat offscreen, read pixels back, jitter a triangle grid (random diagonal per cell), color each triangle from the centroid with brightness `*(0.8+0.38*rand)` and a light-to-dark gradient, draw without clipping, skip triangles whose centroid alpha is below 120.
+- Cache the plane background; animate only the panes, text, newspaper and subject.
+- Use `getContext('2d',{willReadFrequently:true})` and call `g.reset()` at the start of every frame.
+
+## Watch out
+- Current weak spot: image runs bright; the style wants more large deep-brown masses and stronger light-dark contrast.
+- Frame 0 can differ from later frames: offscreen GPU readback and leftover context state (lineJoin, lineCap) change antialiasing and colors. Fix with `g.reset()`, not `clearRect`.
+- A hair-only second pass with a circular clip colors half the face gold. Filter by color instead.
+- Sleeves need to be darker than the body color or they vanish into the facets.

package/skills/video-studio/references/styles/cut-paper.md

@@ -0,0 +1,57 @@
+# Cut Paper Collage
+
+- id: `cut-paper`
+- Source: huashu-art-motion `30_matisse.md` (MIT)
+- Best for: playful brand films, children's and education, kitchen and craft, festival promos, bold simple shapes
+- Not for: realism, fine data, dark moody pieces
+- Triggers: matisse, cut-outs, paper collage, papier decoupe, gouache paper, jazz book, scissors, paper shapes
+- Tone cell: kinetic-soft
+- Clock: smooth 30/60 fps
+
+## Look
+Saturated flat shapes with scissor-cut edges, pinned to a wall.
+- Double blue checker `#1d4fb8 / #4f95dc` (cells about 240 x 236), emerald `#1f9a5a`, black, yellow, red, pink, white.
+- Edges: sample the outline every 14-24 px, add +/-2-2.5 px seeded jitter, join with straight lines. Never perfectly smooth curves.
+- Paper shadow: offset (5,6), blur 4, `rgba(10,20,40,0.3)`, so shapes look pinned.
+- Gouache brush texture on top: 2,600 long streaks (60-300 px, 6-22 px wide, alpha 0.04-0.13, tilt -0.25 rad), black and white half each, overlay.
+- Characters are built only from paper pieces: black almond eyes, red lip triangle, pink cheek circle, curled hair shapes.
+
+## Motion
+- Seaweed-like leaf shapes sway about their root: `sin(2.8t+phase)*0.13` with edge curl breathing scaleX 0.93-1.0.
+- Stars rotate and flicker: scale `0.82+0.22*sin(7t+1.9k)`, a black figure bobs, a red heart beats `1+0.18*max(0,sin 9t)`.
+- Birds flap with scaleY `0.55+0.45*cos(13t)`; a pink paper flips and falls (scaleX = cos 6t).
+- Steam is two small white paper strips.
+- Transition family: a blue paper sheet with pinned shapes (seaweed, stars, red discs, each with shadow) sweeps across, revealing the next scene.
+
+## Signature features (judged against these)
+- Edges are straight segments with jitter, never smooth bezier.
+- Union fill for lobed shapes: one tapered stem plus 2 x lobes capsule fingers (angle `+/-(1.05-0.55u)`, length `w*(1-0.45u)`, width `w*(0.34-0.12u)`) added into one Path2D.
+- Soft drop shadows only under paper pieces.
+- Saturated flat colors, no gradients.
+- Gouache streak overlay.
+- Character features are separate cut pieces.
+- Motion is rigid paper rotation, flip and scale, not bending.
+
+## 10-second beat seed
+- 0-1.2s: paper pieces drop in with a pinned shadow.
+- 1.2-6s: leaf sway, star flicker, one flying sheet.
+- 6-7.5s (hero): sweeping paper transition lands on the key message.
+- 8.8-10s: hold, small sway continues.
+
+## Sound
+Bright ukulele or clarinet and hand claps, 100-120 BPM. A paper "flick" SFX on each swap.
+
+## Build it in HyperFrames
+Canvas 2D or SVG.
+- `cut(points)` helper for scissor edges applied to every generated shape.
+- For photographic or rendered inputs, apply a static pixel displacement field `fbm(0.028x,0.028y,2)*9` to fake cut edges (about 15 ms).
+- Build compound shapes with `addPath` into one Path2D so the shadow is computed once.
+
+## Watch out
+- Current weak spot: the gouache brush streaks run slightly heavy.
+- "Modulating width along a spine" for lobed shapes yields caterpillars and zigzags. Use the capsule-finger method.
+- Falling paper that crosses the subject's face is distracting. Route it along a wall.
+- Black text on blue paper needs a white paper patch behind it.
+
+## Related
+For torn-edge, stop-motion paper (rather than smooth pinned cutouts), use `collage`, which reuses the showreel paper-cut look and the `01-paper-collage` cards pack.

package/skills/video-studio/references/styles/era-styles.md

@@ -0,0 +1,29 @@
+# Era Styles (history speedruns, time travel, tributes)
+
+- id: `era-styles`
+- Source: huashu-art-motion `INDEX.md` era table and recipes (MIT)
+
+These 18 looks are tied to one period or one artist and read as a costume on other topics. Use them for art-history speedruns (the style changes, the scene stays), time-travel montages, "a brief history of X", and tributes. For any other subject use a material-layer card instead (impressionist, cut-paper, ink-wash, comic-pop and the rest). Each era runs 0.25-1.4 s inside a speedrun, so the motif motion must read inside that window. Aging marks (peeling, stains, scratches) go on the background only, never on the subject. Compose each film for its own subject; the source samples all share one fixed room layout, which is a property of that film and not of the styles.
+
+Quality ratings come from the source (3 stars = recognizable on sight, 2 = recognizable with a visible gap, 1 = redo).
+
+| id | name (generic) | triggers | renderer + brushwork | motif motion | signature transition | watch out |
+|---|---|---|---|---|---|---|
+| `cave-painting` | Cave wall painting | cave art, lascaux, 40000 bc, prehistoric, charcoal, ochre | noise relief rock wall lit from the upper left, charcoal dot-fuzz outlines, ochre pigment sunk into the rock; negative handprints sprayed with dots | two-pose galloping animals swapping every 7 frames, firelight flicker (overlay, not additive), drifting embers | none (opening look) | human figures too cartoonish, not primitive enough; heavy mid-frequency relief turns into camouflage |
+| `egyptian-mural` | Tomb mural | egypt, hieroglyph, pharaoh, tomb painting, papyrus | profile body with front-view eye, flat fill with thin outlines, 24 hand-drawn hieroglyphs | scarab pushing a sun disc, sun-ray hands opening and closing, glyphs re-drawn stroke by stroke | tapestry strips drop in with a bounce | elbow when lifting a cup is stiff |
+| `greek-vase` | Black-figure pottery | greek vase, attic, black-figure, amphora, meander | black silhouettes with incised clay-color lines, purple-red bands with white dots | meander border scrolling in reverse, ship bobbing with leaping dolphins, lyre swinging | vase rotates like a cylinder to the next face | skirts read too thick |
+| `illuminated-manuscript` | Gilded manuscript | gothic, medieval, illuminated manuscript, gold leaf, book of hours | per-pixel gold leaf (brushed streaks, embossed 1 px bright lines), gold-hue mask for highlights, parchment | diagonal gold glint sweeps, vines sway, snail crawls, mouse runs in the margin | parchment page turn | blond hair reads like a hood |
+| `renaissance-sfumato` | Sfumato oil painting | renaissance, da vinci, mona lisa, sfumato, old master | whole layer lightly blurred plus a high-opacity sharp layer, craquelure, canvas weave, yellow varnish | flying-machine glides past, river glints, floating dust | god-ray through a window | subjects too cartoonish, overall too still |
+| `art-nouveau` | Art nouveau poster | art nouveau, mucha, belle epoque, ornamental halo | variable-width path lines (thick outside, thin inside), offset silhouette underlay | sun rising, halo ring rotates, flowers sway, S-curve steam, hair waves | gold-edged organic shape grows over the frame | pose stiff |
+| `gold-ornamental` | Gold-period ornament | klimt, the kiss, gold ornamental, byzantine gold, viennese secession | gold leaf reused, spiral and eye-shaped patterns on flat robes against a realistically shaded face; sparse metal-leaf specks | eye motifs blink in turn, gold dust floats up (26 px/s), flakes flip as they fall, light streak sweeps at 520 px wide | gold leaf blocks spiral outward from the subject (72 px tiles, spiral key) | hand not connected to the sleeve; spirals on the face look like a rash |
+| `expressionist-scream` | Expressionist distortion | munch, the scream, expressionism, anxiety, wavy sky | long curved flow-line strokes (200-300 px, width 9-13) plus a per-row sine warp of the whole world | entire picture writhes, blood-red sky flows | scream color bands (`#b82a1e #e2541c #f08a24 #f4c03a`) press down from the top, old frame warped by rows | walls were read as the swirl-brushwork style; lengthen strokes and lower opacity to separate them |
+| `temple-mural` | Cave-temple mural | dunhuang, buddhist mural, silk road, apsara, flying figures | earth-red ground with mineral colors, flaking patches only on the background, desaturation | flying figures' ribbons float, ceiling drifts, lamp flame flickers | ribbons sweep across, old picture peels and falls off in chips | figure drawing is crude; flaking on a back reads like clothing holes |
+| `polka-infinity` | Polka-dot infinity | kusama, polka dots, pumpkin, infinity mirror room | hand-drawn irregular circles, hex grid wrapped at the true pattern period | dots swell and shrink in rings from a point, pumpkins, mirror-room repeat | dots grow, each clipping a window onto the new picture (58 px grid) | subject and wall in the same color depend on silhouette |
+| `surreal-melt` | Surreal melting | dali, surrealism, melting clock, persistence of memory, long shadows | soft-clock warps, long sheared shadows | clocks sag, long-legged elephants walk, ants circle a watch, shadows lengthen | new picture drips down with round-headed droplets (26 drips, 0.36 s) | subject reads as vector clip art |
+| `hard-light-realism` | Hard-light realism | hopper, american realism, nighthawks, sunlight shaft | two lit versions of the scene clipped by hard-edged sun blocks (bright and dark) | sun patch slides across a face, a shadow figure mirrors the action | hard-edged sunbeam sweeps across (0.34 s) | subject stuck in shadow for the whole shot |
+| `space-comic` | Silver-age space comic | kirby, marvel, jack kirby, krackle, space comic | four-color halftone, color-plate misregistration, feathered black-shadow hatching, krackle energy dots | big sound-effect text, close-up panels, energy dots | none (opening look) | closer to pop art than to the real thing; lacks perspective and blocky hands |
+| `water-lily` | Water-lily pond | monet, water lilies, japanese bridge, reflections | short horizontal strokes for water, reflected light shimmering | lilies drift, willow shadows sway, ripples spread | ripples from a point, old picture shifted by sine rows; new one revealed by 3,600 short horizontal strokes | wall-as-pond and floor-as-wood is a spatial clash |
+| `street-line-art` | Bold line figures | keith haring, graffiti, radiant baby, dancing figures | thick black monoline, radiating action lines | dancing figures cut at 8 fps, everything bounces on the beat | a dancing figure scales up with the new picture inside its body (scale `0.15*320^easeInOut(p)`) | subject not stylized enough |
+| `rubber-hose` | 1930s rubber-hose cartoon | rubber hose, steamboat, cuphead, vintage cartoon, 1930s, betty boop | pie-cut eyes, noodle limbs, white gloves, 12 fps stepped, film scratch and flicker | everything bounces on the beat | old film iris: sepia and contrast build, black circle closes then pops open with outBack | most of the motion is film noise, not animation |
+| `shadow-puppet` | Chinese shadow puppet | shadow puppet, pi ying, leather puppet, paper theater, backlit screen | translucent hide cut-outs, rivet joints, 10 fps stepped, lamp behind the screen | rod-driven stiff joints, wrists flick | lamp lights behind the screen (old frame dims with multiply, new one revealed by a radial mask) | overlaps multiply to black; 121 ms per frame is slow |
+| `blue-period` | Blue-period monochrome | picasso blue, blue period, melancholy, monochrome blue | single blue tone, wide brush strokes, Prussian-blue outlines, elongated bodies | slow breathing | color is drawn out to blue, then a wide dry brush sweeps (6 slanted strokes, bristle lines in the wake) | shapes are not melancholy enough |