luckiest-co 1.0.40 → 1.0.42

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

@@ -0,0 +1,39 @@
+# Shape Morph Chain
+
+- id: `morph`
+- Source: mg-styles-15 `prompts/08-morph.md` (MIT, Vincentwei1021)
+- Best for: keynote-grade storytelling, icon sequences, feature walkthroughs, brand reveal built from meaningful symbols
+- Not for: character acting, texture-heavy looks, hard-cut montage
+- Triggers: morph, morphing, shape transition, icon morph, shape shifting, one shape becomes another, Apple keynote, visual storytelling, flubber
+- Tone cell: calm-sharp
+- Clock: smooth 30 fps
+
+## Look
+One hero shape, flat clean icons. Background color fields change with each morph via clean color-block wipes. Palette of 4-6 brand colors, one per beat. Invented logo and wordmark at the end (for example "morphe"). Centred, generous negative space.
+
+## Motion
+Chain of 6-8 meaningful icons on the beat, for example cup, circle, sun, sunset over sea, gull, paper plane, location pin, heart, logo. Each A to B goes through a simple intermediate (circle or capsule): A to circle then circle to B, 8-12 frames each. Rotation plus 10-15% squash and stretch through the morph. Sub-parts morph in sync (steam becomes sun rays becomes waves). Ease cubic-bezier(0.7,0,0.3,1), fastest in the middle, 3-frame cushions at start and end.
+
+## Signature features (judged against these)
+- Continuous outline with no jump cut between shapes.
+- Every complex morph bridges through a circle or capsule.
+- No knotting or tangling at any mid-point still.
+- 10-15% squash and stretch plus slight rotation during morphs.
+- Sub-parts morph in sync with the hero.
+- Color-field wipe with each morph.
+- Each morph lands on a beat.
+
+## 10-second beat seed
+- 0-1s: first icon pops in, hold 3 frames, begin morph (hook on frame 0).
+- 1-6s: 5-6 morphs on the beat, each with a color wipe.
+- 6-8s (hero at 60-75%): the most surprising morph (paper plane to pin to heart) with synced sub-parts.
+- 8-10s: shape becomes the brand logo, wordmark fades in, hold with micro-motion.
+
+## Sound
+Rhythmic plucky arpeggio. A pitched whoosh per morph landing on the beat.
+
+## Build it in HyperFrames
+SVG with GSAP MorphSVGPlugin if licensed, otherwise flubber or a custom resampler: resample both paths to the same N points (about 200), rotate the start index to minimise total vertex distance, then lerp with the easing curve. All as a pure function of t. Always render mid-point stills for every morph and inspect for knots.
+
+## Watch out
+Mismatched vertex counts and starting points cause knots. Skipping the intermediate circle on complex pairs. Mechanical look when squash and rotation are missing. Make beat times come from a single cue sheet.

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

@@ -0,0 +1,52 @@
+# Stone Mosaic
+
+- id: `mosaic`
+- Source: huashu-art-motion `04_roman.md` (MIT)
+- Best for: heritage, food, travel, history, floor-tile and craft brands, bold logos and badges (narrow use)
+- Not for: faces in close-up at small tile sizes, fast-motion UI, fine text
+- Triggers: mosaic, roman mosaic, pompeii, tesserae, tile, byzantine, ancient floor, stone tiles
+- Tone cell: calm-sharp
+- Clock: smooth 30/60 fps (stones fixed, color flows through them)
+
+## Look
+Hundreds of small stone tiles placed along outlines, with grout between them.
+- Wall `#e4ddcd`, halo ring `#f5f1e8` (a 44-50 px halo around every figure), outline `#46322a`, red frame `#a8322a` with `#7c221d` line, gold `#d0a23c`, grout rgb(112,103,92) with noise.
+- Tile size by region: wall 12 px, halo 11, figures 10, face 5-6 (small), hair 8, border strip 7.6, text 7, ground 13. Color jitter +/-4 to 8%, 9% warm tiles (+12,+4,-8), 7% cool.
+- Each tile is a rotated square with half-widths `s/2*(1.08-1.28)` each, rotation +/-0.06 rad. Grout appears along the bisector between neighbors (gap 0.75-1.25 px).
+- Edge shading: within 2.2 px of the edge, light direction (-0.6,-0.8) gives +/-16% light or dark; dome term `-5%*D1^2`; 3% pixel grain.
+- Lettering: monospace thick-stroke letters about 2 tiles wide per stroke.
+
+## Motion
+- Layout is computed once. Each frame, colors from a flat drawing flow through the fixed stones.
+- Border band as a conveyor: a pre-baked 2,106 px stone strip (26 repeats of an 81 px pattern) translated by phase `15*lt + 81*easeInOut(...)`, so the stones travel with the pattern.
+- Smoke or small props drift (55 px/s cloud band, 12 ember squares on parabolas); a small tile-sprite (emblema) carries moving objects.
+- Transition family: mosaic tiles flip over and spread outward from a point.
+
+## Signature features (judged against these)
+- Tiles laid along outline contours (distance-field iso-lines), then filled in staggered rows.
+- Visible grout formed by the bisector between irregular stones.
+- Halo of lighter tiles around every figure.
+- Smaller tiles on faces and focal details, larger on background.
+- Color flows across fixed tiles (the tiles never move except in the border conveyor).
+- Props smaller than 3 tiles wide are sprites with their own small tiles.
+
+## 10-second beat seed
+- 0-1.2s: tile border drifts, central picture assembles.
+- 1.2-6s: color moves through the stones, smoke and sparks.
+- 6-7.5s (hero): focal object flips tile by tile into the key message.
+- 8.8-10s: hold, border continues.
+
+## Sound
+Lyre and frame drum, 80-100 BPM, stone click foley per tile flip.
+
+## Build it in HyperFrames
+Canvas 2D with typed arrays; build once at init (about 200 ms).
+- Distance transform (Felzenszwalb-Huttenlocher) on a structure map, then walk iso-contours placing stones spaced at the tile size using a spatial hash with minimum spacing 0.8 x size; fill remaining gaps with staggered rows.
+- Per pixel store tile id and shade; per frame sample the flat drawing at each tile center and write color x shade. Draw to an offscreen canvas then `drawImage` (direct `putImageData` ignores scaling and transitions).
+
+## Watch out
+- Current weak spot: facial detail gets lost at small tile sizes.
+- Hand, cup and face crowd together at 6-8.5 px tiles. Use bigger gestures or sprite inserts.
+- Slow pattern shifts under one tile width get quantized away if only colors change. Move the stones too or move far.
+- Do not use a special small tile size in one region only; it shows as a patch when still.
+- Thin serif letters break into wrong letters at 7-9 px tiles.

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

