luckiest-co 1.0.41 → 1.0.42

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 |

package/skills/video-studio/references/styles/finance-chart.md

@@ -0,0 +1,60 @@
+# Editorial Data Chart
+
+- id: `finance-chart`
+- Source: huashu-art-motion `references/动画语法/t3_finance_chart.md` (MIT)
+- Best for: revenue, profit, user counts, price trends, market share, regional comparisons, before and after an event. Segments where viewers will screenshot and check numbers. 2.5-6s per chart, 30-90s total.
+- Not for: a single number (use a big-number reveal), unreliable or unsourced data, explaining a mechanism.
+- Triggers: economist chart, financial times chart, ft chart, bloomberg, data journalism, revenue chart, bar chart race, candlestick, stock chart animation, finance explainer, earnings growth
+- Tone cell: calm-sharp
+- Clock: smooth 30/60 fps
+
+## Look
+- Base: white `#FFFFFF`, warm salmon `#FFF1E5`, or dark `#0E1116` with light text and a teal main bar. The chart base matches the surrounding video's color family. A white report page dropped into a dark film reads as disconnected.
+- Layout: thin red top rule (8px), small red tag at top left (96x22), bold headline stating the one conclusion, subtitle with metric and unit, source line bottom left.
+- Palette: red `#E3120B`, blue `#006BA2`, cyan `#3EBCD2`, green `#379A8B`, yellow `#EBB434`, grey `#758D99`, black `#0C0C0C`.
+- Emphasis: one color tells the story, everything else drops to light grey (`#C6D2D8`).
+- Grid: horizontal lines only, thin grey (alpha 0.13, 1.5px). Only the zero baseline is solid black (3px). Tick values sit on the right above their lines.
+- Type: condensed sans for numbers, bold headline 700, regular subtitle 400. Axis text smallest, source smallest and lightest.
+- Up and down colors: state them on the chart. Red-up/green-down in East Asian markets, green-up/red-down in Western ones. A colorblind-safe option is blue/orange with up and down triangles.
+- Line width 5px for the main line, 4px averages, 2px callout leaders. Fictional data carries a "sample data" badge on every shot, real data never does.
+
+## Motion
+- Order: layout 0-0.5s, grid lines draw left to right (lag 0.12s, ease-out-quint), x labels fade up, then data, then color emphasis, then the annotation. Each stage 0.5-1.3s.
+- Bars grow from the zero baseline with ease-out-quint, staggered 0.22s, value label rides the bar top and counts in sync.
+- Lines draw by x (time), not arc length, so steep sections draw fast. Head dot 9px with a following price label, area fill alpha 0.14 to 0.
+- Annotation fires the moment the line head passes the event: dot pops (spring 0.45s, bounce 0.25) with a pulse ring, leader draws 0.12s later, text fades 0.3s later. One annotation per shot.
+- Candles appear one by one (lag 0.06s), body then wick, volume in sync.
+- Counts use ease-out-expo over 0.9-1.3s with tabular digits. Hold at least 0.5s after a number lands.
+- Camera stays still. A slow 1s push to a data point or 0.7s glide to the next group, with a fast 0.28s push for the single most important number.
+
+## Signature features (judged against these)
+- Headline is a single conclusion and the multiples in it can be recomputed from the chart (a / b shown in the annotation).
+- Bars start at zero. A line axis that does not start at zero says so in the subtitle.
+- Axes and grid appear before the data.
+- Each data point lands on the spoken number.
+- One highlight color, everything else grey, red/green meaning labeled.
+- One annotation per chart shot.
+- No bouncing bars, 3D bars, or rotating pies.
+- Unit and source are written on the chart.
+
+## Beat pattern (30-60s)
+- 0-4s: chart frame (rule, tag, headline, empty axes). Headline states the conclusion.
+- 4-20s: one chart per one or two voiceover sentences. Bars or line grow when named.
+- 50-70%: pivot to the key figure. Push in to the final bar or the event point, annotation pops with the ratio (for example "130.5 / 16.7").
+- Optional swap: change layout (bar to line) only for the same metric, move first then reshape. Never morph between different metrics.
+- Last 4-6s: one clean frame with the conclusion, source visible, hold 0.8s or more.
+
+## Sound
+Light low-key pulse or soft pad, no big beat. Small tick as each bar lands, clean tone on the final number. Voice sits on top.
+
+## Build it in HyperFrames
+- SVG or Canvas 2D with seeded data. Scales have an inverse so you can compute `tHit = start + duration * smooth^-1(x fraction)` for the annotation trigger.
+- Tick generator uses 1, 2, 2.5, 5 times 10^k, and pads one tick above and below the data range so bars never leave the axes.
+- Panel push transition: new panel slides in from the right with a thin red bar leading, 0.5s on `cubic-bezier(.7,0,.2,1)`, and starts building its layout during the slide.
+- Zoom into a local area: camera redraws vector content, never scales a bitmap.
+
+## Watch out
+- Truncated bar axes, too many colors, every series highlighted.
+- "Rose to 8.7x" is not "rose by 8.7x". Check the wording against the numbers.
+- Animation so busy the value cannot be read.
+- Three identical chart layouts in a row. Insert a push to a detail, a big number, or real footage.

