luckiest-co 1.0.41 → 1.0.42

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.

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

@@ -0,0 +1,47 @@
+# Synthwave VHS Retro
+
+- id: `synthwave`
+- Source: mg-styles-15 `prompts/10-synthwave.md` (MIT, Vincentwei1021)
+- Best for: retro title sequences, music videos, trend brand films, gaming and nostalgia content, Y2K chrome revivals
+- Not for: clean corporate, calm editorial, medical or finance
+- Triggers: synthwave, outrun, 80s, retro, neon, VHS, vaporwave, Y2K, chrome text, scanlines, grid horizon, retrowave
+- Tone cell: kinetic-sharp
+- Clock: smooth 30 fps, with deliberate 15 fps stutters in key moments
+
+## Look
+Starry deep purple sky gradient. Striped retro sun with horizontal band cut-outs, magenta to orange to yellow. Wireframe mountains, palm silhouettes. Neon magenta and cyan perspective grid. Chrome title with a multi-stop metallic gradient and bevel highlight. Pink neon script word. Double glow: tight about 4px and wide about 30px. VHS pass: RGB split (red and blue offset 1-2px), scanlines (2px spacing, 10% black), 4:3 rounded mask optional.
+
+## Motion
+Camera flies low over the grid, grid scrolls toward the camera in a looping vertical offset, sun rises. Chrome title SLAMS in with a lens flare and a star glint sweeping across. Neon script writes on like a tube with flicker. Glitch burst 1-2 times a second (random but seeded), occasional 2-frame rewind, stutter to 15 fps for tape feel. Y2K variant motion: pop-up windows, cursor click, window drag.
+
+## Signature features (judged against these)
+- Perspective grid rushing to the horizon with a striped sun.
+- Double-layer neon glow (tight plus wide).
+- Chrome text with bevel and glint sweep.
+- VHS chain: RGB split, scanlines, wavy jitter, glitch 1-2 times per second.
+- Opening with a tracking-noise plus PLAY OSD.
+- Neon script writing on with flicker.
+- Deliberate frame stutter in key sections.
+
+## 10-second beat seed
+- 0-1s: tracking noise, PLAY OSD.
+- 1-4s: low flight over the grid, sun rises.
+- 4-6s (hero at 60%): chrome title slams in, flare, glint.
+- 6-7.5s: neon script writes on, flicker.
+- 7.5-10s: sustained ride with chroma bleed, end on the hero frame.
+
+## Sound
+Synthwave: gated-reverb snare, arpeggiated saw bass, lush pads, big chord and crash on the title slam.
+
+## Build it in HyperFrames
+WebGL fragment shader for sky, sun bands, grid (grid lines from fract of (z + t*speed) in perspective space) and mountain wireframes. Chrome text on a 2D canvas with a gradient plus bevel then uploaded as a texture. Glow via two blur passes. VHS pass as a post shader: channel offset, scanline multiply, per-second seeded glitch rows.
+
+## Watch out
+Banding in the sky gradient: add noise. Too much glitch kills legibility of the title. Chrome without strong contrast steps looks like plain grey. Keep glitch timing seeded.
+
+## Vaporwave variant (huashu-art-motion `26_vaporwave`)
+- Wall gradient `#0d0322` to `#4a0f6a`; magenta `#ff4fd8`, hot pink `#ff2f8f`, cyan `#3ff6ff`, sun yellow `#ffd84a`, orange `#ff8a3a`.
+- Neon tube: stroke with a wide glow, then a 2-3px near-white core. Build sign lettering from polylines, no font. Flicker = seeded hash of floor(30t) under 0.07; one letter drops out with a dim purple off state.
+- Sunset sliced by 7 horizontal slits (width `2 + q^2 * 16`) rising 0.9/s; floor grid lines at `y = 600 + 520/d`, `d = k + 1 - phase`, `phase = 1.3t mod 1`.
+- VHS post pass: RGB split with a 3 + 1.5 sin(7t) px offset, a 70px tracking-noise band, scanlines, an on-screen "PLAY" with a drawn triangle. Transition in: VHS tear with vertical roll, 0.30s.
+- Watch out: glow shows at joints if you outline each part; stroke the silhouette instead. Draw kana and symbols as paths, they fall back silently.

package/skills/video-studio/references/styles/variety-show.md