@@ -0,0 +1,60 @@
+# Evidence Desk Collage
+
+- id: `newsroom-collage`
+- Source: huashu-art-motion `references/动画语法/y2_vox.md` (MIT)
+- Best for: news, history, politics and "how did this happen" explainers built on real material (clippings, screenshots, photos, maps, quotes). Journalist-style argument with evidence. 45-180s.
+- Not for: pure concept or mechanism with nothing real to show (it becomes fake archive), derivations, character-driven comedy.
+- Triggers: vox, johnny harris, explainer journalism, news explainer, documentary collage, paper desk, red string, highlighter, investigation board, map explainer, archive footage collage
+- Tone cell: calm-sharp
+- Clock: on twos (elements step at 12 fps, camera smooth 24-60 fps)
+
+## Look
+- Three-color system: near-black `#171716`, paper white `#E0DCDA` to `#EEEDED`, one red in two steps (bright `#B65255` for lines, dark `#93403C` for fills). Highlighter yellow `#DACF08` for emphasis only. Old map paper `#E4DCCF`, parchment `#CFB195`. No pure white, no pure black.
+- Used in the demo: desk `#e4ddcf`, clue red `#b8433f` (slightly brighter for 1080p legibility), highlighter `rgba(218,207,8,.9)` with multiply blend, a large black card `#1b1b1a` on the desk for one shot.
+- Real material is the main picture: screenshots, original text, photos fill the frame or close to it, then push to the sentence being read. A shot where material is under 60% of the frame width, more than twice in a row, is the "photo frame" layout.
+- Photos are grayscale with a 45 degree halftone, white border, two semi-transparent tape pieces. Clippings have torn, yellowed edges and a serif headline. Labels are black bars with bold white text. Index cards have ruled lines.
+- Paper texture is static. No per-frame grain. Shadows are weak (blur 10, offset (3, 6), alpha 0.28).
+- Intentionally imperfect so it reads as editorial, not advertising.
+- People can appear as cut-out stickers with a white border and shadow.
+
+## Motion
+- Two frame rates. Camera runs smooth. Elements (map color growth, red line tracing, typing, hand-drawn circles, pop-ins) step at 12 fps. Use `step(t - at, 12)` so the first frame is exactly at the cue.
+- Camera easing from 13 measured moves: median 1.29s, range 0.71-1.96s, none linear. Seven are symmetric sine in-out for long hops, six are fast-start long-tail near `cubic-bezier(.33,0,.2,1)` for reveals and tracking.
+- Defaults: push 0.6-1.5s, pull-out about 1s, follow a clue 1.3-1.8s, find next card 0.5-0.9s, fast push 0.28s only for a reveal.
+- Archive photos and clippings appear on the cut, no bounce. Only when following a timeline does the next card slide in from off-screen with a 5-15 degree tilt, flatten, about 0.8s.
+- Pen work: red underline 0.5-1s, red oval about 1s in one stroke (not closed, slightly crossing), highlighter 1.5-3s per line following the spoken words, typing about 13 characters per second.
+- When the camera is parked and a card has internal animation, the camera holds. Static cards use a push to the line being read, not a slow drift.
+
+## Signature features (judged against these)
+- Real material fills the frame and is pushed in to the exact sentence.
+- Black, paper white, one red, plus a muted highlighter, no big yellow fields.
+- Camera glides while elements step at 12 fps.
+- No tear-off paper transition and no per-frame grain.
+- Reveal actions rotate (cut-in, push, glide, highlighter, red line, stamp), never the same sequence more than 3 times.
+- Text to read is on the topmost layer and drawn last.
+- Highlighter timing follows the speaker, not the music.
+- The same event is acted out only once. After a zoom, it is not replayed.
+
+## Beat pattern (30-60s)
+- 0-4s: the source document or photo is on screen, camera framed on the claim.
+- 4-20s: slow tier holds each card 3-7s using internal motion (highlighter, typed label, red circle). Fast tier (1.4-1.8s) is image cuts only.
+- 50-70%: follow a red string from the key line to a second piece of evidence. The camera chases for 1.1-1.8s with short motion blur.
+- Then a push into the photo and a hard cut to the sharper scan of the same image.
+- Last 6-8s: pull out to the whole desk (0.85s long tail), then a closing line typed on black, hold 1s.
+
+## Sound
+Understated documentary bed, minimal pulse, change music about every 20s. Paper slide, marker squeak, soft typewriter ticks. Voice is the lead.
+
+## Build it in HyperFrames
+- Canvas 2D or SVG. Cache each paper, photo and clipping as a sprite. Seeded paper texture tiles seamlessly (sample on a torus) with fibers.
+- Halftone: convert grayscale to a 45 degree dot grid as one path. Torn edges via noise.
+- Hand-drawn lines: resample and add low-frequency noise, reveal by length.
+- Camera framing: compute the rect that contains the target plus margin. Do not hand-type coordinates. Push no further than keeps the red circle in frame.
+- Short motion blur on fast moves by stacking 7 samples along the velocity vector.
+
+## Watch out
+- Everything moving smooth at 60 fps looks like a corporate film. Everything at 12 fps makes the camera dizzy.
+- Template-style tricks (tear-off transitions, every image bouncing in, jittering paper) are not part of this look.
+- Cards stacked so two labels read together as a false sentence ("exceeded" beside "acquired"). Read the visible text in order.
+- A photo, clip or later card covering the text that is being read.
+- The source marks a highlighter that starts outside the visible frame. Move the camera first.

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