package/skills/video-studio/references/styles/flat-vector.md

@@ -0,0 +1,41 @@
+# Flat Vector Explainer
+
+- id: `flat-vector`
+- Source: mg-styles-15 `prompts/01-flat-vector.md` (MIT, Vincentwei1021)
+- Best for: SaaS explainer, product launch, annual report, science explainer, brand film in one continuous shot
+- Not for: photoreal products, moody or cinematic tone, anything needing gradients or texture
+- Triggers: flat design, vector, explainer, 2D motion graphics, corporate explainer, Material design, shape wipe, bouncy, brand film, Buck, Motion Ocean, Google explainer
+- Tone cell: kinetic-soft
+- Clock: smooth 30 fps
+
+## Look
+Solid color blocks only, no gradients, no or minimal stroke. Bold 5-6 color palette: ultramarine #2B2BFF, coral #FF5A4E, sunflower #FFC62B, mint #2EE6A8, cream #FFF6E9, ink #151433. Geometric characters (circles, rounded rects, limbs as capsules). Clean negative space. Rounded heavy sans for titles. All elements are vector shapes. Shape wipes use full palette colors, never white flashes.
+
+## Motion
+Elastic overshoot is the soul: cubic-bezier(0.34,1.56,0.64,1), or a bezier with 70-85% influence handles. Every entrance is anticipation, burst out, rebound. Stagger entrances 2-4 frames, each element with its own mini overshoot. Squash and stretch about 10% on moves. Only one hero moves at a time. Secondary action and follow-through on limbs, birds, clouds. Transitions are element-driven: a shape expands to fill the frame (shape wipe), or an object flies out and carries the cut. One continuous shot: push into a window, into a phone, into a bubble.
+
+## Signature features (judged against these)
+- Zero gradients, 5-6 flat palette colors only.
+- Entrances use anticipation then overshoot (about 1.1x scale) then settle.
+- Building or icon stagger of 2-4 frames.
+- 10% squash and stretch on moving shapes.
+- Limb rig with anchor-point rotations, head bob, blink.
+- At least one shape-wipe or element-carried transition, no crossfades.
+- One hero moves at a time.
+- Logo lockup assembled by elements flying in, held 1s with micro-motion.
+
+## 10-second beat seed
+- 0-1.2s: empty color field, one saturated circle drops in, stretch, squash, overshoot, settle.
+- 1.2-3s: circle becomes a sun, flat city pops up building by building, clouds slide, birds flap.
+- 3-5.5s: camera pushes into one window, geometric character at a desk reacts, phone pings.
+- 5.5-8s (hero at 60-75%): notification bubble expands as a shape wipe, icons burst in on rhythm (bars grow, check draws, heart pops, coin flips).
+- 8-10s: everything collapses into an invented brand lockup plus tagline, elastic settle, hold 1s with micro-motion.
+
+## Sound
+Upbeat future-bass or pop, about 120 BPM. Pop, boing and whoosh on every entry, synced to the frame.
+
+## Build it in HyperFrames
+SVG composition driven by GSAP with a paused timeline seeked per frame. Put the overshoot curve in a CustomEase or the bezier above. Use nested groups with transform-origin set to joints for limb rigs. Shape wipes are a scaled circle or rect in a palette color. For motion blur on fast moves, render sub-frames (about 4) and average, or skip blur and keep moves short.
+
+## Watch out
+Template look is the main failure: same icon-burst grid, no idea. Avoid more than one hero moving. Keep every color from the palette. Do not let gradients sneak in through shadows. Check kerning on the lockup.