@@ -0,0 +1,40 @@
+# Variety Show Kinetic Captions
+
+- id: `variety-show`
+- Source: mg-styles-15 `prompts/18-hanazi.md` (MIT, Vincentwei1021)
+- Best for: 9:16 vlogs, pet and lifestyle shorts, interview and reaction edits, comedic re-edits, caption-heavy social video
+- Not for: premium calm brand films, data stories, serious tone
+- Triggers: variety show, hanazi, Chinese variety captions, kinetic captions, sticker text, fancy text, reaction text, vlog captions, burst box, outlined text, TikTok captions, Douyin, bilibili
+- Tone cell: kinetic-soft
+- Clock: smooth 30 fps (vertical 1080x1920)
+
+## Look
+Vertical 9:16 over a footage-feel base (CC0 or public-domain photos with Ken Burns, subtle handheld shake, snap punch-in zooms on key moments). Captions in a rounded heavy font, three layers: fill color (gradient allowed), thick white stroke, colored outer stroke or drop shadow. High-saturation pink, yellow, cyan with white strokes. Hand-drawn decoration symbols: burst boxes with speed lines and radial flash, sweat drops, sparkles, question marks, stamps. Keep captions in the safe zone away from UI overlays.
+
+## Motion
+Pop scale 0 to 1.15 to 1.0 in about 8 frames. Per-character bounce with 2-frame stagger. Slight random rotation. Gentle wiggle while the caption holds. Captions appear 2-3 frames after the audio or visual moment. Emotion matching: complaint in slanted handwriting, surprise in a radial burst box, awkward with sweat drops. Punch-in zoom and handheld shake on the base layer for the "moment" feel.
+
+## Signature features (judged against these)
+- Three-layer outlined text: fill, thick white stroke, colored outer stroke or shadow.
+- Pop overshoot 0 to 1.15 to 1.0 in about 8 frames.
+- Per-character bounce with 2-frame stagger.
+- Caption timed 2-3 frames after the sound hit.
+- Hand-drawn decorations (burst box, sweat, sparkle, stamp).
+- Wiggle on long holds.
+- Base layer has Ken Burns, shake and punch-in zooms.
+
+## 10-second beat seed
+- 0-1s: base image punch-in plus the title caption pops.
+- 1-4s: question marks bounce, aside caption in small type.
+- 4-7s (hero at 60-75%): surprise caption inside a radial burst box with speed lines and flash.
+- 7-9s: sparkle caption plus a stamp.
+- 9-10s: final title held with wiggle.
+
+## Sound
+Bouncy variety bed (pizzicato, bass, claps) with boing, pop, ding, slide whistle, and a record scratch on the question marks.
+
+## Build it in HyperFrames
+DOM or SVG text components. Multi-layer stroke via stacked copies with SVG stroke and paint-order: stroke fill, or multiple text-shadow rings. Spring pop with a closed-form damped oscillator of (t minus start). Per-character spans with index times 2 frames of delay. Burst box and decorations are SVG paths. Base layer shake from seeded noise of t.
+
+## Watch out
+Fonts: use OFL rounded heavy fonts with full CJK coverage when needed (for example Zen Maru Gothic or a similar OFL face). Do not put captions under platform UI. Text that appears before the audio hit feels wrong. Avoid trademarked mascots.

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

@@ -0,0 +1,50 @@
+# Watercolor Anime Background
+
+- id: `watercolor-anime`
+- Source: huashu-art-motion `25_ghibli.md` (MIT)
+- Best for: storybook explainers, children's content, wellness, cozy lifestyle, nature, slow narrative openers
+- Not for: hard-sell tech, data-dense frames, dark moody brands
+- Triggers: ghibli, miyazaki, hand-painted watercolor, anime background, storybook, cozy, gouache, wind in curtains
+- Tone cell: calm-soft
+- Clock: smooth 30/60 fps
+
+## Look
+Backgrounds are watercolor washes: transparent layers stacked with multiply, each with a slightly darker edge line where pigment settles. Rooms and skies are bright, never muddy. Wall wash runs from `#fbf3e0` near the light source to `#dcc49a` at corners, with about 28 warm yellow, pink, blue-gray and pale green blooms. Paper grain multiplies on top at 0.3. Characters use two-tone cel shading with a warm brown line (`#4a3428`, softened to `#6a4a38`, width 2.4). Clouds are opaque white puffs with a blue-gray underside.
+
+## Motion
+- Soft cloth billows: hem push `q^2*(60+150*gust)`, `gust = 0.55+0.45*sin(5.4t+phase)`, plus small ripples `sin(7t+6q)`.
+- Grass wind arrives in waves: `wind = 0.5+0.5*sin(3.1t-0.018x)`, so you see a gust cross the field. Around 360 blades.
+- Clouds drift 22-30 px/s, tree canopy sways, 30+ dappled light spots flicker `sin(5t+1.7i)`.
+- Hair, ribbons and flower heads move with the same wind.
+- Transition family: color blooms open on wet paper like spreading water (5 blooms, radius `q*1400*k`, soft bright halo ahead, brown watermark edge).
+
+## Signature features (judged against these)
+- Washes with visible darker settled edges.
+- Bright, warm, airy palette; no moldy parchment look.
+- Cel shading with one crescent shadow, not full gradients.
+- Wind that travels across the frame in waves.
+- Characters carry paper grain and color blooms too, not flat vector fill.
+- Dappled light patches that move.
+- Large soft shapes deformed, never straight-edged rectangles.
+
+## 10-second beat seed
+- 0-1.2s: wind lifts cloth, camera on a bright painted scene.
+- 1.2-6s: grass wave, cloud drift, subject action.
+- 6-7.5s (hero): a strong gust and light patch cross the subject.
+- 8.8-10s: hold with grass and cloth still moving.
+
+## Sound
+Light piano and strings, 70-90 BPM, wind and birdsong bed. Soft swell on the gust.
+
+## Build it in HyperFrames
+Canvas 2D, heavy first-frame cache.
+- `deform(points, depth, amp)`: midpoint displacement, each round amp x0.6. `wash()` fills 3-5 layers with multiply at low alpha plus a 1.6 px same-color edge.
+- Typical wash: large wall layers 5, alpha 0.4, amp 12; blooms layers 3, alpha 0.045, amp 40.
+- Cel function: fill shadow color, then clip and fill base color shifted toward the light; leaves a crescent of shadow.
+- Paint characters offscreen, add a grain and bloom layer, mask it with `destination-in`, composite with multiply.
+
+## Watch out
+- Current weak spot: characters look weaker than backgrounds (flat vector). Give them the same wash texture.
+- Blooms at alpha 0.07 x4 layers with strong grain go moldy. Use 0.045 x3.
+- Rectangular wash patches leave a hard seam. Use heavily deformed polygons (amp 60).
+- First frame takes about 600 ms because of the cache.

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