@@ -0,0 +1,46 @@
+# Pixel Art 8-bit
+
+- id: `pixel`
+- Source: mg-styles-15 `prompts/20-pixel.md` (MIT, Vincentwei1021)
+- Best for: game trailers and attract screens, 8-bit music videos, nostalgic brand marketing, indie game promos
+- Not for: smooth premium brand films, photoreal, long text
+- Triggers: pixel art, 8-bit, 16-bit, retro game, sprite, chiptune, side scroller, CRT, dithering, PICO-8, Aseprite, Minecraft, Terraria
+- Tone cell: kinetic-sharp
+- Clock: stepped 10-12 fps for sprites (30 fps timeline for scrolling)
+
+## Look
+Internal resolution 320x180 scaled x6 to 1920x1080 with nearest-neighbour. Limited palette (PICO-8-like 16-32 colors), dithered sky gradient. 3-4 parallax layers (sky, far mountains, mid forest or city, near ground tiles). Sprites hand-authored 16x16 to 24x24 as pixel arrays. Chunky pixel logo (for example "PIXEL QUEST"), pixel font dialogue box. Optional CRT pass: scanlines, slight barrel, phosphor glow, without blurring pixels into mush.
+
+## Motion
+Strictly integer pixel positions and stepped timing, no smooth easing on sprites. Run cycle 6-8 frames at about 10-12 fps. Coin sparkle, slime bop, chest opens with a light burst. Parallax layers move by whole pixels at different speeds. Palette shifts day to sunset. Dialogue types out character by character. Logo drops in with a shine sweep.
+
+## Signature features (judged against these)
+- Hard pixel edges via nearest-neighbour, no anti-aliasing.
+- Limited palette (8-32 colors) with dither.
+- Sprite animation at 8-12 fps, steps() timing.
+- Integer-pixel positions only, including parallax.
+- 3-4 parallax layers at different whole-pixel speeds.
+- Typewriter dialogue box in a pixel font.
+- CRT scanlines that keep pixels crisp.
+
+## 10-second beat seed
+- 0-1.2s: sky and hero already running, coin sparkle.
+- 1.2-4s: run, jump, bop a slime, parallax scrolling.
+- 4-7s (hero at 60-75%): palette shifts to sunset, chest opens with a light burst.
+- 7-8.5s: dialogue typed out.
+- 8.5-10s: pixel logo drops in with shine sweep, held with blink.
+
+## Sound
+Chiptune: pulse lead, triangle bass, noise drums, plus jump, coin and chest SFX.
+
+## Build it in HyperFrames
+Canvas 2D at 320x180 with imageSmoothingEnabled = false, then drawImage upscaled x6 (or CSS image-rendering: pixelated). Sprite frame = floor(t*10) mod N. Parallax offset = floor(t * speed). Palette as an array of hex values, palette shift by lerping and re-quantising. Ordered-dither (Bayer 4x4) for gradients. CRT pass applied after upscale.
+
+## Watch out
+Fractional positions cause shimmer. Never use a smooth scale or rotation on sprites. Scanlines that are too heavy hide the art. Pixel CJK fonts must be OFL.
+
+## Art-history variant (huashu-art-motion `14_8bit`)
+- Draw the whole scene on a 240x135 canvas (1 low pixel = 8 screen pixels), scale up once with image smoothing off. Gradients become a 3-tone checkerboard dither band (sky `#0856ef #47c4f8 #aae9fb`).
+- Sprites: rasterize each part on its own layer, drop alpha under 110, quantize to a 14-color palette, give each part its own 1px black outline. Draw small props directly at low resolution, never scaled down from smooth paths.
+- HUD text at full resolution in Press Start 2P (OFL) with an 8px drop shadow; icons as 8x8 bitmaps.
+- Motion stepped: 4-pose loops at 15 fps, integer pixel shakes `[0,1,0,-1]`, coin pop as a half sine of 9px, 1px cloud moves every 2 frames. Transition in: pixel blocks scale up then down.

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