package/skills/video-studio/references/styles/grain-flat-illustration.md

@@ -0,0 +1,48 @@
+# Grain Flat Illustration
+
+- id: `grain-flat-illustration`
+- Source: huashu-art-motion `16_2026.md` (MIT)
+- Best for: SaaS explainers, app launches, character-driven stories with a joke payoff, social shorts, onboarding
+- Not for: photoreal products, heavy texture styles, dense data tables
+- Triggers: flat illustration, dribbble, grain texture, stipple shading, vector character, modern 2d, noise gradient, editorial illustration
+- Tone cell: kinetic-soft
+- Clock: smooth 30/60 fps (limited-animation snaps allowed on hits)
+
+## Look
+Pure color blocks with no outlines. Volume comes from a slightly deeper shade of the same hue (for example a lit sweater block `#f08b7d`, a leg shape with one darker arc `#f3ad4c`). Grain is the finish: 2 px square stipple dots whose density is a function of position, for example a pink disc `0.12 + 0.75*clamp((y-cy+120)/420)` (denser toward the bottom), lavender blocks and a sun denser toward lower right. Static grain is baked into a cache. Characters get a second static grain texture composited with source-atop (5% dark dots alpha 70, 3.5% light dots alpha 90) so grain lands only on them. Light cones are 26,000 stipple dots, width growing 56 to 150 with y, fading with distance. Compose with a big-head character ratio (head scaled about 1.2x around the neck).
+
+## Motion
+- Performance first: anticipation, squash, snap, overshoot, settle. Examples: crouch (sy 1 to 0.86, sx to 1.07), stretch on launch (sy 1.12), squash on landing (sy 0.86 to 0.70, sx 1.18) with the feet pinned to the surface.
+- Facing flips on the flattest frame (a snap, cleaner than a paper-turn).
+- Repeated hits: prep 7 frames, strike 4, hold 4, recover 8; lean amount grows with reach.
+- Falling object: gravity about 1.75 px/frame^2 at 60 fps, rotation `-0.12 - 2.3*q^1.3`, impact lines 8 frames, debris on parabolas, spill that widens then holds, two ripples.
+- Secondary motion by damped oscillators: `damped(F, start, amp, period, decay)`, for a hanging lamp (0.055 rad, period 26 frames) and plants.
+- Transition family: three-color concentric ring iris.
+
+## Signature features (judged against these)
+- No outlines anywhere.
+- Grain density varies with position (falls off toward light).
+- Character grain only on the character, not on the whole frame.
+- Deliberate squash and stretch with feet pinned.
+- Overshoot on arrivals, damped motion on environment.
+- Three-act gag: set-up, escalation, payoff, then a signature or logo stamp.
+- Background decorations boil at 4 fps (+/-1.5 px, +/-0.09 rad).
+
+## 10-second beat seed
+- 0-1.2s: character already doing something, title implied.
+- 1.2-5s: escalation, three repeated attempts that get bigger.
+- 5-7s (hero): the break or payoff with impact lines and debris.
+- 8.8-10s: smug or relieved pose held, signature writes on with a clip reveal.
+
+## Sound
+Light funk or lo-fi pop, 100-116 BPM. Foley hits on every squash and hit, a cartoon crash, a final soft bell.
+
+## Build it in HyperFrames
+Canvas 2D with a pose library. Pose = local key points; `mixPose` lerps numbers between poses.
+- Transform order: translate to center, rotate about feet or center, scale (squash about feet so they do not leave the ground).
+- When aiming a limb after applying a lean transform, convert the target with `c.getTransform().invertSelf().transformPoint(...)`.
+- Signature wipe: clip the text with the writing front moving over frames; underline in 24 segments tapering 3.4 to 1.4 px.
+
+## Watch out
+- No weak spot logged in the source. The main risk is a lifeless cut-and-paste character: keep secondary motion on everything.
+- Measured frame numbers are written at 60 fps; scale them if you render at 30.

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