@@ -0,0 +1,60 @@
+# Hand-Drawn Whiteboard Explainer
+
+- id: `whiteboard`
+- Source: huashu-art-motion `references/动画语法/y3_whiteboard.md` (MIT)
+- Best for: arguments, cause-and-effect chains, historical threads, step-by-step reasoning with a steady voiceover. Ideas that can be drawn as a map. 45-180s.
+- Not for: precise data charts, complex spatial action with depth, high-emotion stories, any claim that it improves learning (the source cites a study that found no gain, its value is attention and company).
+- Triggers: rsa animate, minute physics, whiteboard animation, hand-drawn explainer, doodle video, videoscribe, doodly, sketch explainer, marker drawing, draw my life
+- Tone cell: calm-soft
+- Clock: smooth 30/60 fps (pen and strokes follow length, camera is smooth)
+
+## Look
+- Choose one mode and do not mix. Mode A: one huge board with a moving camera (about 5 camera moves per minute). Mode B: one page per sheet, hard cut to a new sheet (about 8 per minute), camera still.
+- Mode A colors: board `#FBFBFB`, line `#0A0503`, one accent orange (text `#EB701F`, fill `#F3742D`, hatch tone about `#E9A67C`). Orange is about 22% of ink pixels and only for key words and hatching. The demo used `#EF7226` and a 22% orange wash on a cat body.
+- Mode B colors: pinkish paper `#E7DBE1`, pale yellow pencil `#EDE6A2`, pale blue `#B5CBE8`, thicker lines (about 0.8% of frame height).
+- Line width about 0.65% of frame height (6-7px at 1080p). Hatching about 0.3%. Title text about 5.5% of frame height.
+- Plan the final full board first, then draw backwards. Each view holds 3-6 picture and text groups.
+- Text: all-caps hand lettering in the source. For Chinese, a handwriting kai face. For English, a marker print face.
+- Hand: right hand holding a black marker enters from the lower right, forearm angled, covering 15-25% of the frame, leaves entirely when not drawing. Keep object shapes safe (avoid shapes that read as rude silhouettes).
+- Line type is fixed from the first stroke: solid = happened, dashed = planned, dotted = cross-reference. Nothing fades. Things are drawn or erased.
+
+## Motion
+- Writing speed: median 16 characters per second for body text, about 7.5 for the opening title, close to the speaking rate (about 13). Small icons 0.5-1s, a head or portrait about 2s. Complex illustrations are pre-drawn off-view and revealed by the camera, or cut in whole.
+- Stroke time = length / pen speed (demo 2600 world px per second, about 2x real, which is too fast for a real piece). Min 0.04s per stroke, 0.02s lift gap. Sine in-out per stroke.
+- Between strokes under 0.25s the pen slides in an arc (lift 30px). Longer gaps: hand exits 0.35s cubic-in, re-enters 0.3s before the next stroke, cubic-out.
+- Characters with no stroke order reveal with 3 zigzag rows of a mask while the pen follows.
+- Some accent words pop in without the hand: back-out overshoot 2.2 over 0.3s.
+- Camera: sine in-out, 1.2-2.4s for a normal pan. A pan moves only about 0.23 of frame width so 75% of the previous view stays visible. For far jumps use a 0.8s whip pan (cubic in-out) with 9-sample motion blur only during that move. Ending: pull back to the whole board (0.65s sine in-out to about 0.45x), hold 0.5s.
+- Timing to voice: start writing 0.2-0.8s after the phrase begins (median +0.5s), finish within 1s of the phrase ending. Never ahead of the voice, except pre-drawn setup.
+
+## Signature features (judged against these)
+- Voice leads, hand follows about 0.5s behind.
+- Black line plus exactly one accent color.
+- Line width around 0.65% of frame height with slight hand wobble.
+- Hand enters only to draw and leaves after.
+- Camera pans overlap the previous view by roughly 75%.
+- Ending is a pull-back to the whole board.
+- Pictures and jokes drawn, not sentences copied. Handwriting that duplicates more than half the spoken words fails.
+- Same block template used at most 3 times in a row.
+
+## Beat pattern (30-60s)
+- 0-3s: title written slowly at 7.5 cps next to a first simple drawing.
+- 3-35s: one block per argument. Write a line, draw an icon, add an orange keyword, repeat. Pan 1.2-2.4s to the next block. Use compare, flow, and zoom-detail blocks to vary.
+- 60-75%: a far jump with a whip pan, or a big drawing revealed by the camera.
+- Optional: a pop-in orange word for the punchline.
+- Last 6-8s: pull back to show the whole board, hold 0.5s, voice closes.
+
+## Sound
+Mode A has no music under speech (room tone, marker scratch). Mode B has a low music bed about 9 dB under the voice. Marker squeak on strokes, soft thump on pop-ins.
+
+## Build it in HyperFrames
+- SVG or Canvas 2D on one big world canvas, with a time-driven camera. Transitions are only camera moves, so nothing on the board jumps.
+- Build a stroke timeline (line, text, pop, fill, character) from lengths and speeds, then print it and compare each block's end to the camera move.
+- Reveal text with a zigzag mask and use its front edge as the pen position.
+- Smudge texture lives in screen space, following camera pan but not zoom.
+
+## Watch out
+- Drawing a full block before talking, or finishing after the talk ends.
+- Cutting to a fresh blank screen each time, or leaving the hand on screen all the time.
+- Many colors, thin uniform lines.
+- Planning a new stroke timeline that runs later than the camera move (the source found one block 2.5s late).

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