@@ -0,0 +1,49 @@
+# Pointillist Dots
+
+- id: `pointillist`
+- Source: huashu-art-motion `29_seurat.md` (MIT)
+- Best for: calm brand films, art and culture content, premium reveals, color theory explainers
+- Not for: fast action, small text, flat vector UI
+- Triggers: pointillism, seurat, signac, dots, optical color mixing, stipple painting, divisionism
+- Tone cell: calm-soft
+- Clock: on twos (dot recolor at 6 fps, light shimmer)
+
+## Look
+The picture is built from equal-size dots placed on a hex grid (pitch 10, row spacing 8.66, radius 4.5, +/-1.2 px static jitter, about 24,000 dots). Only 21 pure palette colors exist; mixed tones come from placing two neighbors side by side in proportion.
+- 14 saturated: `#1a2058 #2a3a9a #3f6fd0 #6aaee6 #1f6a52 #2f9a5a #a8c83a #f2cf3a #f08a2a #e0432a #c0306a #7a4aa8 #f8f4e8 #e8b48a`
+- 7 pale (mixed with white): `#f6e49a #f6c48a #cfe08a #b0cff0 #f2b8c8 #c99a4a #9a7ac8`
+A blurred, slightly desaturated copy of the flat painting sits under the dots as ground color. A dark blue 28 px border, also dotted, frames the picture. Compose for the subject; leave open flat areas so the dots read.
+
+## Motion
+- Water or sky dots re-roll their hash at 6 fps to make light shimmer.
+- 7% of dots swap to their pair color at 6 fps (4 fps and 3% read as frozen).
+- One small element drifts (a boat 40 px/s, a butterfly on `sin(2.6t)*120` with wing beat `|sin(20t)|`).
+- Transition family: the old image crystallizes into dots (grid pitch 14, radius grows to 6.4), dots recolor top-left first with a 1.35x pop, then the new image develops underneath.
+
+## Signature features (judged against these)
+- Uniform dots, no strokes, no outlines.
+- 21-color palette, tones created by optical mixing.
+- About 8% complementary-color dots (blue/orange, green/red-violet, yellow/violet).
+- Light bleed: where brightness differs by more than 45 across 14 px, add white on the bright side and deep blue on the dark side.
+- Visible deep-blue dotted border.
+- Gentle motion, adjacent-frame difference around 0.45 mean.
+
+## 10-second beat seed
+- 0-1.2s: dots crystallize from empty paper into the scene.
+- 1.2-6s: slow shimmer, one drifting element.
+- 6-7s (hero): dots pop to the new palette pair, title resolves.
+- 8.8-10s: hold, shimmer continues.
+
+## Sound
+Soft marimba or vibraphone ticks, 90-100 BPM. One tick per dot-pop wave.
+
+## Build it in HyperFrames
+Canvas 2D or WebGL. Draw a flat painting, sample color at each grid dot, pick a pair from the palette.
+- Project the target color onto the line between two palette colors to get a ratio, clamp to 0.2-0.8, add a penalty `0.004*|Pi-Pj|^2` against distant pairs, and decide per dot with `hash(i,j) < w`.
+- Add +/-20 hash jitter to the target before picking, otherwise the pair boundary forms vertical bands.
+- Batch dots into one Path2D per color, fill once per color; cache pair choices by 15-bit quantized color.
+
+## Watch out
+- Current weak spot: reads static, and the grid can look too regular. Add the shimmer and a moving element.
+- A single preferred pure color without a penalty slices gradients into stripes.
+- Without pale colors in the palette, bright walls break into white, skin and blue snow noise.

package/skills/video-studio/references/styles/presenter-explainer.md

@@ -0,0 +1,57 @@
+# Cartoon Presenter Explainer
+
+- id: `presenter-explainer`
+- Source: huashu-art-motion `references/动画语法/y6_presenter_explainer.md` (MIT)
+- Best for: business history, product mechanics and finance or tech knowledge pieces where a cartoon host walks between paper, charts and keywords and reacts emotionally. 60-180s.
+- Not for: anything without character art you can generate or supply. The source ships no character sprites and no ready-made parameterized clip, so it is a grammar and a reference approach only, not a turnkey template.
+- Triggers: presenter explainer, cartoon host, character explainer, business history video, finance explainer with mascot, spacex explainer, character walks across the chart, talking head cartoon, narrated cartoon guide
+- Tone cell: kinetic-soft
+- Clock: on twos (character frames swap, scene camera smooth)
+
+## Look
+- A cartoon presenter built from AI-generated frames stands in a scene made of paper, charts and keywords. Code controls foot anchor, position, scale and frame swaps.
+- The source gives no palette or fonts. Suggested defaults, adjust to brief: warm paper base `#F4EFE6`, ink `#1B1B1F`, one brand accent, one chart color used for the hero data. Keep chart and keyword layers quieter than the presenter.
+- Generate at least two framing sets: full body and bust. Sitting and leaning poses need their own real frames. Do not enlarge a full-body frame for a reaction close-up.
+- Layout is assigned in the storyboard, not fixed. Rotate between: presenter at the side explaining, full-screen number, left-right compare, presenter stepping into the chart, reaction close-up. Do not fix "person left, chart right" for the whole film.
+- A top bar with the year or section, the subtitles and the segment title all read from the same clock.
+
+## Motion
+- Pose changes are hard cuts with a slight pop-in, so different silhouettes never cross-dissolve into a ghost double.
+- Mouth frames switch with the voice and stop in pauses. Walking uses full gait frames, not a slide.
+- Normalize pose heights to the median height. The first cast keyframe of each segment states `x` and `s` explicitly so nothing inherits from the previous segment.
+- Numbers settle on the spoken moment. While counting, do not show assertions like "over" or "+" early. The emphasis circle appears after the number settles.
+- Nested transparency uses multiply (`*=`) so an outer fade survives.
+- Transition between pages flips only the page. Presenter and top bar continue across pages.
+- Camera: use a scene camera for pushes. Whole-frame bitmap zoom crops the character and was a known problem in the reference code.
+
+## Signature features (judged against these)
+- Presenter moves between paper, chart and keyword layers instead of sitting in a corner.
+- At least four different layouts in the film, no fixed left-right composition.
+- Full-body and bust frames used for the right shot sizes.
+- Pose swaps are hard cuts with a small pop, no dissolves between poses.
+- Mouth movement tied to the voice and silent during pauses.
+- Feet stay on a fixed anchor across frame swaps.
+- Number lands on the spoken digit, circle added afterward.
+- Year bar, subtitles and segment title share one time source.
+
+## Beat pattern (30-60s)
+- 0-5s: presenter enters at the side with a hook line, full-body frame.
+- 5-25s: alternate presenter-explaining and full-screen paper or chart beats. Keywords appear as the voice says them.
+- 60-75%: the key figure fills the screen, then the presenter steps in or reacts on a bust close-up. Leave a pause for the beat, written into the script and the voiceover.
+- Last 5-8s: presenter returns to the side with the takeaway, hold 1s with a small idle.
+- Aim for a layout change every 5-8s.
+
+## Sound
+Light upbeat bed, 90-110 BPM, ducked under the voice. Soft pops on keyword entrances, page-turn sound on page flips, a short stinger on the reaction shot.
+
+## Build it in HyperFrames
+- Canvas 2D or HTML layers. Write a `presenterFrame(pose, t)` function that picks a frame from an image set and a `drawFigure` that places it by foot anchor.
+- Cut frames from a sheet with a script that computes the foot anchor per frame.
+- Page flip is the only transition. The HUD and presenter layers draw above it from the global clock.
+- Run the project's text-in-frame QA from the first draft. For light backgrounds without subtitles, also run a subtitle-zone check.
+
+## Watch out
+- Presenter covering text, or being cropped by a push-in. Check by eye.
+- Reusing the same left-person right-chart composition across the film.
+- Pose frames that do not match (sitting needs real sitting art).
+- Using this card as a full template. Art and voice must be supplied and the source says so.