@@ -0,0 +1,41 @@
+# Cyberpunk HUD (FUI)
+
+- id: `hud`
+- Source: mg-styles-15 `prompts/22-hud.md` (MIT, Vincentwei1021)
+- Best for: tech reviews, AI product demos, game edits, sci-fi and aerospace explainers, film-UI style intros
+- Not for: warm, organic, calm editorial, or hand-made looks
+- Triggers: HUD, FUI, cyberpunk, sci-fi interface, targeting, radar, hologram, tech UI, terminal, scanlines, Territory Studio, Cyberpunk 2077, Evangelion
+- Tone cell: kinetic-sharp
+- Clock: smooth 30 fps
+
+## Look
+Deep teal-black. Cyan #00E5FF linework with orange/red #FF6A00 as the alert state. Hex grid, concentric rotating rings with ticks, conic radar sweep with blips, columns of monospace numbers, typewriter status lines with a cursor, sparkline graphs. Central wireframe hologram (globe or drone) with scanlines. Global glow, slight chromatic aberration, scanlines, restrained micro-glitches. Film-UI density with restraint. Coordinates and labels in monospace, for example "N31°14′ E121°29′".
+
+## Motion
+Layered build-up: lines draw on in hierarchical staggered order, then data comes alive, then a target is found. Rings rotate at different speeds. Numbers jump randomly for 3-5 frames then settle on the real value. Typewriter text with blinking cursor. Lock brackets shrink in from the corners, scale 1.4 to 1.0 with fast-out slow-in, snapping onto the target. Then the whole UI flips to alert orange with "TARGET LOCKED". Micro-glitches kept sparse.
+
+## Signature features (judged against these)
+- Cyan and orange neon linework on teal-black.
+- Wireframes draw on with dashoffset in staggered hierarchy.
+- Radar sweep (conic) with blinking blips.
+- Number columns roll 3-5 frames then settle.
+- Lock brackets 1.4 to 1.0 fast-out slow-in.
+- Hue flip from cyan to orange on lock.
+- Global glow, chromatic aberration, scanlines.
+- Monospace typewriter text with cursor.
+
+## 10-second beat seed
+- 0-1.2s: hex grid and first rings draw on.
+- 1.2-5s: data columns, radar, hologram, status lines come alive.
+- 5-7s: a blip is found, lock brackets close in.
+- 7-8.5s (hero at 70-85%): palette flips to orange, "TARGET LOCKED", alarm.
+- 8.5-10s: held with ongoing rings and scan.
+
+## Sound
+Darksynth pulse with HUD beeps, scan sweeps, an ascending lock-on tone, and an alarm on lock.
+
+## Build it in HyperFrames
+SVG layers for rings and ticks, conic-gradient or canvas for the radar sweep (angle = t * speed), Three.js wireframe hologram with scanline overlay for the center. All data seeded: number at step k = seededRandom(k) until settle time, then final value. Glow with an SVG blur or a bloom pass, RGB offset by a post shader or duplicated layers with mix-blend-mode: screen.
+
+## Watch out
+Too dense and unreadable: keep hierarchy, leave negative space. Unseeded random numbers break determinism. Keep glitches rare. Do not use real military or brand insignia.

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