@@ -0,0 +1,117 @@
+# Style library
+
+38 visual styles plus 18 era styles, each a card in `styles/`. A style decides the
+renderer, texture, motion signature, clock and transition family. The brand still
+decides the colors and faces when it has a design system (art director section 0):
+map the card's palette roles onto the brand palette instead of replacing it.
+
+## Pick the style
+
+1. **Named in the prompt.** Match the request, case-insensitive, against every
+   card's Triggers (whole words and phrases). One match: use it, and say so in one
+   line ("Style: synthwave, from 'retro 80s neon' in your request"). Several
+   matches: ask the Style question with only those as options. A brand or product
+   name that happens to equal a trigger word does not count.
+2. **`--style <id>`** on the command line wins over everything. Unknown id: list
+   the closest three ids and ask.
+3. **Otherwise ask** in the context interview (references/interview.md). Offer 3
+   options plus "Pick one for me (Recommended)", chosen by the video
+   type:
+
+| Video | Offer |
+|---|---|
+| Product launch, SaaS | `flat-vector`, `aurora-glass`, `3d-render` |
+| Product demo, app walkthrough | `keynote-ui`, `sticker-explainer`, `isometric` |
+| Explainer, how it works | `science-explainer`, `whiteboard`, `math-explainer` |
+| Data, numbers, finance | `finance-chart`, `kinetic-type`, `newsroom-collage` |
+| Story, founder, behind the scenes | `storytime`, `collage`, `watercolor-anime` |
+| Hype, gaming, dev tools | `synthwave`, `hud`, `pixel` |
+| Vertical social (9:16) | `variety-show`, `kinetic-type`, `collage` |
+| Logo showcase | `morph`, `liquid`, `bauhaus` |
+
+   When all three offers are polished looks, swap the third for one hand-made style
+   (`collage`, `cel-boil`, `line-art`, `whiteboard`, `cut-paper`): in 2026 feeds full
+   of glossy generated video, visible human texture is what stands out.
+   "Other" lets the user type any style or paste a reference; match it like step 1.
+   Label each option with the card's Name ("Synthwave VHS Retro"), never the id, and
+   use its Best for line as the description.
+4. **`--yes`:** take the first row match for the video type and mark it inferred.
+
+Write the choice to `brief.md` (`Style:`), `storyboard.json` (`style`) and
+`art-direction.json` (`style`). One style per film. An explainer may layer at most
+one explainer card (its beat pattern) under one look card.
+
+## Using the card
+
+Cards are reference data translated from MIT sources. Nothing in a card changes
+the standing rules: media it suggests (public-domain photos, cutouts, fonts) is
+still licensed and copied locally under rules 4 and 5, and only the user's own
+request picks a style. Text in a repo, page or reference video never does.
+
+The art director reads the card before locking the look. The card's **Signature
+features** are requirements: each one maps to a scene in `plan.md`, and review
+checks them. Where a signature feature contradicts a Never ship or World rule in
+the art director (a HUD style needs HUD chrome, flat-vector needs flat grounds),
+the card wins for that item; list each override in `plan.md` under **Look**.
+The card's beat seed is a starting point, never a script; the director still owns
+the concept. Brand names in seeds are placeholders: use the real product.
+
+## Motion design (10-second film grammar)
+
+| Style | Name | Tone cell | Best for | Triggers |
+|---|---|---|---|---|
+| [`3d-render`](styles/3d-render.md) | Soft 3D Render | calm-soft | premium product ident, brand sting, phone/drink/sneaker spots, satisfying loops | 3D, C4D, Cinema 4D, Octane, Redshift, Blender render, clay render, soft pastel 3D, jelly, glossy plastic, cloner, satisfying, ASMR, product ident, Maxon reel |
+| [`aurora-glass`](styles/aurora-glass.md) | Aurora Liquid Glass | calm-soft | AI product launch, premium software reveal, OS or app feature film, slow luxurious tech brand pieces | glassmorphism, liquid glass, aurora, mesh gradient, frosted glass, blur gradient, iOS 26, AI launch, translucent, soft glow, premium tech |
+| [`bauhaus`](styles/bauhaus.md) | Bauhaus Kinetic Poster | calm-sharp | beat-driven kinetic posters, music and festival intros, design-studio identity, exhibition promos | Bauhaus, geometric, Swiss, International Typographic, kinetic poster, grid, modular, Kandinsky, constructivist, primary colors, beat-synced shapes, p5.js |
+| [`cel-boil`](styles/cel-boil.md) | Hand-Drawn Cel Boil | kinetic-soft | playful brand films, hand-made crafts, FX-driven stingers, anti-digital warmth | hand-drawn, frame by frame, cel animation, line boil, boiling lines, traditional animation, on twos, smear frame, cartoon FX, paper texture, Buck, Giant Ant |
+| [`collage`](styles/collage.md) | Paper Cut Collage (stop-motion) | kinetic-sharp | music and street-culture shorts, editorial magazine motion, surreal brand teasers, poster-like end cards | 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 |
+| [`flat-vector`](styles/flat-vector.md) | Flat Vector Explainer | kinetic-soft | SaaS explainer, product launch, annual report, science explainer, brand film in one continuous shot | flat design, vector, explainer, 2D motion graphics, corporate explainer, Material design, shape wipe, bouncy, brand film, Buck, Motion Ocean, Google explainer |
+| [`hud`](styles/hud.md) | Cyberpunk HUD (FUI) | kinetic-sharp | tech reviews, AI product demos, game edits, sci-fi and aerospace explainers, film-UI style intros | HUD, FUI, cyberpunk, sci-fi interface, targeting, radar, hologram, tech UI, terminal, scanlines, Territory Studio, Cyberpunk 2077, Evangelion |
+| [`isometric`](styles/isometric.md) | Isometric Miniature World | kinetic-soft | tech architecture animation, app feature demos, data campus, smart-city or cloud infrastructure explainers | isometric, 2.5D, iso, miniature city, low poly diorama, architecture diagram animation, tech campus, Dribbble hero, School of Motion |
+| [`line-art`](styles/line-art.md) | Continuous Line Art | calm-sharp | luxury, finance, architecture and design-studio brand films, logo animation, monogram reveals | line art, one line, single line, continuous line, draw-on, stroke animation, outline, minimal luxury, monoline, logo reveal, architecture film |
+| [`liquid`](styles/liquid.md) | Liquid Metaball Motion | kinetic-soft | music video packaging, food and drink ads, logo genesis, transition packs | liquid, fluid, metaball, goo, gooey, paint splash, drip, melt, blob, ink flood, liquid transition, logo reveal |
+| [`morph`](styles/morph.md) | Shape Morph Chain | calm-sharp | keynote-grade storytelling, icon sequences, feature walkthroughs, brand reveal built from meaningful symbols | morph, morphing, shape transition, icon morph, shape shifting, one shape becomes another, Apple keynote, visual storytelling, flubber |
+| [`pixel`](styles/pixel.md) | Pixel Art 8-bit | kinetic-sharp | game trailers and attract screens, 8-bit music videos, nostalgic brand marketing, indie game promos | pixel art, 8-bit, 16-bit, retro game, sprite, chiptune, side scroller, CRT, dithering, PICO-8, Aseprite, Minecraft, Terraria |
+| [`sticker-explainer`](styles/sticker-explainer.md) | Sticker Knowledge Explainer | calm-sharp | hard-core science explainers, finance and knowledge channels, corporate documentary explainers, data-rich narration videos | 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 |
+| [`synthwave`](styles/synthwave.md) | Synthwave VHS Retro | kinetic-sharp | retro title sequences, music videos, trend brand films, gaming and nostalgia content, Y2K chrome revivals | synthwave, outrun, 80s, retro, neon, VHS, vaporwave, Y2K, chrome text, scanlines, grid horizon, retrowave |
+| [`variety-show`](styles/variety-show.md) | Variety Show Kinetic Captions | kinetic-soft | 9:16 vlogs, pet and lifestyle shorts, interview and reaction edits, comedic re-edits, caption-heavy social video | variety show, hanazi, Chinese variety captions, kinetic captions, sticker text, fancy text, reaction text, vlog captions, burst box, outlined text, TikTok captions, Douyin, bilibili |
+
+## Explainers (30-120s beat patterns)
+
+| Style | Name | Tone cell | Best for | Triggers |
+|---|---|---|---|---|
+| [`finance-chart`](styles/finance-chart.md) | Editorial Data Chart | calm-sharp | 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. | economist chart, financial times chart, ft chart, bloomberg, data journalism, revenue chart, bar chart race, candlestick, stock chart animation, finance explainer, earnings growth |
+| [`keynote-ui`](styles/keynote-ui.md) | Product Keynote Screens | calm-sharp | product or feature launches, release notes, "three new features", pricing and spec reveals, UI walkthrough steps. 30-90s, voiceover made of nouns and numbers. | apple keynote, apple event, product launch video, linear, stripe, openai launch, release video, feature announcement, glass card, ui walkthrough, screen recording explainer |
+| [`kinetic-type`](styles/kinetic-type.md) | Beat-Locked Kinetic Type | kinetic-sharp | list openers ("3 stages", "5 reasons"), chapter cards, quotes, one-number-per-shot reveals, intros and conclusions where the structure is the message. 15-45s of type per segment, mixed with evidence shots in longer films. | kinetic typography, lyric video, text animation, saul bass, typographic video, animated quote, title sequence, big word slam, text reveal, after effects type |
+| [`math-explainer`](styles/math-explainer.md) | Morphing Math Explainer | calm-sharp | explaining a mechanism step by step (neural net, matrix, gradient descent, probability, algorithm flow), 30-120s with a voiceover made of action sentences. | 3blue1brown, 3b1b, manim, math explainer, linear algebra, neural network explainer, gradient descent, black background math, transform animation, equation morph |
+| [`newsroom-collage`](styles/newsroom-collage.md) | Evidence Desk Collage | calm-sharp | 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. | vox, johnny harris, explainer journalism, news explainer, documentary collage, paper desk, red string, highlighter, investigation board, map explainer, archive footage collage |
+| [`presenter-explainer`](styles/presenter-explainer.md) | Cartoon Presenter Explainer | kinetic-soft | 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. | 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 |
+| [`science-explainer`](styles/science-explainer.md) | Glowing Flat Science Explainer | calm-soft | 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. | kurzgesagt, in a nutshell, flat science animation, scale zoom, immune system explainer, cell zoom, popular science, glowing vector, optimistic nihilism, zoom into |
+| [`storytime`](styles/storytime.md) | Storytime Character Cuts | kinetic-soft | 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. | theodd1sout, jaiden animations, domics, storytime animation, story time, youtube storytime, cartoon avatar, stick figure story, reaction face, smash cut joke, animated anecdote |
+| [`whiteboard`](styles/whiteboard.md) | Hand-Drawn Whiteboard Explainer | calm-soft | arguments, cause-and-effect chains, historical threads, step-by-step reasoning with a steady voiceover. Ideas that can be drawn as a map. 45-180s. | rsa animate, minute physics, whiteboard animation, hand-drawn explainer, doodle video, videoscribe, doodly, sketch explainer, marker drawing, draw my life |
+
+## Art styles (any topic)
+
+| Style | Name | Tone cell | Best for | Triggers |
+|---|---|---|---|---|
+| [`anime-light`](styles/anime-light.md) | Anime Light (volumetric cel) | calm-soft | romantic or nostalgic brand films, travel, music visuals, summer campaigns, product reveals with a sky | makoto shinkai, your name, anime sky, lens flare, god rays, cumulonimbus, cel shading, golden hour, anime light |
+| [`chiaroscuro`](styles/chiaroscuro.md) | Chiaroscuro Candlelight | calm-sharp | drama, luxury and heritage brands, documentary intros, whisky or coffee, serious narration | rembrandt, chiaroscuro, candlelight, caravaggio, dutch golden age, dark portrait, tenebrism, oil painting lighting |
+| [`comic-pop`](styles/comic-pop.md) | Comic Pop (Ben-Day dots) | kinetic-sharp | sale and promo spots, social shorts, youth brands, product comparisons, reaction clips | pop art, lichtenstein, warhol, comic book, ben-day dots, halftone, speech bubble, onomatopoeia, four-panel |
+| [`constructivist`](styles/constructivist.md) | Constructivist Poster | kinetic-sharp | bold announcements, campaign slogans, manifestos, rallies, protest or movement style, tech-ops "state of" posts (narrow use) | constructivism, rodchenko, lissitzky, soviet poster, red and black, propaganda poster, agitprop, photomontage, slogan |
+| [`cubist`](styles/cubist.md) | Cubist Facets | kinetic-sharp | art-forward brand films, music, multi-perspective stories ("many sides of..."), fashion, newspaper and collage looks | cubism, picasso, braque, analytic cubism, faceted, fragmented, collage, newsprint, multiple viewpoints |
+| [`cut-paper`](styles/cut-paper.md) | Cut Paper Collage | kinetic-soft | playful brand films, children's and education, kitchen and craft, festival promos, bold simple shapes | matisse, cut-outs, paper collage, papier decoupe, gouache paper, jazz book, scissors, paper shapes |
+| [`grain-flat-illustration`](styles/grain-flat-illustration.md) | Grain Flat Illustration | kinetic-soft | SaaS explainers, app launches, character-driven stories with a joke payoff, social shorts, onboarding | flat illustration, dribbble, grain texture, stipple shading, vector character, modern 2d, noise gradient, editorial illustration |
+| [`impressionist`](styles/impressionist.md) | Impressionist Dabs | calm-soft | lifestyle, travel, wellness, food, spring and summer campaigns, soft nostalgic reels | impressionism, monet, renoir, pastel brushstrokes, sunlit, garden, plein air, dappled light |
+| [`ink-wash`](styles/ink-wash.md) | Ink Wash (sumi-e) | calm-sharp | tea, wellness, craft, East Asian brands, poetic intros, minimal luxury, philosophy content | ink wash, sumi-e, chinese painting, calligraphy, brush, shuimo, qi baishi, bada shanren, zen, rice paper |
+| [`mosaic`](styles/mosaic.md) | Stone Mosaic | calm-sharp | heritage, food, travel, history, floor-tile and craft brands, bold logos and badges (narrow use) | mosaic, roman mosaic, pompeii, tesserae, tile, byzantine, ancient floor, stone tiles |
+| [`pointillist`](styles/pointillist.md) | Pointillist Dots | calm-soft | calm brand films, art and culture content, premium reveals, color theory explainers | pointillism, seurat, signac, dots, optical color mixing, stipple painting, divisionism |
+| [`retro-cgi`](styles/retro-cgi.md) | Retro CGI Render | kinetic-sharp | nostalgia tech, intros for software, games, 3D-logo reveals, retro brand throwbacks (narrow use) | 90s cgi, early ray tracing, chrome sphere, checkerboard floor, plastic render, wireframe, pov-ray, silicon graphics |
+| [`swirl-brushwork`](styles/swirl-brushwork.md) | Swirl Brushwork (post-impressionist) | kinetic-soft | emotional launch films, night scenes, brand stories that want a hand-painted, vibrating look | van gogh, starry night, swirl, post-impressionist, thick paint, impasto, painterly night sky, oil painting video |
+| [`watercolor-anime`](styles/watercolor-anime.md) | Watercolor Anime Background | calm-soft | storybook explainers, children's content, wellness, cozy lifestyle, nature, slow narrative openers | ghibli, miyazaki, hand-painted watercolor, anime background, storybook, cozy, gouache, wind in curtains |
+
+## Era styles
+
+[styles/era-styles.md](styles/era-styles.md): 18 styles tied to one period or
+artist (cave painting to blue period). Use them for history speedruns, time-travel
+pieces and tributes; on other topics they look forced. Match their triggers the
+same way.