package/skills/video-studio/references/styles/retro-cgi.md

@@ -0,0 +1,52 @@
+# Retro CGI Render
+
+- id: `retro-cgi`
+- Source: huashu-art-motion `15_raytrace.md` (MIT)
+- Best for: nostalgia tech, intros for software, games, 3D-logo reveals, retro brand throwbacks (narrow use)
+- Not for: modern minimal UI, organic subjects, handmade looks
+- Triggers: 90s cgi, early ray tracing, chrome sphere, checkerboard floor, plastic render, wireframe, pov-ray, silicon graphics
+- Tone cell: kinetic-sharp
+- Clock: smooth 30/60 fps
+
+## Look
+Every object looks like glossy plastic from a 1993 render.
+- Walls teal `#7dbcb9 -> #64a6a6 -> #3f8285` with a radial light at the window; sky `#a24cc4 -> #df62ae -> #f5a08a -> #f8c070`; pink wireframe grid mountains (28 x 26 cells) with sawtooth snow caps.
+- Ground is a perspective checkerboard computed per pixel (vanishing point (960,480), `X=(x-960)/dy`, `Z=1/dy`, tile 0.27 x 0.00029, 2x2 supersampling, fog over the nearest 140 px by 35%).
+- Plastic shading helper `plastic(path, base, hx, hy, R)`: base fill, radial gradient from the highlight (white 0.55 -> 0.06 at 0.28 -> clear at 0.62 -> deep purple `rgba(10,0,30,0.42)` at the edge), `lighter` ambient bounce in the wall color, then a small hard-edged white ellipse specular (0.16R x 0.09R, alpha 0.85).
+- Limbs are cylinders: gradient across the normal (dark 0.25, bright 0.5 band at 22%, dark 0.45) plus a thin white highlight line. Joints are visible balls (toy-figure feel).
+- Floor reflections: mirror the object layer, alpha 0.34, drawn each object on its own layer first so many small pieces do not stack to opaque.
+
+## Motion
+- Ring of 140 spheres spinning about a vertical axis at 7 rad/s, tilted 0.35, depth-sorted (a dark base layer first so spheres merge into a tube).
+- Chrome ball: per-pixel environment map (down: checkerboard, up: pink-purple sky plus a window strip); the checker u coordinate shifts `t*4.5`; Fresnel rim brightens; diameter 104 px, under 2 ms.
+- Lens flare (`lighter`): core 170 px pulsing +/-8% at 23 rad/s, 12 spikes at 1.6 rad/s, 960 px horizontal bar, five circle and hexagon ghosts along the sun-to-center line sliding `sin(5t)*0.03`.
+- Glowing eyes or lights pulse +/-25% at 18 rad/s; a diagonal glass reflection slides 260 px/s.
+- Transition family: green wireframe of the new image (edges cached on first frame) then scanline-fills into the rendered picture.
+
+## Signature features (judged against these)
+- Uniform plastic shading with the same highlight logic on every object.
+- Perspective checker floor with fog and mirrored reflections.
+- Spinning ring/ball with visible per-sphere highlights.
+- Pink wireframe terrain and a gradient sunset sky.
+- Chrome sphere reflecting the scene.
+- Lens flare with ghosts, rotating spikes.
+- Wireframe to render transition.
+
+## 10-second beat seed
+- 0-1.2s: wireframe resolves to rendered scene.
+- 1.2-6s: ring spins, chrome ball rolls, flare glints.
+- 6-7.5s (hero): camera-fixed flare sweep and title in chrome.
+- 8.8-10s: hold, ring continues to spin.
+
+## Sound
+FM synth pads and a gated snare, 100-115 BPM. Whoosh on flare, "bling" on specular glints.
+
+## Build it in HyperFrames
+Fake it in Canvas 2D or really render in Three.js with MeshPhong materials and a 4x4 checker texture.
+- The checkerboard and fog are cached (cold start about 53 ms); hot frame about 23 ms.
+- Snapshot the wireframe from the first frame of the incoming scene, so that frame must be complete (no blank first frame).
+- Smooth any polyline silhouettes before applying plastic shading or corners show.
+
+## Watch out
+- Current weak spot: legs look like straight columns and the face reads like a mask. Give organic parts rounded profiles and expression.
+- Narrow use: only works when the retro 3D joke is the point.

package/skills/video-studio/references/styles/science-explainer.md