@@ -0,0 +1,48 @@
+# Impressionist Dabs
+
+- id: `impressionist`
+- Source: huashu-art-motion `08_impressionism.md` (MIT)
+- Best for: lifestyle, travel, wellness, food, spring and summer campaigns, soft nostalgic reels
+- Not for: faces and hands in close-up, text-heavy slides, technical product shots
+- Triggers: impressionism, monet, renoir, pastel brushstrokes, sunlit, garden, plein air, dappled light
+- Tone cell: calm-soft
+- Clock: smooth 30/60 fps (brush positions fixed, light and wind animated)
+
+## Look
+Pastel region palettes, 7-9 colors each: lilac-pink walls (`#d8bede #f0c8cc #f2c4d4`), a warm yellow sun zone (cream yellow set), rose-orange-violet floors, plus separate sets for sky, grass, curtains and cloth. Canvas base `#f2e6ee` shows through the gaps between strokes. Strokes are short and fat: main pass cell 11, length 20, width 7, no outline, color jitter 26. A second finer pass (cell 6, length 11, width 4.5) for far views and small framed images. White or near-white elements must be detected (color above about 240,236,225) and mixed back to white, otherwise they get painted the wall color. Signal colors like poppy red stay as authored.
+
+## Motion
+- Dappled sun patches: 26 patches, intensity `0.5+0.5*sin(t*sp+ph)*sin(t*sp*0.53+2ph)`, clamped, so the on/off rhythm is irregular. Each drifts +/-10 to 44 px. Each patch is about 40 bright short strokes.
+- Poppy-like flowers sway: head offset `sin(t*3.2+ph+x*0.02)*(6+r*0.6)`, amplitude 10 or more.
+- Clouds travel about 45 px/s, foliage sways `sin(t*1.9)*8`, ribbons and curtains flutter.
+- Wind rotates distant grass strokes by +/-0.22 rad.
+- Transition family: strokes of color dots flood the frame, then clear into the next scene.
+
+## Signature features (judged against these)
+- Short visible dabs everywhere, no outlines.
+- Light-colored gaps between strokes show the pale base.
+- Sun patches that blink irregularly and drift.
+- Pastel region palettes, no pure black.
+- Fine dabs for distant detail, larger dabs for near surfaces.
+- Whites preserved as whites.
+- Surface does not reshuffle between frames.
+
+## 10-second beat seed
+- 0-1.2s: sunlit scene with light patches already moving.
+- 1.2-6s: wind passes through flowers and cloth, slow pan of 20-40 px.
+- 6-7s (hero): sun patch crosses the subject or title.
+- 8.8-10s: hold with patches still drifting.
+
+## Sound
+Light acoustic guitar or harp, 80-96 BPM, bird ambience. Soft shimmer on each patch flare.
+
+## Build it in HyperFrames
+Canvas 2D flat base redrawn each frame (things move), then 2 full-frame stroke passes.
+- Wrap the palette function so each cell consumes exactly one random number and never returns null. Otherwise one moving object reshuffles every later stroke.
+- Use `hash(i,j)` per cell for subject-layer strokes instead of an alpha mask.
+- Light patches use source-over at high alpha; additive blending disappears on pastel grounds.
+
+## Watch out
+- Current weak spot: faces and hands get shattered by the strokes. Keep them small or paint them in a calmer pass.
+- Reseeding the whole screen every 7-8 frames reads as flicker (measured frame diff 4.1 against 0.57 after the fix). Fix stroke positions, animate light and wind instead.
+- A single coarse pass erases small distant things. Use two passes.

package/skills/video-studio/references/styles/ink-wash.md

@@ -0,0 +1,49 @@
+# Ink Wash (sumi-e)
+
+- id: `ink-wash`
+- Source: huashu-art-motion `17_ink.md` (MIT)
+- Best for: tea, wellness, craft, East Asian brands, poetic intros, minimal luxury, philosophy content
+- Not for: loud kinetic ads, high-saturation product shots, busy UI
+- Triggers: ink wash, sumi-e, chinese painting, calligraphy, brush, shuimo, qi baishi, bada shanren, zen, rice paper
+- Tone cell: calm-sharp
+- Clock: smooth 30/60 fps
+
+## Look
+Paper is the base and ink is only added. Rice paper `#efe6d0` with noise grain and about 2,600 short fibers, a vignette up to alpha 0.22 at the edges. Ink is one near-black `[16,14,12]` used in five tones: scorched 0.9, thick 0.8, heavy 0.6, light 0.35, clear 0.15. Accent pigments used sparingly: ochre `#c47a3c`, blue-gray `#6f8aa0`, yellow `#e2aa34`, a single red for the seal `#c4281e` and tiny vermilion touches (`#d8553f`). Lots of empty space. Whites are carved out of washes with `destination-out`, not painted white.
+
+## Motion
+- Opening: the picture writes itself stroke by stroke over about 0.45 s (`reveal = smoothstep(d, d+l, lt/0.45)`), offset so frame 0 already has ink.
+- Ink bleed: halo blur grows over time, so wash edges keep spreading.
+- Branches sway `sin(2.9t)*0.11`, leaves flip `sin(7t+g)*0.2`, mist bands (paper-colored blurred ellipses) slide 150-270 px/s.
+- A bird crosses at 420 px/s, wings 8 beats per second.
+- Seal stamps down from 1.5x to 1x with multiply.
+- Transition family: strokes write in, ink blooms across the paper.
+
+## Signature features (judged against these)
+- Brush strokes with pressure taper and dry-brush gaps (flying white).
+- Washes with soft spreading edges.
+- Five ink tones, not flat black.
+- Large negative space.
+- A red seal in the corner.
+- Whites by carving, not by paint.
+- Only 2-3 spots of color.
+
+## 10-second beat seed
+- 0-1.2s: strokes write in.
+- 1.2-6s: wash blooms spread, branch sways, mist slides.
+- 6-7s (hero): single bold stroke or bird crossing, seal lands.
+- 8.8-10s: hold with mist moving slowly.
+
+## Sound
+Guzheng or sparse bamboo flute, 60-72 BPM, occasional low drum. One plucked note per stroke.
+
+## Build it in HyperFrames
+Canvas 2D, cache the static strokes after they finish writing.
+- Resample brush paths to 4 px arc length (so dry-brush noise frequency is constant). Pressure profile `smoothstep(0,head,q)*(1-0.7*smoothstep(1-tail,1,q))`.
+- Each bristle is one continuous polyline with butt caps, broken where `noise(k*1.9, i*0.09)` is below `dry*q^1.2*0.95+0.05`. Segment-by-segment strokes leave knots.
+- Washes: draw shape on scratch canvas, multiply twice (outer halo blur, inner body blur), grow 0 to 1 over lt.
+
+## Watch out
+- Current weak spot: figures are not loose enough (review 6/10). Use few strokes and let the wash do the form.
+- Multiply washes are transparent, so lines show through the shapes. Underpaint paper color inside each silhouette first.
+- A pure white first frame fails as a cover. Start with some ink already down.

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

