@docyrus/animaguru 0.23.0 → 0.25.0

package/NOTICE.md

@@ -1551,6 +1551,30 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
 
+mg-styles-15
+MIT License
+
+Copyright (c) 2026 Vincentwei1021
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
 ## Art Motion references
 
 English adaptations of Huashu Art Motion (https://github.com/alchaincyf/huashu-art-motion). Source revision and coverage are in skills/animaguru-art-motion/references/coverage.json.

package/README.md

@@ -43,9 +43,13 @@ CLI versions before 0.16.2 need one manual update to gain enforcement. Publish t
 
 CLI 0.23.0 adds eight evidence styles, in which real data, imagery or scans carry the film: Satellite Briefing, Engineering Briefing Board, LiDAR Survey, White Model Projection, Data Physicalization, Exploded Teardown, Microscope Story and Archive Light Table. Their skills ask for the user's own data first, list licence-clean sources, keep `production/FACTS.md` and `production/CREDITS.md`, and never let a generated image stand in for evidence. Each has a runnable study (`npm run example -- satellite-briefing`).
 
+CLI 0.24.0 adds eight documentary & broadcast styles, cut from real archive footage, documents and data: Caption News, 1920s Newsreel, Live Countdown Split-screen, Time-lapse Symphony, Visual Investigation, Constructivist Montage, Sports Telestrator and Broadcast News Package. Their skills carry the same real-evidence and sourcing discipline as the evidence styles, with licence-clean archive and footage sources per style. Each has a runnable study (`npm run example -- caption-news`).
+
+CLI 0.25.0 adds seven contemporary motion-design styles: Aurora & Glass, Liquid Motion, Bauhaus Geometry, Synthwave & Y2K, Sticker Explainer, Variety Captions and One-Line Art. Their signature techniques follow the MIT-licensed [mg-styles-15](https://github.com/Vincentwei1021/mg-styles-15) collection; the skills, studies and preview art are original. Each has a runnable study (`npm run example -- aurora-glass`).
+
 CLI 0.16.2 also installs `animaguru-art-motion` for Codex and Claude Code: one skill with 36 English art-treatment references and nine explainer motion grammars, plus AnimaGuru generation, timing, camera and review guidance. Request it explicitly for a custom film treatment; its references are separate from the gallery presets. Source coverage and the upstream MIT notice are included in the skill.
 
-CLI 0.5.2 includes a complete local PixiJS video workspace, now with 40 visual styles:
+CLI 0.5.2 includes a complete local PixiJS video workspace, now with 55 visual styles:
 
 ```sh
 animaguru templates
@@ -61,7 +65,7 @@ Open the generated folder in **Codex or Claude Code**, then describe the video y
 - Agent instructions that first ask **Explainer, Advertisement or General Video**, then offer the available visual styles and [the preview gallery](https://animaguru.com/animation-styles), then gather a short creative brief. Each choice is saved before continuing.
 - `film.config.json`, editable TypeScript scenes, localized copy, local asset/production folders, portable HTML5 ZIP export for iframe embedding, and `npm run export:mp4` with exact frame capture and output verification.
 
-New projects leave category and template unset in `animaguru.project.json`. `animaguru.templates.json` lists categories, styles and their installed skills. The 40 visual styles cover cutout, type, vector, technical, evidence, character, print, paper, material and cinematic treatments. Every style skill ships with the project, including its relevant visual interview and review criteria. Categories describe purpose and templates describe appearance and motion. The brief establishes audience, tone, message, story, duration and any CTA.
+New projects leave category and template unset in `animaguru.project.json`. `animaguru.templates.json` lists categories, styles and their installed skills. The 55 visual styles cover cutout, type, vector, technical, evidence, documentary, character, print, paper, material and cinematic treatments. Every style skill ships with the project, including its relevant visual interview and review criteria. Categories describe purpose and templates describe appearance and motion. The brief establishes audience, tone, message, story, duration and any CTA.
 
 CLI 0.23.0 also adds **Machine Anatomy** (`machine-anatomy`): an idea explained as a working isometric machine of many small shaded parts in a framed figure card with a live readout. Adapted from the MIT-licensed [Anatomy](https://github.com/wheresryan22/anatomy) skill, it bundles that skill's geometry kit in `src/kit/anatomy/` with a PixiJS adapter, and `npm run example -- machine-anatomy` installs its original study.
 

package/dist/animaguru.js

@@ -19761,7 +19761,7 @@ var require_ignore2 = __commonJS({
 // cli/package.json
 var package_default = {
   name: "@docyrus/animaguru",
-  version: "0.23.0",
+  version: "0.25.0",
   description: "Agent-friendly AnimaGuru CLI built with CrustJS",
   type: "module",
   bin: {
@@ -46017,6 +46017,261 @@ var animation_styles_default = {
       previewCaption: "Three NASA Ames photographs of one airfield on a light table; under the loupe a 1933 negative turns positive and opens into the picture. Public-domain NASA scans; the negatives are simulated.",
       family: "evidence",
       example: true
+    },
+    "caption-news": {
+      name: "Caption News",
+      description: "Huge chunk-slammed captions carry a story that reads with the sound off, while footage, documents and data each arrive with the source tag that proves them.",
+      materials: [
+        "Chunk-slammed captions",
+        "Source-tagged footage",
+        "Document highlighter sweeps"
+      ],
+      motion: [
+        "Frame-4 rolling number hook",
+        "Keyword wipes in yellow",
+        "Highlighter sweep on the page"
+      ],
+      previewCaption: "A hook number rolls in the opening frames, a chunk-slammed caption lands its yellow keyword, and a report page is highlighted before its figure is trusted. Procedural stand-ins for the footage and document, not real sources.",
+      family: "documentary",
+      example: true
+    },
+    newsreel: {
+      name: "1920s Newsreel",
+      description: "A searchlight-and-globe ident, a newspaper spinning into the lens, and a fast announcer carried by a hot band, all inside one silver-graded projector gate.",
+      materials: [
+        "Projected film gate",
+        "Art Deco ident lettering",
+        "Grease-pencil marks"
+      ],
+      motion: [
+        "Globe-and-searchlight ident",
+        "Spinning newspaper slam",
+        "Iris wipe to the next story"
+      ],
+      previewCaption: "The ident's searchlights snap on, a globe turns under the title, and a headline spins into the lens before the iris closes on a place card. Code-drawn packaging only; no archive footage is shown.",
+      family: "documentary",
+      example: true
+    },
+    countdown: {
+      name: "Live Countdown Split-screen",
+      description: "Real-time footage of one event with a known zero, the screen splitting into more cells as the moment nears and merging into a single picture when the clock hits it.",
+      materials: [
+        "Synced camera cells",
+        "Fixed-slot digit clock",
+        "Sync badges"
+      ],
+      motion: [
+        "Cells multiplying toward zero",
+        "Many-into-one merge at zero",
+        "Clock inversion at T plus"
+      ],
+      previewCaption: "Cells multiply as the clock counts down, merge into one frame at zero, and the clock flips from counting down to counting up. Illustrative camera feeds, not a real launch.",
+      family: "documentary",
+      example: true
+    },
+    "city-symphony": {
+      name: "Time-lapse Symphony",
+      description: "Time-lapse turns traffic and crowds into rivers of light, cut like a minimalist score that accelerates to a climax and stops dead on a downbeat.",
+      materials: [
+        "Frame-blended light trails",
+        "35mm release-print grade",
+        "Day-ring clock graphic"
+      ],
+      motion: [
+        "Traffic sped into light rivers",
+        "Grid of streets multiplying",
+        "Hard cut to black on the beat"
+      ],
+      previewCaption: "Traffic blurs into rivers of light as a grid of streets multiplies on the beat, then the score stops dead and the film cuts to black. Procedural city, not a real skyline.",
+      family: "documentary",
+      example: true
+    },
+    "visual-investigation": {
+      name: "Visual Investigation",
+      description: "Footage, documents and sound from one real event laid out on a shared clock, so independent sources check each other and converge on the same second.",
+      materials: [
+        "Synced evidence panels",
+        "Grey ground, one red accent",
+        "Freeze-circle-magnify marks"
+      ],
+      motion: [
+        "Panels syncing to one stopwatch",
+        "Freeze, circle and loupe",
+        "Converging red links to a map"
+      ],
+      previewCaption: "Three sources light up against one stopwatch, a frozen frame is circled and magnified, and every red link converges on the same point of a map. Illustrative evidence panels, not a real case.",
+      family: "documentary",
+      example: true
+    },
+    "kino-montage": {
+      name: "Constructivist Montage",
+      description: "Real footage and photographs printed as one red-and-ink poster and cut on a machine beat, with scissored figures stacked into the structure they built.",
+      materials: [
+        "Red, ink and paper print",
+        "Diagonal type bands",
+        "Photomontage cut-outs"
+      ],
+      motion: [
+        "Grid lighting cell by cell",
+        "Figures stacking into a tower",
+        "Red wipe on the downbeat"
+      ],
+      previewCaption: "A grid lights cell by cell, cut-out figures climb and stack into a tower, and a red band wipes to the count on the downbeat. Illustrative silhouettes, not real archive photographs.",
+      family: "documentary",
+      example: true
+    },
+    telestrator: {
+      name: "Sports Telestrator",
+      description: "Play it, rewind it, freeze it: rings under the feet, a marker arrow on the ball, and the picture flattened into a top-down board, drawn over real match footage.",
+      materials: [
+        "Marker rings and arrows",
+        "Frame-counting stopwatch",
+        "Perspective-flattened pitch board"
+      ],
+      motion: [
+        "Rewind into a freeze",
+        "Ring and arrow drawn on the play",
+        "Perspective flatten to the board"
+      ],
+      previewCaption: "A play rewinds into a freeze, a ring and an arrow mark the move, and the picture flattens into a top-down board with the shot plotted on it. Illustrative match, not a real game.",
+      family: "documentary",
+      example: true
+    },
+    "news-package": {
+      name: "Broadcast News Package",
+      description: "A newsroom bulletin built entirely in code: a sting that becomes the channel bug, a rundown ticked off story by story, and a strap that never leaves the frame.",
+      materials: [
+        "Brand plate sting and bug",
+        "Split-flap price board",
+        "Lower-third strap"
+      ],
+      motion: [
+        "Sting flying into the corner bug",
+        "Rundown rows flipping and ticking",
+        "Split-flap board changing value"
+      ],
+      previewCaption: "The sting slams in and flies to the corner bug, a rundown's rows flip and tick off one by one, and a split-flap board turns an old value into the new. Illustrative bulletin, procedural graphics throughout.",
+      family: "documentary",
+      example: true
+    },
+    "aurora-glass": {
+      name: "Aurora & Glass",
+      description: "Slow drifting fields of blurred colour under frosted glass cards with hairline highlights, where everything breathes and nothing hurries.",
+      materials: [
+        "Blurred aurora colour fields",
+        "Frosted glass cards",
+        "Hairline light edges"
+      ],
+      motion: [
+        "Slow colour-field drift",
+        "Cards surfacing through blur",
+        "Light sliding along glass edges"
+      ],
+      previewCaption: "Frosted cards surface over drifting aurora light, a clear glass lens glides across the question and magnifies it, then settles into the title capsule as the cards fall back out of focus. An invented product, rendered entirely in code.",
+      family: "graphic",
+      example: true
+    },
+    "liquid-motion": {
+      name: "Liquid Motion",
+      description: "Glossy liquid that pours, stretches into thin necks, snaps and fuses, with wave-front wipes and droplets that land a beat behind.",
+      materials: [
+        "Glossy candy liquid",
+        "Metaball merges",
+        "Droplets and splashes"
+      ],
+      motion: [
+        "Wave-front liquid wipes",
+        "Neck stretch, snap and rebound",
+        "One drop pouring into a mark"
+      ],
+      previewCaption: "Drops splash into a tangerine pool, blobs tear free on thinning necks and fuse into one swirling drop, two paint waves flood across behind it, and the drop pours into a glossy wordmark before a drip snaps off its p.",
+      family: "material",
+      example: true
+    },
+    "bauhaus-geometry": {
+      name: "Bauhaus Geometry",
+      description: "Circles, triangles and bars in primary colours move only along a strict grid, one exact action per beat, like a poster that keeps rebuilding itself.",
+      materials: [
+        "Primary-colour geometry",
+        "Strict modular grid",
+        "Printed poster type"
+      ],
+      motion: [
+        "Grid-locked moves on the beat",
+        "Pivots on centres, corners and the frame",
+        "Mechanical, overshoot-free easing"
+      ],
+      previewCaption: "A grid draws itself and shapes land on its lines one beat at a time, the whole poster turns about its centre, quarter turns ripple through a row of tiles, and the type locks in before the camera pulls back to the printed sheet. Drawn entirely in code.",
+      family: "graphic",
+      example: true
+    },
+    "synthwave-y2k": {
+      name: "Synthwave & Y2K",
+      description: "A neon perspective grid under a slatted sunset, chrome lettering with a lens flare and pop-up desktop windows, all played back through a flickering VHS deck.",
+      materials: [
+        "Neon grid and slatted sun",
+        "Bevelled chrome lettering",
+        "VHS scanlines and colour bleed"
+      ],
+      motion: [
+        "Endless grid run to the horizon",
+        "Chrome title slam with flare and glint",
+        "Pop-ups, cursor drags and tape glitches"
+      ],
+      previewCaption: "The VCR's blue screen rolls into a neon grid racing at a slatted sun, a chrome title slams in with a flare and a tape stutter, a neon script strikes on, and a pop-up is dragged aside and clicked before the windows switch off like a tube. Drawn entirely in code.",
+      family: "cinematic",
+      example: true
+    },
+    "sticker-explainer": {
+      name: "Sticker Explainer",
+      description: "Cut-out photos with thick white borders, flat icons and exact charts laid across one huge board, linked by long camera moves while every line of narration adds a new piece.",
+      materials: [
+        "White-bordered photo stickers",
+        "Flat icons and exact charts",
+        "Calm blue-grey board"
+      ],
+      motion: [
+        "Long eased pans and zooms",
+        "Stickers slapped onto the board",
+        "Counters and bars on every line"
+      ],
+      previewCaption: "Coffee stickers slap onto one blue-grey board as the camera travels from fact to fact, counters roll and bars grow with each narration line, and the board pulls back to the sum in the middle. Procedural stickers and rounded figures, not real photographs.",
+      family: "technical",
+      example: true
+    },
+    "variety-captions": {
+      name: "Variety Captions",
+      description: "TV variety-show captions: chunky rounded type in layered outlines pops onto the footage a beat after every gag, and every feeling gets its own reaction mark.",
+      materials: [
+        "Layered-outline rounded type",
+        "Burst frames, sweat drops and sparkles",
+        "Bright, clashing colour"
+      ],
+      motion: [
+        "Overshoot pops on the gag",
+        "Letter-by-letter bounces",
+        "Freeze-frame shock bursts"
+      ],
+      previewCaption: "A cat bats a mug to the edge as question marks bounce in, the freeze frame gets a NOT THE MUG!! burst, a sweat drop slides past a deadpan stare, and a stamp lands on zero regrets. Procedurally rendered stand-in footage, not a real clip.",
+      family: "graphic",
+      example: true
+    },
+    "one-line-art": {
+      name: "One-Line Art",
+      description: "A single thin line draws one figure, keeps going and becomes the next, carrying the whole film in one unbroken stroke across open space.",
+      materials: [
+        "One constant-width line",
+        "One or two colours",
+        "Generous negative space"
+      ],
+      motion: [
+        "Self-drawing stroke",
+        "Figures flowing into each other",
+        "Line turning into a filled mark"
+      ],
+      previewCaption: "One champagne line draws a sun on the horizon, three arches and a woman's profile without lifting, closes a ring that fills with gold from the point where it met, then pulls back to the wordmark. Invented brand, drawn entirely in code.",
+      family: "graphic",
+      example: true
     }
   },
   browseStyles: "Browse animation styles",
@@ -46031,7 +46286,8 @@ var animation_styles_default = {
     character: "Character & pixel",
     material: "Materials & depth",
     cinematic: "Cinema & media",
-    evidence: "Evidence & data"
+    evidence: "Evidence & data",
+    documentary: "Documentary & broadcast"
   },
   searchLabel: "Search visual styles",
   searchPlaceholder: "Try paper, product, typography\u2026",
@@ -46149,7 +46405,22 @@ var VIDEO_STYLE_IDS = [
   "data-physicalization",
   "exploded-teardown",
   "microscope-story",
-  "archive-light-table"
+  "archive-light-table",
+  "caption-news",
+  "newsreel",
+  "countdown",
+  "city-symphony",
+  "visual-investigation",
+  "kino-montage",
+  "telestrator",
+  "news-package",
+  "aurora-glass",
+  "liquid-motion",
+  "bauhaus-geometry",
+  "synthwave-y2k",
+  "sticker-explainer",
+  "variety-captions",
+  "one-line-art"
 ];
 var VIDEO_WORKFLOW_IDS = [
   "product-proof",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docyrus/animaguru",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "description": "Agent-friendly AnimaGuru CLI built with CrustJS",
   "type": "module",
   "bin": {

package/skills/animaguru-aurora-glass/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: animaguru-aurora-glass
+description: Build Aurora & Glass visuals and motion in an AnimaGuru PixiJS video workspace. Use when this visual style is chosen for an explainer, advertisement or general video.
+disable-model-invocation: true
+---
+
+# Aurora & Glass
+
+Slow drifting fields of blurred colour under frosted glass cards with hairline highlights: the calm, translucent look of current product and AI launches, where everything breathes and nothing hurries. Subject, audience, emotional tone and story come from the user's brief. This style supports Explainer, Advertisement and General Video.
+
+## Establish direction
+
+Follow sibling `animaguru-video` for purpose → style → compact interview before new production. Reuse explicit choices and completed briefs; honor a requested interview skip. Share [the style gallery](https://animaguru.com/animation-styles#aurora-glass). Fold missing visual questions into the shared interview:
+
+- Which neighbouring hues fit the brand (violet, blue and teal; or orange, pink and red), on a dark or a light ground?
+- What do the cards hold (real product screens, a conversation, settings, a few numbers), and which single moment deserves the clear lens?
+
+## Build the look and movement
+
+Read `pixijs` and the relevant Graphics, Text, Container, Filters or Mesh skills. Read `animaguru` before generating assets; discover current models and estimates, respect the user's budget, and reuse completed media. Essential text, interface states and numbers belong in authored canvas content.
+
+- Aurora ground: three to five large solid shapes blurred 80–150 px, each drifting on its own slow closed path (a 20–40 s loop) and breathing a few percent in size over a deep base. Keep to two or three neighbouring hues; complementary colours turn muddy where they blend. Add a few thin light threads or specks so the glass has detail to soften.
+- Glass cards: the backdrop blurred 20–40 px inside a large-radius rounded shape, a 5–10 % white fill, a one-pixel inner edge at about 30 % white, a faint top sheen and a soft lifted shadow. Stack two or three cards at different depths: nearer cards drift further and blur whatever lies behind them, farther cards included.
+- Light: one key light travels slowly; each glass edge brightens where its normal faces it, so light slides along the edges as cards and light move.
+- Hero lens, at most one per film: a clear liquid-glass shape that magnifies its centre, bends hard at a bevelled rim with a slight colour split, and carries a specular edge toward the light. Let it glide over the content, then settle into a capsule or button that holds the title.
+- Pace: sine or near-linear easing, no overshoot and no bounce. Text and interface content enter only with opacity and about 8 px of rise, staggered; state changes crossfade. Receding layers lose opacity and fall out of focus rather than flying away.
+- Add 3–5 % noise or dither over the frame against gradient banding, and judge banding in the exported file at its delivery bitrate.
+
+Use the [production recipe](references/recipe.md) for the bundled original study and port-specific decisions. It is a technique example, not a prescribed film. Keep motions a function of absolute seconds; separate drawing cadence from camera/light cadence when the material calls for it. Prepare assets locally, preserve async seeking and register actual resource/cue times. Keep essential type editable and localized.
+
+## Review and delivery
+
+Inspect banding in the colour fields, edge highlights that stay one pixel and follow the light, card text that stays legible over the brightest field, blur that visibly softens what sits behind each card, and that nothing moves fast. Check representative full-resolution frames, moving playback, desktop/mobile fit and cold seeks. Follow `animaguru-video` for production records, audio mixing and HTML5 delivery; export MP4 when requested. Describe the actual 2D/2.5D rendering method accurately. Physically rendered 3D remains deferred.

package/skills/animaguru-aurora-glass/references/recipe.md

@@ -0,0 +1,27 @@
+# Aurora & Glass production recipe
+
+The workspace includes an executable original study in `src/studies/scenes.ts`, selected with `aurora-glass`. Its drawing commands are consumed by `src/studies/pixi-renderer.ts`; geometry and time sampling are shared with the gallery renderer. All copy lives in `shared/locales/en/style-studies.json`.
+
+In an untouched starter, run `npm run example -- aurora-glass`, then `npm run dev`. The command refuses to replace an authored film, retains starter backups in `production/example-backup/`, and writes an 8-second study with its own resource tracks. `npm run export:html` and `npm run export:mp4` use this installed film normally. To use the recipe inside an existing film, import `studyFrame()` and `StudyRenderer`, then compose the selected scene into the project's timeline instead of running the installer.
+
+## Assets and licences
+
+Draw the colour fields, glass and interface in code. When the cards should show real product screens, photographs or icons, use the user's own material or licence-clean sources (CC0, public domain, or a licence the user confirms), and record each in `production/CREDITS.md`. Use fonts the project may embed (OFL or licensed faces); a light, open sans suits the style. Never reproduce another company's interface or trademark unless the user owns it.
+
+## Adaptation decisions
+
+- Render the colour fields as large `Graphics` circles in one container behind a single `BlurFilter` (strength 80–150) at a reduced filter resolution, or as a small mesh-gradient fragment shader; the field holds no detail, so half resolution is invisible.
+- For each card, render the layers behind it into a `RenderTexture`, show the card's region of that texture through a `BlurFilter` (strength 20–40) masked by a rounded-rectangle `Graphics`, then add the white fill, the one-pixel inner stroke and a sheen gradient. Drive edge brightness from the angle between each edge's normal and the moving light, with a gradient stroke or a small shader.
+- Make the lens a small filter over the back texture: sample magnified toward its centre, displace along the rim normal with a slightly different offset per colour channel, and add the specular rim. Morph it into a capsule by animating its half sizes and corner radius together.
+- Overlay a fixed noise sprite or a noise filter at 3–5 % and export at a bitrate that keeps it, or banding returns in the MP4.
+
+The study is silent, original procedural art with an invented product; it demonstrates material, layout and motion rather than real product claims. Its stacked translucent ellipses and flat panes stand in for the blur and frosting described above. Configure an original subject, palette, scene sequence, duration and soundtrack from the brief.
+
+Use `src/studies/timing.ts` for deterministic easing, seeded variation, measured stroke truncation and cue helpers. `window.animaguru.texts` exposes visible study text bounds for `npm run review`; text declarations alone do not count as visual proof. Inspect the actual frames as well.
+
+## Sources and attribution
+
+Inspired by the following pinned references; source-specific 3D/media dependencies are not bundled. New study art and scene geometry are original. The workspace's `VIDEO-STYLE-NOTICES.txt` preserves the repository notices and clarifies third-party asset scope.
+
+- [prompts/12-aurora-glass.md](https://github.com/Vincentwei1021/mg-styles-15/blob/49052d80bfaf9fa8412cc9710530e5e95a3b8d8c/prompts/12-aurora-glass.md)
+- [demos/12-aurora-glass/main.js](https://github.com/Vincentwei1021/mg-styles-15/blob/49052d80bfaf9fa8412cc9710530e5e95a3b8d8c/demos/12-aurora-glass/main.js)

package/skills/animaguru-bauhaus-geometry/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: animaguru-bauhaus-geometry
+description: Build Bauhaus Geometry visuals and motion in an AnimaGuru PixiJS video workspace. Use when this visual style is chosen for an explainer, advertisement or general video.
+disable-model-invocation: true
+---
+
+# Bauhaus Geometry
+
+A kinetic poster in the Bauhaus and Swiss tradition: circles, triangles, quarter discs and bars in red, yellow, blue and black on cream paper move only along a strict modular grid, one exact action per beat, until the composition locks into a finished poster with its type. Order is the point: every move is a whole number of modules, every landing sits on a grid line, and nothing overshoots. Subject, audience, emotional tone and story come from the user's brief. This style supports Explainer, Advertisement and General Video.
+
+## Establish direction
+
+Follow sibling `animaguru-video` for purpose → style → compact interview before new production. Reuse explicit choices and completed briefs; honor a requested interview skip. Share [the style gallery](https://animaguru.com/animation-styles#bauhaus-geometry). Fold missing visual questions into the shared interview:
+
+- What sets the beat (a music track's tempo, or a reading pace), and which moment should land on the downbeat?
+- Which words carry the poster (a title, a three-word line, a date or place), and do brand colours replace the primaries or join them?
+- Should the finish read as flat screen graphics or as a printed sheet (paper, ink, registration marks)?
+
+## Build the look and movement
+
+Read `pixijs` and the relevant Graphics, Text, Container or Filters skills. Read `animaguru` before generating assets: generation can supply music or narration; the geometry and type are authored code, never a generated image. Discover current models and estimates, respect the user's budget, and reuse completed media.
+
+- The grid is the score. Pick one module and derive every position, size and distance from it (for example 80 px at 1280 × 720: a 14 × 8 field inside an 80/40 px margin, so the frame centre is a grid crossing). Moves are whole modules; sizes are whole or half modules; edges land on lines. Show the construction grid as a pale line, at least while the composition assembles.
+- Palette: red `#E03C31`, yellow `#F2B705`, blue `#1E4FA3`, ink black and cream paper `#F1E9DA`, or the brand's own limited set used the same way. Flat fills, no gradients on the shapes. One geometric sans for display (Futura-like), one condensed grotesque for small caps; set type horizontally or vertically on the grid.
+- One action per beat (0.5 s at 120 bpm): a slide, a swing, a sweep, a cut-in, a split. Ease with easeInOutQuad or linear over a fraction of the beat (about 0.3 s); never a spring, bounce or overshoot. Bars and rules may grow at constant speed. Cut-ins land exactly on the beat.
+- Alternate pivots and make each rotation a quarter or half turn so the shape lands on the grid: a shape's own centre, one of its vertices or corners (a triangle swinging about its right angle, a quarter disc sweeping about its corner like a clock hand), and the frame centre (a whole composition turning 180° maps the grid onto itself).
+- Drive arrays with phase offsets, like p5.js kinetic posters: a wave of quarter turns crosses a row of tiles column by column, each tile a fixed fraction of a beat after its neighbour, and the whole wave finishes inside its beat.
+- Build to a held poster: the composition assembles, has one big hero move (a turn or a cascade) at 60–75 % of the runtime, then the type cuts in and the frame holds with the grid stepping back. End on a cut or a mechanical camera pull-back, never a dissolve.
+- For a printed finish, lay the colours as separate ink layers on a paper texture: slightly ragged edges, a little density variation, a pixel of misregistration between layers, and registration marks in every layer so the offset shows. Keep small type crisp enough to read.
+
+Use the [production recipe](references/recipe.md) for the bundled original study and port-specific decisions. It is a technique example, not a prescribed film. Keep motions a function of absolute seconds so any frame can be sought cold. Prepare assets locally, preserve async seeking and register actual resource/cue times. Keep essential type editable and localized.
+
+## Review and delivery
+
+At full resolution, check every landing against the grid (positions and edges on module lines), every action against the cue sheet (one per beat, cut-ins on the beat), easing curves free of overshoot, the colour count, and type legibility and margins at the intended size. Step through the fastest moves frame by frame and seek into the middle of them cold. Follow `animaguru-video` for production records, audio mixing and HTML5 delivery; export MP4 when requested. Describe the actual 2D rendering method accurately. Physically rendered 3D remains deferred.

package/skills/animaguru-bauhaus-geometry/references/recipe.md

@@ -0,0 +1,30 @@
+# Bauhaus Geometry production recipe
+
+The workspace includes an executable original study in `src/studies/scenes.ts`, selected with `bauhaus-geometry`. Its drawing commands are consumed by `src/studies/pixi-renderer.ts`; geometry and time sampling are shared with the gallery renderer. All copy lives in `shared/locales/en/style-studies.json`.
+
+In an untouched starter, run `npm run example -- bauhaus-geometry`, then `npm run dev`. The command refuses to replace an authored film, retains starter backups in `production/example-backup/`, and writes an 8-second study with its own resource tracks. `npm run export:html` and `npm run export:mp4` use this installed film normally. To use the recipe inside an existing film, import `studyFrame()` and `StudyRenderer`, then compose the selected scene into the project's timeline instead of running the installer.
+
+## Assets
+
+The style needs no footage or generated imagery: shapes, grid and type are drawn in code. Use fonts licensed for commercial use and bundle them with the film (for example Jost or League Spartan for a Futura-like display face, Barlow Condensed or Oswald for small caps, all under the SIL Open Font License). A paper texture, if used, is procedural or CC0. Record each font and texture in `production/CREDITS.md`. Invent names and copy; do not imitate a real school's, museum's or brand's identity.
+
+## Adaptation decisions
+
+- Keep the grid as data: one module `M`, origin `(X0, Y0)` and `gx(c) = X0 + c * M`, `gy(r) = Y0 + r * M`. Store every element's resting position and size in modules and derive pixels from them, so a layout change never breaks alignment.
+- Draw each shape once as `Graphics` (circle, polygon, an `arc` for a quarter disc) inside a `Container` whose `pivot` is the action's pivot: the shape's centre, the vertex it swings about, or the frame centre for a whole-composition turn. Animate only `position` and `rotation` from absolute time; growing bars and rules are a width or a mask derived from time.
+- Schedule actions from a cue table in beats (`seconds = beat * 60 / bpm`) and ease with easeInOutQuad (`k < .5 ? 2k² : 1 - (2 - 2k)² / 2`) or linear. Avoid `spring()` from `timing.ts` here: its exponential settle reads organic rather than mechanical, and any initial velocity makes it overshoot.
+- For an array wave, start each tile at `beat + column * step + row * step / 2` and keep `step × columns + turn length` inside the beat, so the next cut-in lands on a still frame.
+- Printed finish: a paper `Sprite` from a procedural canvas texture under the shapes, each ink colour on its own `Container` offset by a pixel for misregistration, and a light grain overlay. A multiply-style blend keeps overprints honest where colours cross. Registration marks go in every ink layer so the offset is visible.
+- Vertical type is a `Text` rotated −90° about its baseline corner; set it to the grid like any shape. Load the fonts before the first frame so seeks never show fallback faces.
+- Reserve motion blur for genuinely fast moves (a 180° turn in one beat), using a few sub-steps or a directional blur filter; keep held frames sharp.
+
+The study is silent, original procedural art. It demonstrates the grid, the beat-locked actions, the pivot alternation and the phase-offset array, not a prescribed film. The gallery preview renders the same choreography as a printed poster: separate ink layers on a paper stock, off register by a pixel, finishing on a pull-back to the sheet on a wall. Configure the subject, palette, scene sequence, duration and soundtrack from the brief.
+
+Use `src/studies/timing.ts` for deterministic easing, seeded variation, measured stroke truncation and cue helpers. `window.animaguru.texts` exposes visible study text bounds for `npm run review`; text declarations alone do not count as visual proof. Inspect the actual frames as well.
+
+## Sources and attribution
+
+Inspired by the following pinned references; no source code, assets or audio are bundled. New study art and scene geometry are original. The workspace's `VIDEO-STYLE-NOTICES.txt` preserves the repository notices and clarifies third-party asset scope.
+
+- [prompts/09-bauhaus.md](https://github.com/Vincentwei1021/mg-styles-15/blob/49052d80bfaf9fa8412cc9710530e5e95a3b8d8c/prompts/09-bauhaus.md)
+- [demos/09-bauhaus/film.js](https://github.com/Vincentwei1021/mg-styles-15/blob/49052d80bfaf9fa8412cc9710530e5e95a3b8d8c/demos/09-bauhaus/film.js)

package/skills/animaguru-caption-news/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: animaguru-caption-news
+description: Build Caption News visuals and motion in an AnimaGuru PixiJS video workspace. Use when this visual style is chosen for an explainer, advertisement or general video.
+disable-model-invocation: true
+---
+
+# Caption News
+
+Social-video news that reads with the sound off: huge chunk-slammed captions are the lead actor over real footage, photos and documents, and every number arrives with the source tag that proves it. It is a documentary & broadcast style: real footage, photos, documents or data carry the film. Subject, audience, emotional tone and story come from the user's brief. This style supports Explainer, Advertisement and General Video.
+
+## Establish direction
+
+Follow sibling `animaguru-video` for purpose → style → compact interview before new production. Reuse explicit choices and completed briefs; honor a requested interview skip. Share [the style gallery](https://animaguru.com/animation-styles#caption-news). Fold missing visual questions into the shared interview:
+
+- Which footage, photos or documents do you have, and what is the one turn the hook sets up?
+- Which keyword gets the yellow block, and what should the lower third carry (place, date or speaker)?
+
+## Use real evidence
+
+Ask the user for their own footage, photos, documents or data first; otherwise find licence-clean sources (see the [production recipe](references/recipe.md)). Never stand a generated image in for the evidence, and never show a number without its source tag in the same shot. Keep `production/FACTS.md` (each on-screen or spoken claim, its source URL and quoted wording, or the measurement method) and `production/CREDITS.md` (every asset's source, author and licence), and deliver both with the film. CC BY-SA, "no known restrictions" or unclear licences are not CC0: name them to the user and ask before using them.
+
+## Build the look and movement
+
+Read `pixijs` and the relevant Graphics, Text, Container, Assets or Filters skills. Read `animaguru` before generating assets: generation can supply music or narration, never the evidence itself. Discover current models and estimates, respect the user's budget, and reuse completed media. Essential captions, numbers and charts belong in authored canvas content, never baked into footage.
+
+- The caption card is the shot: one Chinese line and one English line, chunk-slammed a piece at a time, one keyword per caption wiped into a honey-yellow block; never wrapped.
+- Numbers roll in fixed-width digit cells with their source tag in the same shot; a document highlight sweeps the exact line before its figure is restated as a block.
+- Cuts land on a half-beat grid; transitions are a small fixed set (hard cut, a short white flash, a card sliding in, a split, a lit grid, a mask growing out of a map shape) — never dissolves or page turns.
+
+Use the [production recipe](references/recipe.md) for sources, the bundled original study and port-specific decisions. It is a technique example, not a prescribed film. Keep motions a function of absolute seconds; separate drawing cadence from camera/light cadence when the material calls for it. Prepare assets locally, preserve async seeking and register actual resource/cue times. Keep essential type editable and localized.
+
+## Review and delivery
+
+Inspect reading time on every caption and chart title, source-tag presence beside every number, footage credits in the corner, keyword-wipe timing, and every figure against `FACTS.md`. Check representative full-resolution frames, moving playback, desktop/mobile fit and cold seeks. Follow `animaguru-video` for production records, audio mixing and HTML5 delivery; export MP4 when requested. Describe the actual 2D/2.5D rendering method accurately. Physically rendered 3D remains deferred.

package/skills/animaguru-caption-news/references/recipe.md

@@ -0,0 +1,26 @@
+# Caption News production recipe
+
+The workspace includes an executable original study in `src/studies/scenes.ts`, selected with `caption-news`. Its drawing commands are consumed by `src/studies/pixi-renderer.ts`; geometry and time sampling are shared with the gallery renderer. All copy lives in `shared/locales/en/style-studies.json`.
+
+In an untouched starter, run `npm run example -- caption-news`, then `npm run dev`. The command refuses to replace an authored film, retains starter backups in `production/example-backup/`, and writes an 8-second study with its own resource tracks. `npm run export:html` and `npm run export:mp4` use this installed film normally. To use the recipe inside an existing film, import `studyFrame()` and `StudyRenderer`, then compose the selected scene into the project's timeline instead of running the installer.
+
+## Evidence and sources
+
+Wikimedia Commons (read the licence on each file page: CC0, public domain or CC BY are fine; not CC BY-SA, "no known restrictions", unclear licences or YouTube re-uploads), U.S. federal agencies (USDA, USGS, NASA, NOAA, NARA — works of federal employees are public domain), Internet Archive (public domain or CC0/CC BY items only; U.S. works published before 1931 are public domain), Library of Congress (read each item's rights statement). Official documents and data (reports, statistics, filings) come from the agency's own site. Download into the film's `public/` or `production/` folders, log every request, and record each asset in `production/CREDITS.md` and each claim with its quoted wording in `production/FACTS.md`. Burn a readable footage credit into the frame where the medium calls for one.
+
+## Adaptation decisions
+
+- Build the caption card and the ledger (data-card) ground as `Text` and `Graphics` over a `Sprite` or video-texture footage layer; the keyword's yellow block is a masked rect wiped left to right behind the chunk.
+- Roll numbers in fixed-width digit cells (a monospace `Text` or `BitmapText` per digit, updated on the ticker) so a counter never jitters; keep its source tag in the same shot.
+- Sweep the document highlight as a `Graphics` rect in a multiply-like blend over the scanned page sprite, animated by an exact clip mask rather than opacity, so the sentence reads as marked, not merely tinted.
+
+The study is silent, original procedural art with illustrative values, labelled as such; it demonstrates material, layout and motion, not evidence. Replace its stand-ins with the real footage, photos, documents or data described above, never with generated imagery. The gallery preview uses procedural placeholder footage and documents, labelled illustrative, to demonstrate the caption, keyword-wipe and highlight system without claiming any real source. Configure the subject, palette, scene sequence, duration and soundtrack from the brief.
+
+Use `src/studies/timing.ts` for deterministic easing, seeded variation, measured stroke truncation and cue helpers. `window.animaguru.texts` exposes visible study text bounds for `npm run review`; text declarations alone do not count as visual proof. Inspect the actual frames as well.
+
+## Sources and attribution
+
+Inspired by the following pinned references; source-specific 3D/media dependencies are not bundled. New study art and scene geometry are original. The workspace's `VIDEO-STYLE-NOTICES.txt` preserves the repository notices and clarifies third-party asset scope.
+
+- [styles/caption-news/STYLE.md](https://github.com/lemomo-ai/lemo-opuscar/blob/77ee8318df779b0736d7de0abe24387e51023735/styles/caption-news/STYLE.md)
+- [styles/caption-news/demo/main.js](https://github.com/lemomo-ai/lemo-opuscar/blob/77ee8318df779b0736d7de0abe24387e51023735/styles/caption-news/demo/main.js)

package/skills/animaguru-city-symphony/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: animaguru-city-symphony
+description: Build Time-lapse Symphony visuals and motion in an AnimaGuru PixiJS video workspace. Use when this visual style is chosen for an explainer, advertisement or general video.
+disable-model-invocation: true
+---
+
+# Time-lapse Symphony
+
+A city film cut like a piece of minimalist music: time-lapse turns traffic, crowds and clouds into rivers of light, the cuts get denser with the score's subdivisions, one thing slows almost to a stop, and the film ends on a hard cut to black on a downbeat. It is a documentary & broadcast style: real time-lapse, aerial, archive or photographic footage carries the film. Subject, audience, emotional tone and story come from the user's brief. This style supports Explainer, Advertisement and General Video.
+
+## Establish direction
+
+Follow sibling `animaguru-video` for purpose → style → compact interview before new production. Reuse explicit choices and completed briefs; honor a requested interview skip. Share [the style gallery](https://animaguru.com/animation-styles#city-symphony). Fold missing visual questions into the shared interview:
+
+- Which place, and which licence-clean time-lapse, aerial or archive footage should carry the film, and what is its one slowed, fragile moment?
+- What is the score's tempo and arc (minimal repetition → acceleration → climax → hard stop → coda)?
+
+## Use real evidence
+
+Ask the user for their own time-lapses, photographs, documents or data of the place first; otherwise find licence-clean sources (see the [production recipe](references/recipe.md)). Footage only: never generate images, never use colourised or "restored" archive copies, never a YouTube mirror without a passed review. Keep `production/FACTS.md` (every number from an official source, with its URL and quoted wording) and `production/CREDITS.md` (every asset's source, author and licence), delivered with the film.
+
+## Build the look and movement
+
+Read `pixijs` and the relevant Filters, Container, Graphics or Text skills. Read `animaguru` before generating assets: generation can supply music or narration, never the city's own footage. Discover current models and estimates, respect the user's budget, and reuse completed media. Essential number cards and the closing quote belong in authored canvas content.
+
+- Density follows the score: the cut grid (bars, beats, subdivisions) comes from one tempo function, never a hand-typed duration; the grid split (1×2 up to 4×4) is this style's split screen.
+- Speed is the instrument: every sped-up shot reads as motion-blurred light, not stepped frames; one moment brakes into slow motion exactly where the music's arpeggios stop.
+- One 35mm release-print grade and matte unify every source, archive included; number cards and the closing quote stay left-aligned, never centred or boxed.
+
+Use the [production recipe](references/recipe.md) for sources, the bundled original study and port-specific decisions. It is a technique example, not a prescribed film. Keep motions a function of absolute seconds; separate drawing cadence from camera/light cadence when the material calls for it. Prepare assets locally, preserve async seeking and register actual resource/cue times. Keep essential type editable and localized.
+
+## Review and delivery
+
+Inspect cut-to-beat alignment, grade consistency across day and night shots, text reading time against `readcheck`-style limits, and every number against `FACTS.md`. Check representative full-resolution frames, moving playback, desktop/mobile fit and cold seeks. Follow `animaguru-video` for production records, audio mixing and HTML5 delivery; export MP4 when requested. Describe the actual 2D/2.5D rendering method accurately. Physically rendered 3D remains deferred.