@@ -0,0 +1,59 @@
+# Glowing Flat Science Explainer
+
+- id: `science-explainer`
+- Source: huashu-art-motion `references/动画语法/y1_kurzgesagt.md` (MIT)
+- Best for: scale and "what is inside" topics (cell to galaxy, pixel to model), systems and mechanisms drawn as glowing particles and lines, calm popular-science narration. 45-120s.
+- Not for: real people, real events, archive evidence (use a collage style). Step-by-step reasoning (use a whiteboard style). Very small budgets, because the look depends on something always alive in the frame.
+- Triggers: kurzgesagt, in a nutshell, flat science animation, scale zoom, immune system explainer, cell zoom, popular science, glowing vector, optimistic nihilism, zoom into
+- Tone cell: calm-soft
+- Clock: smooth 30/60 fps
+
+## Look
+- Dark era: deep base, 2-3 saturated accents, strong radial glow. Do not copy a purple-blue starfield gradient, it reads as generic AI. Use a flat deep ink or navy base and keep the rule: one dark base plus 2-3 high-saturation accents that contrast (orange against indigo, cyan against magenta).
+- Reference accents from the source: cyan `#32BAEE`, orange `#F48301`, yellow `#FACC12`, glow core `#F9EF93`, magenta `#BE3A95`, highlight white `#F9FCFB`.
+- Never mix eras in one scene. A bright light-grey low-saturation era is also valid for a "daytime" section. Changing sections can change the whole color temperature.
+- Draw the concept as a concrete object (cell, gear, pipe, city, drop of water). A glowing ball with a few label capsules is not enough.
+- No outlines. Shadow is a block of the same hue one step darker, highlight is a white ellipse or an arc. Two-tone facets: shadow band at about (10, 12)px bottom right, thin highlight edge (4, 5)px top left.
+- Rounded everything. Glowing objects always carry a radial glow.
+- Composition: main subject on the lower third line, sky above for stars and labels. Parallax layers: stars 0.05, far 0.12-0.3, near 0.65, subject 1.0, foreground blur 1.5 (7px blur, dark).
+- Label capsules: large radius, saturated fill, bold sans.
+
+## Motion
+- Core easings: `cubic-bezier(.75,0,.25,1)` for most moves (soft start, fast middle, soft end), and `cubic-bezier(.333,0,.667,1)` for loops. Normal action 50 frames at 60fps (0.83s), snappy 10-30 frames, pop-ins 5-10 frames.
+- Pop: card reaches 90% in 0.25s, overshoots to 108% at frame 20, settles about 0.5s. Label uses back-out with overshoot 1.1 over 0.5s.
+- Stagger: similar items 10-20 frames, limbs 3-4 frames, a pause of 20 frames between actions. Title letters 45ms apart.
+- Blink: closed 5 frames, open 10, irregular gaps, eyes never shrink to zero.
+- Ambient layer (stars, particles, glow) can keep moving. Subject and labels hold still once settled. Cut or change state at least once per narration sentence.
+- Camera: zoom is the main verb. Use log interpolation so every frame scales by the same factor. Hold 0.3s and light up the thing you will enter, then push. Pull back out for reveals.
+
+## Signature features (judged against these)
+- A concrete visual metaphor object, not a generic orb.
+- Dark flat base with 2-3 glowing accents, no outlines.
+- Two-tone facets on every shape, same-hue darker shadows.
+- Parallax layers with depth blur in the foreground.
+- Scale transitions use log zoom and redraw vectors at each scale.
+- Subject is still after landing while the background stays alive.
+- One state change per narration sentence.
+- Labels: thin white leader line, then text typed in, about 40 characters per second, then erased after about 3s.
+
+## Beat pattern (30-60s)
+- 0-5s: world establishes with ambient motion, title letters rise.
+- Every 5-7s: a new visual unit (pop a label, morph, transition). Hard cuts land 0-0.2s before a sentence starts.
+- 60-75%: scale transition. Light the target for 0.3s, push in 0.45-1.4s until its color fills the screen, resolve into the new world.
+- Optional gag: a mascot appears for one joke beat.
+- Last 6-8s: pull back (1.45s, ease in out) to a calm wide frame, ambient motion only, hold 1s.
+
+## Sound
+Warm ambient orchestral or soft synth pad, 60-90 BPM, composed after the picture. Gentle chime on pops, deep swell on scale transitions, soft whoosh on pull-backs. Voice is calm, about 168 words per minute.
+
+## Build it in HyperFrames
+- Canvas 2D or SVG layers, each with a depth value. Position scales linearly by depth, zoom by z^depth.
+- The camera is a function of time only. During a transition window the previous scene keeps drawing with its own zoom, so vectors are redrawn and never blown up as a bitmap.
+- Glow is a radial gradient, not a filter. Stars use per-star phase with seeded random.
+- Avoid expo-out for the scale transition because the first frame jumps most of the scale.
+
+## Watch out
+- Everything breathing and drifting at once, with a constant slow push to fill time.
+- Linear zoom, or scaling a screenshot 20x.
+- Bright mixed colors, black outlines, or mid-tone backgrounds drift into children's picture book style.
+- The source built this over very long production times. A cheap version looks like a slide deck.

package/skills/video-studio/references/styles/sticker-explainer.md