@@ -0,0 +1,40 @@
+# Isometric Miniature World
+
+- id: `isometric`
+- Source: mg-styles-15 `prompts/03-isometric.md` (MIT, Vincentwei1021)
+- Best for: tech architecture animation, app feature demos, data campus, smart-city or cloud infrastructure explainers
+- Not for: character drama, organic subjects, anything needing perspective depth
+- Triggers: isometric, 2.5D, iso, miniature city, low poly diorama, architecture diagram animation, tech campus, Dribbble hero, School of Motion
+- Tone cell: kinetic-soft
+- Clock: smooth 30 fps
+
+## Look
+True isometric projection: orthographic, 35.264 degree elevation, 45 degree azimuth, no vanishing point, lines everywhere to scale. Pastel studio palette: lavender ground, mint, peach, sky blue, white. Soft shadows and ambient occlusion so it reads as a premium hero render. Title text lies ON the iso plane, skewed into iso space. Floating island in a pastel void for the end.
+
+## Motion
+Ground tiles flip or drop in as a wave from the centre, tiny bounce each. Buildings grow: base lands, walls scaleY from 0 with overshoot, roof cap 2-3 frames later. Trees pop, windows light in sequence. Life layer: cars loop roads, a train, drones carrying packets, glowing data streams pulse between buildings, a wind turbine spins. Camera is a parallel slide only, no rotation, with 1 : 0.8 : 0.6 parallax between foreground, middle, back layers. Pull-back to reveal the whole island.
+
+## Signature features (judged against these)
+- Orthographic 30 degree iso angle, no perspective convergence.
+- Miniature scene with many small readable objects.
+- Building growth: base first, walls scaleY with overshoot, roof 2-3 frames late.
+- Tiles arrive as a radial wave from the centre.
+- Camera moves by parallel translation only, parallax 1 : 0.8 : 0.6.
+- Pastel palette, soft shadow and AO.
+- Moving objects stay on the iso grid at 2:1 pixel slope.
+- Title set in iso space.
+
+## 10-second beat seed
+- 0-2s: tile wave from centre; hook is the first ripple at frame 0.
+- 2-5s: buildings grow, trees pop, windows light.
+- 5-8s (hero at 60-75%): cars, train, drones, data streams, turbine; parallel camera slide.
+- 8-10s: pull back to the floating island, title on the plane, hold with idling motion.
+
+## Sound
+Bright plucky tech melody (FM marimba or pluck). Soft click or pop on each tile and building landing. Airy whoosh on the pull-back.
+
+## Build it in HyperFrames
+Three.js with OrthographicCamera at the true iso angle, soft shadows and a cheap AO (baked or SSAO), stepped per frame from t. Alternative: SVG faces built with the SSR matrix (scale Y 86.6%, skew 30 degrees, rotate 30 degrees) for top, left and right faces, z-ordered by screen y. Text as a CSS-transformed element or a plane in the scene.
+
+## Watch out
+Any perspective camera breaks the style. Z-sorting errors in the SVG route. Do not rotate the camera. Keep object count high enough to feel dense but each one readable.