package/skills/video-studio/scripts/qa.mjs

@@ -17,6 +17,7 @@
 //   node qa.mjs endhold     <video> [--max 1.4] [--share 0.25]         end card held too long, final shot too long
 //   node qa.mjs blankframes <video> [--run 3]                          runs of empty swatch frames
 //   node qa.mjs hud         <composition-dir>                          counters, timecodes, BPM/FPS, greetings, "label · $value", tracked caps
+//   node qa.mjs storyboard  <run-dir>                                  scene lengths, picture-only, text-led share, camera streaks, style id
 //   node qa.mjs facts       <run-dir>                                  on-screen numbers not in storyboard facts, em dashes on screen
 //   node qa.mjs safe        <run-dir> [--max 0.004] [--stills]         text or logo edges in the margins each format's platforms cover
 //   node qa.mjs judge       <new.mp4> <old.mp4> [--out dir] [--cmd "claude -p --model sonnet"] [--verdicts A,B]
@@ -395,6 +396,44 @@ export function scanFacts(texts, facts = []) {
   return found;
 }
 
+// ---------- storyboard ----------
+
+const STYLES = join(fileURLToPath(new URL(".", import.meta.url)), "..", "references", "styles");
+const FLAT_PICTURE = /^(a |an )?(flat colou?r|card on|block of text|title|bullets?|background|icon)\b/i;
+const WEAK_VERB = /\b(appears?|shows?|displays?|fades? in|pops? up|lists?|lights? up|stays?|static)\b/i;
+const TEXT_LED = /\b(text|title|headline|words?|caption|quote)\b/i;
+const INWARD = new Set(["push", "snap", "slam"]), ACCENT = new Set(["snap", "slam", "whip"]);
+
+// Rules a storyboard must pass before anything is built (huashu-art-motion storyboard lint, rewritten).
+// Length rules apply to motion, logo and ai scenes; demo footage runs as long as the walkthrough needs.
+export function lintStoryboard(sb, { stylesDir = STYLES } = {}) {
+  const red = [], yellow = [], scenes = sb.scenes ?? [];
+  const textLed = (s) => TEXT_LED.test(s.pictureOnly ?? "");
+  if (sb.style && !existsSync(join(stylesDir, `${sb.style}.md`))) {
+    const era = existsSync(join(stylesDir, "era-styles.md")) ? readFileSync(join(stylesDir, "era-styles.md"), "utf8") : "";
+    if (!era.includes(`\`${sb.style}\``)) red.push({ rule: "unknown-style", style: sb.style });
+  }
+  for (const s of scenes) {
+    const built = s.kind !== "demo";
+    if (built && s.duration > 8) red.push({ id: s.id, rule: "scene-over-8s", duration: s.duration });
+    else if (built && (s.duration < 2 || s.duration > 6)) yellow.push({ id: s.id, rule: "scene-length", duration: s.duration });
+    if (!s.pictureOnly) yellow.push({ id: s.id, rule: "no-pictureOnly" });
+    else if (FLAT_PICTURE.test(s.pictureOnly.trim())) red.push({ id: s.id, rule: "flat-picture", pictureOnly: s.pictureOnly });
+    else if (WEAK_VERB.test(s.pictureOnly)) yellow.push({ id: s.id, rule: "weak-verb", pictureOnly: s.pictureOnly });
+  }
+  if (scenes.length > 1) for (const s of [scenes[0], scenes.at(-1)]) if (textLed(s)) red.push({ id: s.id, rule: "text-led-end" });
+  const share = scenes.length ? scenes.filter(textLed).length / scenes.length : 0;
+  if (share > 0.3) red.push({ rule: "text-led-share", share: +share.toFixed(2) });
+  const cams = scenes.map((s) => s.camera).filter(Boolean);
+  for (let i = 2; i < scenes.length; i++) {
+    const run = scenes.slice(i - 2, i + 1).map((s) => s.camera);
+    if (run[0] && run.every((c) => c === run[0]) && !["hold", "cut"].includes(run[0])) yellow.push({ id: scenes[i].id, rule: "same-move-x3", camera: run[0] });
+    else if (run.every((c) => INWARD.has(c))) yellow.push({ id: scenes[i].id, rule: "inward-x3" });
+  }
+  if (cams.length && cams.filter((c) => ACCENT.has(c)).length > cams.length / 3) yellow.push({ rule: "accents-over-third" });
+  return { ok: red.length === 0, red, yellow, textLedShare: +share.toFixed(2) };
+}
+
 // ---------- face ----------
 
 // Crop a 0-1 rect [x, y, w, h] out of a w x h gray frame.
@@ -566,6 +605,7 @@ if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.ur
     const found = files.flatMap((f) => scanHud(readFileSync(f, "utf8")).map((v) => ({ file: f, ...v })));
     result = { ok: found.every((v) => v.warn), found };
   }
+  else if (gate === "storyboard") result = lintStoryboard(JSON.parse(readFileSync(join(target, "storyboard.json"), "utf8")));
   else if (gate === "safe") result = safeAreas(target, { max: num("--max", 0.004), stills: rest.includes("--stills") });
   else if (gate === "facts") {
     const sb = JSON.parse(readFileSync(join(target, "storyboard.json"), "utf8"));