@@ -0,0 +1,40 @@
+# Sticker Knowledge Explainer
+
+- id: `sticker-explainer`
+- Source: mg-styles-15 `prompts/19-paperclip.md` (MIT, Vincentwei1021). Note: this is a bold-outline sticker-photo explainer on a huge camera-moved canvas, not paper cutout or stop motion.
+- Best for: hard-core science explainers, finance and knowledge channels, corporate documentary explainers, data-rich narration videos
+- Not for: emotional or abstract pieces, playful cartoons, fast hype edits
+- Triggers: sticker, knowledge video, science explainer, infographic video, big canvas, camera pan and zoom, photo cutouts with white outline, periodic table, PaperClip, Lin Chao, explainer channel
+- Tone cell: calm-sharp
+- Clock: smooth 30 fps
+
+## Look
+Calm blue-grey and off-white canvas: #E9EEF2 with slate, 2-3 colors plus one accent such as #FF5A36. Photos cut out and given an 8-12px (10px) white outline with a soft shadow, so differing sources look unified. Flat icons and exact charts. Equal-weight sans typography, strict alignment, leader-line labels. Huge canvas (for example 6000x3000) viewed through a camera.
+
+## Motion
+One continuous camera path of long ease curves, pan and zoom, linking information points. Every sentence introduces a new visual element. Chart motion: bars grow to scale, numbers count up with a ticking sound, map routes draw on with stroke growth. Exploded-parts stickers with leader lines. Periodic-table tiles light up in sequence. Pull out to a bold typographic title card (heavy sans, huge number, small caption).
+
+## Signature features (judged against these)
+- Photo stickers with 8-12px white outline and soft shadow.
+- Cool, restrained palette: 2-3 colors plus one accent.
+- One continuous camera move across a big canvas with long eases.
+- Charts exact: bars to scale, numbers consistent with the copy.
+- Count-up numbers and path draw-on.
+- A new visual element for every narrated beat.
+- Title card with huge number in heavy sans.
+
+## 10-second beat seed
+- 0-1.5s: phone sticker lands, camera already moving.
+- 1.5-4s: exploded parts with leader-line labels.
+- 4-6.5s: periodic-table tiles light up.
+- 6.5-8s (hero at 60-75%): bar chart grows, count-up to "70+", map routes draw.
+- 8-10s: pull out to the typographic title card, hold.
+
+## Sound
+Clean tech-explainer bed, UI clicks, ticking during count-up, soft whoosh on camera moves.
+
+## Build it in HyperFrames
+One wide stage div with a camera transform (translate and scale) animated by GSAP long eases, computed from a keyframed path. Stickers via CC0 or public-domain PNGs with the outline made by an SVG filter (feMorphology dilate plus flood white) and drop shadow. Charts and map routes in SVG with dashoffset. Count-up from a pure function of t.
+
+## Watch out
+Charts that do not match the narration kill credibility. Source licences: record them. Too many colors loses the serious feel. Keep camera moves long and smooth, not jumpy.

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

@@ -0,0 +1,60 @@
+# Storytime Character Cuts
+
+- id: `storytime`
+- Source: huashu-art-motion `references/动画语法/y4_storytime.md` (MIT)
+- Best for: first-person stories, fails, "the first time I..." anecdotes with a setup, a pause and a punchline. A recurring cartoon avatar carries the voiceover. 60-600s, weekly cadence.
+- Not for: dense tutorials or data (viewers watch the character and forget numbers), content with no "I" and no stance, voiceover that is not funny or has no pauses.
+- Triggers: theodd1sout, jaiden animations, domics, storytime animation, story time, youtube storytime, cartoon avatar, stick figure story, reaction face, smash cut joke, animated anecdote
+- Tone cell: kinetic-soft
+- Clock: on twos (character at 24 fps stepping, 12 mouth changes per second, camera smooth)
+
+## Look
+- Medium shot (waist up, head 25-35% of frame height), character centered or to one side, the other side holds the thing being talked about (computer, person, object).
+- Background says only where: 3-5 big flat shapes, or plain white or color. It is always lighter, less saturated, with thinner lines than the character.
+- Reaction shot: remove the room, face fills the frame (head radius about one third of frame height), solid cool void with vignette.
+- Gag shot often flips to a very wide shot where the character is tiny.
+- Palette (demo): skin `#FFE2CC`, white hat and shirt `#FFFFFF` with band `#E4E4E8`, shorts `#CDBB97`, character line `#1B1B1F`, wall `#DCE9EC`, table `#E2C29B`, floor `#E8DCC8`, background line `#5B6470` at 3px, void `#3D405B`, mouth `#6E2430`, tongue `#F07B7B`, blush `rgba(255,140,120,.35)`.
+- Character line = head radius x 0.05 (min 4px), so 8px at medium, 12px at close, 6px wide. Character line is at least 2x background line.
+- Shapes: all round and blunt. Head slightly flat circle, bean body, head about 58% of height, tube arms with no elbows or fingers, circle hands. Eyes are dots inside glasses, expression comes mostly from eyebrows. Mouth set: smile, flat, wave, half, full.
+- The source says code-drawn characters read as AI. Use your own character frame library (generated frames per pose) when the final matters.
+
+## Motion
+- Pose-to-pose. Switch pose in 0.1s (expo-out, 2-3 frames at 24 fps), then hold. Body squashes 7% on the switch with a spring settle (about 0.35s).
+- Seventy percent of frames in a real example are exactly still. Hold lengths median 0.40s, moves median 100ms. A second reference runs on twos continuously at 12 drawings per second with longer shots (average 5.7s versus 2.4s). Pick one rhythm.
+- Mouth follows the voice envelope, changed at most every 1/12 s into 3 shapes (closed under 0.06, half under 0.22, open above).
+- Small life: breathing +-1.2% on a 1.6s cycle, blink every 2.4-3.6s (closed 2 frames), eyes shift 0.09R toward what is mentioned, head dips 0.015R per mouth step.
+- Props and symbols are the things that pop: back-out with 15-30% overshoot. The question mark pops in 0.26s at 30% overshoot. A big number slams with 23% overshoot.
+- Transitions: hard cut (default), smash cut to reaction (starts at 1.22x, springs to 1, 55% white flash for 2 frames, low thump), whip pan toward what he looks at (0.26s expo in-out with 16-sample blur), jump-in to about 2x on the same set, over-the-shoulder shot with a foreground head and a cool rim light on the screen side.
+
+## Signature features (judged against these)
+- One sentence is about one shot, cut on the breath between sentences.
+- Pose switch about 0.1s then a real hold. No constant floating.
+- Reaction shot sits in a silence of 0.8-1.5s after the outrageous line.
+- Background is calmer than the character (lighter, thinner line).
+- Character line is thicker than background line by 2x or more.
+- Mouth changes at most 12 times per second.
+- After the punchline the picture holds at least 0.9s, with the sound tail finishing.
+- Only on-screen text and key numbers are shown, usually no burned subtitles for the native platform.
+
+## Beat pattern (30-60s)
+- 0-2s: character is already in place and talking from the first frame, medium shot.
+- 2-4.5s: whip pan or cut to the thing he sees, number slams in on the spoken syllable with a thump and 9 Hz shake for 0.3s.
+- Next: smash cut to the reaction close-up, 1.3s silence with one tiny detail (sweat bead, slow blink, eyebrow drop).
+- 60-75%: hard cut to a wide shot for the contrast gag, then jump-in to 1.9x on the punchline.
+- Last 1.5s: shrug or question mark pops, then hold at least 0.9s.
+- A 60s piece repeats this 3-5 times. Average shot in the demo was 1.75s.
+
+## Sound
+Voiceover first, music sparse or none. Effect set: whoosh on pans, keyboard clicks, low "dun" on smash cut, thump on numbers, crickets in the silence, small pip and boing on symbols.
+
+## Build it in HyperFrames
+- Draw the room once as a large world canvas (static parts cached) and change only the camera between wide, medium and close shots, so cuts match. World must be larger than the farthest camera move or black edges appear.
+- Quantize character animation with `step(t, 24)`, mouth with `step(t, 12)`. Camera stays at full frame rate.
+- Export the voice RMS envelope as a 60 fps array and read it in the render, so changing the voice track updates the mouth.
+- Smash zoom must clamp at 1 or above to avoid exposing the edge.
+
+## Watch out
+- Animating everything. The style lives in cut and hold.
+- Detailed backgrounds that pull the eye off the face.
+- Moving on to the next sentence immediately after the joke.
+- A whip pan that cuts mid-sentence. Cut and subtitle change happen on the same frame in the gap.

package/skills/video-studio/references/styles/swirl-brushwork.md

@@ -0,0 +1,53 @@
+# Swirl Brushwork (post-impressionist)
+
+- id: `swirl-brushwork`
+- Source: huashu-art-motion `09_postimp.md` (MIT)
+- Best for: emotional launch films, night scenes, brand stories that want a hand-painted, vibrating look
+- Not for: dense data screens, small UI text, anything needing crisp edges
+- Triggers: van gogh, starry night, swirl, post-impressionist, thick paint, impasto, painterly night sky, oil painting video
+- Tone cell: kinetic-soft
+- Clock: on twos (brush seeds change at 8 fps, shapes stay fixed)
+
+## Look
+Palette by region, 6-8 mixed hues each, never one flat blue.
+- Wall/background blues: `#7f9be6 #5f7fd8 #a7bbf2 #6c6fd2 #8ad0e6 #c3cbf6 #4f6cc8 #9a8fe0`
+- Sky: `#22339a #2f4fb8 #5c86dc #8fb6ee #1b2a78 #3c6bd0`
+- Ground (warm contrast): `#c0573c #a8453a #d7774a #8e3b30 #5f8f6a #c96a52 #e08a5c`
+- Outline: deep blue, 4.5px, mixed 40-45% into the stroke color.
+Brushwork is directional: strokes follow a flow field, so every region has its own grain. Compose for the subject, not a fixed room; keep the sky or background as the swirl carrier.
+
+## Motion
+- Strokes re-seed at 8 fps for a living surface, but stroke positions stay anchored (see Watch out).
+- Swirl field rotates slowly (about 0.3 rad/s) around 2-3 vortex centers.
+- Light halos expand as dashed rings; flame-like shapes sway along the direction field.
+- Transition family ("how you enter it"): the old frame is pulled into the swirl, new image resolves out of spiral strokes.
+
+## Signature features (judged against these)
+- Three separate stroke passes: vertical long strokes for walls (cell 14, len 64, w 8), perspective-aligned strokes for floors (cell 12, len 46, w 8), short strokes for everything else (cell 10, len 22, w 6.5).
+- Per-region palettes of 6-8 hues, mixed 30-45% with the base color.
+- Outline pass at 0.8-0.9 opacity in dark blue.
+- Small props rendered in their own small-stroke layer, not the big-brush pass.
+- Visible spiral strokes in the sky that rotate.
+- Subjects get a fine-stroke pass inside their silhouette, then missing outline lines are patched back in.
+- Glows read as concentric rings, not soft gradients.
+
+## 10-second beat seed
+- 0-1.2s: dark swirling sky fills frame, one bright focal glow.
+- 1.2-6s: subject and props paint in; halos pulse outward.
+- 6-7.5s (hero): vortex tightens around the focal point, text lands on a calm patch.
+- 8.8-10s: hold the end frame, rings keep expanding slowly.
+
+## Sound
+Sparse piano or strings, 70-85 BPM, minor-to-major lift. Soft swell on the vortex tighten, a single chime on the halo ring.
+
+## Build it in HyperFrames
+Canvas 2D flow-field strokes, one `strokes(region, params)` function per pass.
+- Flow field angle from seeded noise plus region rules (wall vertical, floor toward a vanishing point, sky along nearest vortex tangent).
+- Draw a flat base layer first, then strokes over it with region masks; small props get their own layer composited with source-atop.
+- Seed strokes by cell index, not by a running random stream, so changing colors never reshuffles later strokes.
+
+## Watch out
+- The heaviest style in the set (about 110 ms per frame in the source). Cache static regions, budget for it.
+- Running one parameter set over the whole image turns into carpet. Always split into three passes.
+- Small objects get shredded by big strokes. Isolate them in a prop layer.
+- Color jitter alone gives "one blue with noise". The look comes from a dozen hues per region.