@docyrus/animaguru 0.16.1 → 0.17.0

package/skills/animaguru-art-motion/references/art-styles.md

@@ -0,0 +1,44 @@
+# Art styles
+
+Choose the material and rendering language independently from the film’s story. Read only the selected card. Names referring to artists or studios identify influences; create original subjects and use the user’s identity and palette where appropriate. The cards preserve mechanisms and source limitations rather than promise exact imitation.
+
+| Treatment | Useful material or movement |
+|---|---|
+| [Cave painting](art/cave-painting.md) | Pigment, charcoal and animal silhouettes on a relief rock surface. Useful for origins, memory and prehistoric worlds. |
+| [Egyptian wall painting](art/egyptian-wall-painting.md) | Registers, profile silhouettes, mineral pigment and deliberate symbolic movement. |
+| [Greek black-figure pottery](art/greek-vase-painting.md) | Terracotta, black silhouettes and incised internal detail, suited to friezes and mythic sequences. |
+| [Roman mosaic](art/roman-mosaic.md) | Contour-following tesserae, stone variation and grout. Useful for architectural or historical art worlds. |
+| [Gothic illuminated manuscript](art/gothic-illumination.md) | Vellum, embossed gold leaf, stained glass, ornamental borders and restrained marginal humor. |
+| [Renaissance sfumato](art/renaissance-sfumato.md) | Soft edges, modeled volume, aerial perspective and glazed oil texture. |
+| [Impressionist dabs](art/impressionist-dabs.md) | Broken light and short varied marks, distinct from uniform pointillist dots. |
+| [Post-impressionist flow strokes](art/post-impressionist-flow.md) | Directional impasto and expressive color fields, including a Van Gogh-inspired treatment. |
+| [Art Nouveau](art/art-nouveau.md) | Organic whiplash curves, ornamental halos and integrated botanical decoration. |
+| [Cubist facets](art/cubist-facets.md) | Multiple viewpoints, angular silhouettes and overlapping planes. |
+| [Bauhaus geometry](art/bauhaus-geometry.md) | Primary-color geometry, balanced spatial systems and articulated mechanical movement. |
+| [Pop-art print](art/pop-print.md) | Ben-Day dots, heavy ink contours, flat color and bold comic emphasis. |
+| [8-bit pixel art](art/pixel-art.md) | Low-resolution silhouettes, limited colors and discrete sprite acting. |
+| [Early CGI and ray-traced plastic](art/early-cgi.md) | Glossy primitives, chrome, checkerboard reflections and conspicuously synthetic surfaces. |
+| [Contemporary textured flat illustration](art/contemporary-flat.md) | Clean silhouettes, regional stipple and expressive timing. |
+| [Ink wash and dry brush](art/ink-wash.md) | Paper, expressive ink, bleed and meaningful unpainted space. |
+| [Decorative gold and geometric ornament](art/klimt-gold.md) | Gold leaf, spirals, patterned robes and selective naturalistic features. |
+| [Expressionist waves](art/expressionist-waves.md) | Long translucent currents, pressure in the sky and controlled whole-scene distortion. |
+| [Dunhuang-inspired mineral mural](art/dunhuang-mural.md) | Mineral pigment, iron-wire contour, flying ribbons and aged plaster. |
+| [Polka dots and infinity space](art/polka-dot-infinity.md) | Hand-irregular dot fields, repeating depth and ribbed organic forms. |
+| [Constructivist poster collage](art/constructivist-poster.md) | Cream paper, red wedges, black geometry, photomontage and forceful type. |
+| [Surrealist soft forms](art/surrealist-soft-forms.md) | Hard light, long shadows and soft objects that violate their expected rigidity. |
+| [Quiet realism and hard sunlight](art/hopper-hard-light.md) | Architectural stillness, warm sunlight and sharply bounded cool shadow. |
+| [Watercolor background with cel characters](art/watercolor-cel-world.md) | Layered watercolor environments, warm linework and observed natural motion. |
+| [Vaporwave and VHS neon](art/vaporwave-vhs.md) | Deliberate retro neon, perspective grids, banded sunset and analog-video distortion. |
+| [Cosmic four-color comic](art/cosmic-comic.md) | Offset color plates, spotted blacks, feathered hatching, energy and exaggerated perspective. |
+| [Water-garden impressionism](art/monet-water-garden.md) | Water reflections, lilies, willow shadows and color-built light. |
+| [Pointillist optical mixing](art/seurat-pointillism.md) | Equal-size discrete pigment dots whose juxtaposition forms color. |
+| [Gouache cut paper](art/matisse-cut-paper.md) | Scissor edges, saturated sheets, pinned shadows and organic cut shapes. |
+| [Radiant line figures](art/radiant-line-figures.md) | Bold equal-weight contours, flat colors, dancing silhouettes and radiating action marks. |
+| [Chiaroscuro and impasto light](art/rembrandt-chiaroscuro.md) | Figures emerge from warm darkness through selective window and candle illumination. |
+| [Rubber-hose cartoon](art/rubber-hose.md) | Pie-cut eyes, noodle limbs, white gloves, contact squash and old-film cadence. |
+| [Chinese shadow-puppet theatre](art/shadow-puppet.md) | Translucent carved leather, riveted joints, visible rods and warm cloth backlight. |
+| [Cinematic anime light](art/cinematic-anime-light.md) | Detailed environments, luminous summer skies, hard cel shadows and selective optical light. |
+| [Blue-period painting](art/blue-period.md) | A restrained blue monochrome, elongated figures, broad dry strokes and slow emotional pacing. |
+| [Flat outline television cartoon](art/flat-outline-cartoon.md) | A Rick-and-Morty-inspired drawing treatment using original characters and semantic parts. |
+
+There are 36 cards. The source numbering omits 07 and uses 37 for its 36th style. The 35 original art demonstrations use Canvas; the latest flat-outline cartoon example uses SVG. This skill does not bundle either engine. For film sequencing, choose an [explainer grammar](explainer-grammars.md), then use [production](production.md) and [rendering](rendering.md).

package/skills/animaguru-art-motion/references/coverage.json

@@ -0,0 +1,190 @@
+{
+  "repository": "https://github.com/alchaincyf/huashu-art-motion",
+  "commit": "2571ee0a9a0467c4d99e935ea9e0fadda19210b0",
+  "license": "MIT",
+  "adaptationLanguage": "en",
+  "artStyles": [
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/01_cave.md",
+      "reference": "references/art/cave-painting.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/02_egypt.md",
+      "reference": "references/art/egyptian-wall-painting.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/03_greek.md",
+      "reference": "references/art/greek-vase-painting.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/04_roman.md",
+      "reference": "references/art/roman-mosaic.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/05_gothic.md",
+      "reference": "references/art/gothic-illumination.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/06_renaissance.md",
+      "reference": "references/art/renaissance-sfumato.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/08_impressionism.md",
+      "reference": "references/art/impressionist-dabs.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/09_postimp.md",
+      "reference": "references/art/post-impressionist-flow.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/10_nouveau.md",
+      "reference": "references/art/art-nouveau.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/11_cubism.md",
+      "reference": "references/art/cubist-facets.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/12_bauhaus.md",
+      "reference": "references/art/bauhaus-geometry.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/13_pop.md",
+      "reference": "references/art/pop-print.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/14_8bit.md",
+      "reference": "references/art/pixel-art.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/15_raytrace.md",
+      "reference": "references/art/early-cgi.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/16_2026.md",
+      "reference": "references/art/contemporary-flat.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/17_ink.md",
+      "reference": "references/art/ink-wash.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/18_klimt.md",
+      "reference": "references/art/klimt-gold.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/19_munch.md",
+      "reference": "references/art/expressionist-waves.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/20_dunhuang.md",
+      "reference": "references/art/dunhuang-mural.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/21_kusama.md",
+      "reference": "references/art/polka-dot-infinity.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/22_constructivism.md",
+      "reference": "references/art/constructivist-poster.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/23_dali.md",
+      "reference": "references/art/surrealist-soft-forms.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/24_hopper.md",
+      "reference": "references/art/hopper-hard-light.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/25_ghibli.md",
+      "reference": "references/art/watercolor-cel-world.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/26_vaporwave.md",
+      "reference": "references/art/vaporwave-vhs.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/27_kirby.md",
+      "reference": "references/art/cosmic-comic.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/28_monet.md",
+      "reference": "references/art/monet-water-garden.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/29_seurat.md",
+      "reference": "references/art/seurat-pointillism.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/30_matisse.md",
+      "reference": "references/art/matisse-cut-paper.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/31_haring.md",
+      "reference": "references/art/radiant-line-figures.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/32_rembrandt.md",
+      "reference": "references/art/rembrandt-chiaroscuro.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/33_rubberhose.md",
+      "reference": "references/art/rubber-hose.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/34_shadowpuppet.md",
+      "reference": "references/art/shadow-puppet.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/35_shinkai.md",
+      "reference": "references/art/cinematic-anime-light.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/36_picasso_blue.md",
+      "reference": "references/art/blue-period.md"
+    },
+    {
+      "source": "references/\u98ce\u683c\u914d\u65b9/37_rick_morty.md",
+      "reference": "references/art/flat-outline-cartoon.md"
+    }
+  ],
+  "explainerGrammars": [
+    {
+      "source": "references/\u52a8\u753b\u8bed\u6cd5/t1_3b1b.md",
+      "reference": "references/explainers/concept-morph.md"
+    },
+    {
+      "source": "references/\u52a8\u753b\u8bed\u6cd5/t2_keynote_ui.md",
+      "reference": "references/explainers/product-interface.md"
+    },
+    {
+      "source": "references/\u52a8\u753b\u8bed\u6cd5/t3_finance_chart.md",
+      "reference": "references/explainers/honest-data-chart.md"
+    },
+    {
+      "source": "references/\u52a8\u753b\u8bed\u6cd5/y1_kurzgesagt.md",
+      "reference": "references/explainers/luminous-science.md"
+    },
+    {
+      "source": "references/\u52a8\u753b\u8bed\u6cd5/y2_vox.md",
+      "reference": "references/explainers/editorial-evidence.md"
+    },
+    {
+      "source": "references/\u52a8\u753b\u8bed\u6cd5/y3_whiteboard.md",
+      "reference": "references/explainers/whiteboard-reasoning.md"
+    },
+    {
+      "source": "references/\u52a8\u753b\u8bed\u6cd5/y4_storytime.md",
+      "reference": "references/explainers/storytime-acting.md"
+    },
+    {
+      "source": "references/\u52a8\u753b\u8bed\u6cd5/y5_kinetic_type.md",
+      "reference": "references/explainers/kinetic-type.md"
+    },
+    {
+      "source": "references/\u52a8\u753b\u8bed\u6cd5/y6_presenter_explainer.md",
+      "reference": "references/explainers/presenter-explainer.md"
+    }
+  ]
+}

package/skills/animaguru-art-motion/references/explainer-grammars.md

@@ -0,0 +1,17 @@
+# Explainer grammars
+
+Choose the visual operation that explains the passage. A film can use several grammars when the explanatory job changes, keeping palette, type, audio and continuity coherent. Read only the selected cards.
+
+| Grammar | Explanatory job |
+|---|---|
+| [Concept morph](explainers/concept-morph.md) | Show how one object or representation becomes another. |
+| [Product/interface](explainers/product-interface.md) | Make a real product detail, feature or specification readable. |
+| [Data/chart](explainers/honest-data-chart.md) | Compare reliable quantities, time and events. |
+| [Luminous science](explainers/luminous-science.md) | Give an abstract system a concrete metaphor and travel across scale. |
+| [Editorial evidence](explainers/editorial-evidence.md) | Inspect authentic quotations, documents, photos and maps. |
+| [Whiteboard reasoning](explainers/whiteboard-reasoning.md) | Accumulate an argument as a connected spatial diagram. |
+| [Storytime acting](explainers/storytime-acting.md) | Support a personal story through poses, reactions and silence. |
+| [Kinetic type](explainers/kinetic-type.md) | Land a short phrase, list structure, chapter or number. |
+| [Presenter explainer](explainers/presenter-explainer.md) | Let an original presenter connect evidence, diagrams and reactions. |
+
+All nine source grammars have English adaptations. The source includes eight parameterized examples; presenter-led explanation is guidance with a reference film, not a ninth ready-to-run template. No source engine API is assumed to exist in AnimaGuru.

package/skills/animaguru-art-motion/references/explainers/concept-morph.md

@@ -0,0 +1,21 @@
+# Concept morph and mathematical explanation
+
+Choose this when a concrete object can become another object: a grid becomes a vector, weights become a sum, or a curve changes under a transformation. Write “A becomes B” for each passage. Use another grammar for a quotation, anecdote or launch with no meaningful transform.
+
+## Visual structure
+
+Put the object on screen first, then the question or formula. A dark, often black, ground and thin saturated lines support clear semantic color. Example colors are blue #58C4DD, red #FC6255, yellow #FFFF00 and teal #5CD0B3. Keep a concept’s color consistent in the diagram, legend and equation. Computer Modern-like mathematical typography can sit alongside a compatible reading face. Glow is optional emphasis, not the defining feature.
+
+## Motion and timing
+
+Use the quintic smoothstep 6p^5−15p^4+10p^3 for transforms. A 1–3 second change followed by roughly one second of reading is a useful starting point. Match point count, winding and starting landmark when interpolating paths. Stagger related objects slightly, preserving the relation between them. Write/reveal strokes by measured length; use a passing signal only along a real connection. During a reading hold, objects and camera can genuinely stop.
+
+## Camera and transitions
+
+Prefer object continuity: the end state is the next explanation’s starting state. A camera move targets the next meaningful object, usually over about a second. Before a scale traversal, identify the target, then interpolate zoom logarithmically and redraw vectors at that scale. The portal must cover the screen before the composition switches. Match formula symbols by identity rather than crossfading two whole equations.
+
+## AnimaGuru adaptation and review
+
+Use the existing kit’s analytic easing, line reveals and scene containers; implement missing path resampling locally. Upstream DG/CAM/MO names are not installed APIs. Check mathematical meaning as well as geometry: an output neuron connects to the preceding hidden layer, not directly to image pixels unless the actual architecture says so. Maintain the same value through a diagram, number label and conclusion. Give the final result time to be read. Do not turn successive bullet reveals into a black-background slide deck.
+
+Adapted in English from [the upstream grammar](https://github.com/alchaincyf/huashu-art-motion/blob/2571ee0a9a0467c4d99e935ea9e0fadda19210b0/references/%E5%8A%A8%E7%94%BB%E8%AF%AD%E6%B3%95/t1_3b1b.md) under the [MIT license](../../LICENSE). Numerical timings are starting points from source studies, not universal rules or current AnimaGuru benchmarks. See [provenance](../sources.md).

package/skills/animaguru-art-motion/references/explainers/editorial-evidence.md

@@ -0,0 +1,21 @@
+# Editorial evidence collage
+
+Use when the viewer should inspect actual documents, photos, maps, dates or quotations. Place the argument in a coherent desk/wall world and guide attention through the evidence. For AnimaGuru’s established tactile brand treatment, also read the sibling animaguru-cutcraft skill when present; this card adds evidence-specific choreography.
+
+## Visual structure
+
+Let the material occupy most of the frame while it is being read; an expansive desk of tiny framed images weakens the evidence. Use static paper fibers, restrained shadows, original cutouts and a small annotation palette. Source study colors include paper #E4DCCF, ink #171716, red #B65255 / #93403C and muted highlighter yellow #DACF08. Use the client’s own identity. Exact quotations remain faithful to the source and are composed as real text or shown in an authentic capture.
+
+## Motion and timing
+
+Separate smooth camera time from stepped element time. Quantizing drawn lines, labels or cutouts to about 12 fps can suggest editorial handwork while the camera remains smooth. Photos may already be present on the cut; avoid making every item bounce or slide in. Source examples use red lines over .5–1 s, a hand-drawn open circle near 1 s and a highlighter following a spoken phrase over 1.5–3 s. Schedule by actual words and readability, not a fixed typing rate borrowed from Chinese text.
+
+## Camera and transitions
+
+Fit the camera to the exact evidence rectangle plus reading margin. Pan along a connecting line, push into the relevant sentence, pull out to reveal the full argument, or hard cut on a narrative boundary. One continuous world should keep one camera through connected shots. Tears are a possible paper effect but were not a defining transition in the source’s sampled Vox pieces. Keep paper still while it is being read.
+
+## AnimaGuru adaptation and review
+
+Store authentic evidence with URLs and dates; label generated illustrations as conceptual in production records. Use AnimaGuru for original art, not fabricated archives. Render important reading text above clips, pins and neighboring cards. Re-read all simultaneously visible text to catch accidental combined meanings. Perform an event once; pushing closer must not replay a completed acquisition or transaction. In portrait, crop to the relevant half-sentence and follow its word cue before revealing the next region. Check source fidelity, highlighter bounds, top-layer text and full-speed camera variety.
+
+Adapted in English from [the upstream grammar](https://github.com/alchaincyf/huashu-art-motion/blob/2571ee0a9a0467c4d99e935ea9e0fadda19210b0/references/%E5%8A%A8%E7%94%BB%E8%AF%AD%E6%B3%95/y2_vox.md) under the [MIT license](../../LICENSE). Numerical timings are starting points from source studies, not universal rules or current AnimaGuru benchmarks. See [provenance](../sources.md).

package/skills/animaguru-art-motion/references/explainers/honest-data-chart.md

@@ -0,0 +1,21 @@
+# Data and financial charts
+
+Use for reliable numbers, time, comparisons and inflection points. Write the chart’s one takeaway before constructing it. A single number may be clearer as type. Data authenticity and sourcing are separate from visual style.
+
+## Visual structure
+
+Establish the scale, reveal the data, then annotate the takeaway. Use one color for the protagonist and gray for context. A zero baseline and light horizontal grid can define a bar chart. Keep units, date range and a readable source on the image. Label fictional examples in every applicable shot. Match the surrounding film’s theme or place the chart on an object within its world; avoid an unexplained white report card in a dark film.
+
+## Motion and timing
+
+Bars grow from zero with labels tracking their tips. A line advances by x/time rather than arc length, preserving the meaning of steep changes. Trigger event annotations when the animated head reaches that event, using the inverse easing function if necessary. Stage complex changes across roughly one second per operation as a starting point. Time final values to their spoken cues and hold long enough to read, at least about .5 s in a short example. Use tabular numerals.
+
+## Camera and transitions
+
+Hold the camera while data grows. Move to a specific point when the narration names it. Morph only between equivalent representations of the same data, with stable identifiers and explicit scale changes. Changing revenue bars into a stock-price line would imply a false relation. A zoom into recent data should redraw the chart rather than magnify a screenshot.
+
+## AnimaGuru adaptation and review
+
+Store the source data and units in production records. Bars use zero baselines; a cropped line/candlestick axis needs clear disclosure and a fair scale. Distinguish “grew to 8.7 times” from “increased by 8.7 times”: the latter means a different final value. Recompute ratios from the actual labels and match endpoints across wide/detail charts. Red/green direction conventions vary by market; state them or use blue/orange with symbols. Check negative values, decimals, long labels and portrait safe areas. Avoid bounce, perspective columns and decorative 3D that distort quantity.
+
+Adapted in English from [the upstream grammar](https://github.com/alchaincyf/huashu-art-motion/blob/2571ee0a9a0467c4d99e935ea9e0fadda19210b0/references/%E5%8A%A8%E7%94%BB%E8%AF%AD%E6%B3%95/t3_finance_chart.md) under the [MIT license](../../LICENSE). Numerical timings are starting points from source studies, not universal rules or current AnimaGuru benchmarks. See [provenance](../sources.md).

package/skills/animaguru-art-motion/references/explainers/kinetic-type.md

@@ -0,0 +1,21 @@
+# Kinetic typography
+
+Use words as performers for an opening, list structure, quotation, key number or chapter transition. Long explanatory passages usually need images, evidence or diagrams between typographic sections. Design English copy by measured width and reading time; do not import Chinese character-count limits literally.
+
+## Visual structure
+
+One dominant word or short phrase, one supporting line and at most one supporting evidence object make a useful starting point. A roughly 3:1 main/support size ratio creates hierarchy. Use a chapter palette and an intentional alignment grid. Maintain margins and safe areas at the real aspect ratio. Vary page structures before the film starts feeling like repeated title slides.
+
+## Motion and timing
+
+Land the main phrase on a spoken stress or measured musical beat. A brief scale slam, around .35 s settling from roughly 1.7×, can establish emphasis. Supporting text can rise through a mask over .3–.35 s; a card can move in over .4 s. Reveal one focus at a time. An exit can be shorter than entry, around .18 s. Once readable, type stays fixed. Background motion or a tiny beat pulse is optional, with no need to make the whole film continuously drift.
+
+## Camera and transitions
+
+Expand a meaningful letter or colored shape into the next background, use a band wipe, or move across a continuous layout. Schedule the visible reveal on the accent, rather than scheduling only the transition’s first frame: transitionStart = accentTime − revealFraction × transitionDuration. For a .45 s transition revealing at .55, start about .2475 s before the accent. Check the actual rendered reveal; easing changes its perceived arrival.
+
+## AnimaGuru adaptation and review
+
+Use editable local type, font measurement, masks and the shared audio cue sheet. Keep a progress track in screen space so it does not move with a page. Essential wording should never depend on generated lettering. Review reading time after the last character finishes, final hold, the gap to an evidence card, glyph coverage and alignment between text impact and sound. For narration, prioritize the stressed word; for music, use the measured beat grid. Do not add an effect or sound to every small element if it competes with the spoken message.
+
+Adapted in English from [the upstream grammar](https://github.com/alchaincyf/huashu-art-motion/blob/2571ee0a9a0467c4d99e935ea9e0fadda19210b0/references/%E5%8A%A8%E7%94%BB%E8%AF%AD%E6%B3%95/y5_kinetic_type.md) under the [MIT license](../../LICENSE). Numerical timings are starting points from source studies, not universal rules or current AnimaGuru benchmarks. See [provenance](../sources.md).

package/skills/animaguru-art-motion/references/explainers/luminous-science.md

@@ -0,0 +1,21 @@
+# Luminous flat science worlds
+
+Choose a visual metaphor before drawing: what physical thing represents this abstract idea? Use this grammar for systems, processes and journeys across scale. Authentic archives or real events usually benefit more from editorial evidence.
+
+## Visual structure
+
+Use clear organic/geometric silhouettes, usually without dark outlines. Shade with a darker local hue and a small highlight shape. A dark ground with two or three contrasting saturated accents can support luminous signals; a lighter treatment is also possible. Choose a coherent era/palette rather than mixing visual systems. A glowing orange central planet is one source example, not a required subject. Plan foreground, subject, landscape and distant layers with meaningful depth.
+
+## Motion and timing
+
+Each explanatory passage should have a visible state change: a connection forms, a structure opens, an object divides or a level is revealed. Once settled, labels and subjects hold; stars, clouds or particles may continue quietly. Source references use approximately .83 s for a regular action, faster .17–.5 s for selected pops and a short stagger between related objects. These are study values, not quotas. Avoid making every object float to satisfy a motion metric.
+
+## Camera and transitions
+
+Identify and briefly highlight the target before entering it. Interpolate large scale changes in logarithmic space. Keep the world live and redraw vectors or use sufficient-resolution source assets: magnifying a 1920 px screenshot 60 times will blur. Match color, highlight direction and object position across a portal; pull back to reveal context. Scale travel can take around 1–2 s, while whole conceptual units often need several seconds of narration.
+
+## AnimaGuru adaptation and review
+
+Use original subjects and brand-appropriate colors; use generated transparent layers when character drawing is the bottleneck. Apply compatible shading/material to all subjects. Existing Pixi containers provide depth stacks; only implement parallax where it explains space. Review portal coverage, object identity, readable label holds, particle density and whether the visual actually explains the concept. Short upstream demos are compressed catalogs of techniques, not timing templates for a finished science film.
+
+Adapted in English from [the upstream grammar](https://github.com/alchaincyf/huashu-art-motion/blob/2571ee0a9a0467c4d99e935ea9e0fadda19210b0/references/%E5%8A%A8%E7%94%BB%E8%AF%AD%E6%B3%95/y1_kurzgesagt.md) under the [MIT license](../../LICENSE). Numerical timings are starting points from source studies, not universal rules or current AnimaGuru benchmarks. See [provenance](../sources.md).

package/skills/animaguru-art-motion/references/explainers/presenter-explainer.md

@@ -0,0 +1,21 @@
+# Presenter-led business explainer
+
+An original presenter connects paper, charts, key terms and emotional reactions. Use for business history, product mechanisms and knowledge explainers with a visible guide. This is the ninth upstream grammar; it has a reference film but no standalone parameterized snippet or supplied character sprites.
+
+## Visual structure
+
+Allocate varied layouts: a presenter beside evidence, a full-frame number, a left/right comparison, a character inside a chart and a reaction close-up. Avoid a whole film of person-left/chart-right. Prepare full-body and bust views. Sitting, leaning and walking require matching pose material rather than distorting a standing frame.
+
+## Motion and timing
+
+Use explicit position and scale at the first character keyframe of each segment, so state does not leak from the previous segment. Normalize apparent pose height using measured anchors. Switch different silhouettes directly with a slight motivated pop instead of crossfading a double figure. Stop mouths during pauses; use complete gait frames for walking. Numbers settle on the spoken value, then the emphasis circle appears. Do not attach “over” or “+” while a count is still passing through lower values.
+
+## Camera and transitions
+
+Page transitions may move the page while the presenter and year display continue across it. Derive year, subtitles, chapter title and graphics from one timeline. Prefer a live scene camera to enlarging a full-frame raster image; keep the presenter inside the actual viewport at every zoom.
+
+## AnimaGuru adaptation and review
+
+Create or import an authorized original presenter through AnimaGuru and save local frames with actual bounds and foot anchors. Reuse the player’s captions, audio cues and scene containers. Multiply nested opacity by the parent value rather than replacing it, preserving outer fades. Check text occlusion, subtitle-zone conflicts, character cropping, matching year labels and numerical qualifiers. The source card is a production recipe, not a complete reusable film or proof that arbitrary presenter performance is supported.
+
+Adapted in English from [the upstream grammar](https://github.com/alchaincyf/huashu-art-motion/blob/2571ee0a9a0467c4d99e935ea9e0fadda19210b0/references/%E5%8A%A8%E7%94%BB%E8%AF%AD%E6%B3%95/y6_presenter_explainer.md) under the [MIT license](../../LICENSE). Numerical timings are starting points from source studies, not universal rules or current AnimaGuru benchmarks. See [provenance](../sources.md).

package/skills/animaguru-art-motion/references/explainers/product-interface.md

@@ -0,0 +1,21 @@
+# Product and interface presentation
+
+Use for a real interface, feature launch, product name, price or specification. Let a screenshot, recording or product image carry the frame. For mechanism, evidence or time-series data, use the corresponding grammar instead.
+
+## Visual structure
+
+Show one product fact at a time. A screenshot can occupy about 80% of a landscape frame or 90% of a portrait frame, then the camera finds the relevant detail. Use the product’s brand palette. Near-black grounds, generous whitespace, tight large type and concentric corner radii are useful options. Light meshes, glass cards, gradient text and decorative floating are optional packaging; stacking all of them produces a generic launch template.
+
+## Motion and timing
+
+Start UI springs at critical damping or very low overshoot. Source duration/bounce examples use .5–.75 s and bounce 0–.15; stronger .3 bounce is an intentional choice. An optional text reveal removes 18–26 px blur while moving 16–40 px over .7–1 s. Count a quantity only once, use tabular digits, and time its final value to the spoken number. Compute the start by subtracting the animation duration from that cue. Let units fit their measured width.
+
+## Camera and transitions
+
+Hold while the screen is readable. Push toward a detail around .9 s, move to another region around .7 s, then return to context. Reserve a much faster push for a real reveal. A shared-element card can expand into a full view: place the incoming opaque image inside the card from the first transition frame so old and new text do not double. Pad blur/shrink transitions with overscan to prevent dark edges.
+
+## AnimaGuru adaptation and review
+
+Use actual local product captures and editable exact type; label conceptual UI in production records. Keep one coordinate system between full view and detail view. A numeric conclusion about the screen can overlay that same dimmed screen instead of cutting to an unrelated gradient background. Check glass against actual content, spring restraint, glyph coverage, screenshot legibility, final holds, and accidental repeats of the same three-card layout.
+
+Adapted in English from [the upstream grammar](https://github.com/alchaincyf/huashu-art-motion/blob/2571ee0a9a0467c4d99e935ea9e0fadda19210b0/references/%E5%8A%A8%E7%94%BB%E8%AF%AD%E6%B3%95/t2_keynote_ui.md) under the [MIT license](../../LICENSE). Numerical timings are starting points from source studies, not universal rules or current AnimaGuru benchmarks. See [provenance](../sources.md).

package/skills/animaguru-art-motion/references/explainers/storytime-acting.md

@@ -0,0 +1,21 @@
+# Storytime pose acting
+
+Use for a first-person experience, a recurring original narrator and a script with reaction beats. Voice carries the story; the animation supplies decisive poses, expressions and silence. Data-heavy or impersonal material may need another grammar.
+
+## Visual structure
+
+Keep a recognizable character with a small pose/expression library. Medium shots can leave space for the object being discussed; a reaction close-up removes background competition, while a sudden wide shot can communicate helplessness. Characters have stronger contours and contrast than simplified backgrounds. Do not copy the upstream author’s mascot or a creator’s identity. Generate consistent character sheets through AnimaGuru when detailed human acting is needed; intentional simple geometric figures are also valid when they fit the brief.
+
+## Motion and timing
+
+Change a pose quickly, around .1 s as a starting point, then truly hold. A small contact-anchored compression and short decaying settle can accent the switch. Choose a limited mouth system or proper visemes according to quality needs. Audio RMS can drive open/half/closed mouths at about 12 updates/s, but is not phoneme-accurate lip sync. Use deterministic blinks and gaze that point at the spoken subject. Stop talking during actual silence.
+
+## Camera and transitions
+
+Hard cuts dominate. Use a jump to a reaction close-up, an occasional glance-motivated whip, or an over-shoulder screen shot. Wide and close views must refer to the same room geometry. Put a reaction in a real gap in the narration—often .8–1.5 s is useful—rather than immediately speaking over the joke. Leave the final reaction long enough to land.
+
+## AnimaGuru adaptation and review
+
+Use actual sprite metadata and feet/hand anchors. Match silhouettes across poses and normalize apparent height without stretching anatomy. Do not dissolve unrelated poses into double bodies. A high static-frame percentage may be intentional; review the sharp pose changes and story beats instead of forcing everything to float. Check scene edges at maximum camera distance, matching subtitle cuts, prop contact, recognition from behind and actual audio/mouth timing.
+
+Adapted in English from [the upstream grammar](https://github.com/alchaincyf/huashu-art-motion/blob/2571ee0a9a0467c4d99e935ea9e0fadda19210b0/references/%E5%8A%A8%E7%94%BB%E8%AF%AD%E6%B3%95/y4_storytime.md) under the [MIT license](../../LICENSE). Numerical timings are starting points from source studies, not universal rules or current AnimaGuru benchmarks. See [provenance](../sources.md).

package/skills/animaguru-art-motion/references/explainers/whiteboard-reasoning.md

@@ -0,0 +1,21 @@
+# Whiteboard reasoning
+
+Choose a continuous argument map or a sequence of separate paper pages. A moving-camera RSA-like board and a fixed-camera page-cut explanation are different grammars; keep the chosen spatial model consistent.
+
+## Visual structure
+
+Plan the final diagram before the drawing order. Use a visual metaphor or relational sketch, not a transcript handwritten in full. An off-white board, near-black line and one accent color are enough. A line width near .6–.7% of frame height is a useful source starting point; make hatching lighter. Define solid/dashed/dotted semantics once. Existing marks persist until explicitly erased or left outside the viewport.
+
+## Motion and timing
+
+Measure each stroke by arc length, derive its duration from pen speed, and return the reveal frontier as the pen-tip position. If revealing a complex image by a zigzag mask, attach the pen to that same frontier. Do not reveal several unrelated lines at once under a stationary hand. Source drawing tends to follow the spoken phrase slightly, often about .5 s; adapt English handwriting speed and phrase length to the measured voice. Complex art can be pre-drawn and discovered rather than drawn in real time.
+
+## Camera and transitions
+
+Fit the current drawing bounds with margins. Small smooth board moves retain substantial overlap with the previous argument. Use a whip only for a purposeful move to a distant area. A final pullback reveals the overall argument map and holds. A page-based version uses cuts to new pages instead. Keep board marks and pen in world space; keep any paper/erase texture scaled appropriately for the viewport.
+
+## AnimaGuru adaptation and review
+
+Use kit line primitives and local analytic path timing; generated hand art is optional if a hand helps the brief. The hand exits when idle and must not cover the conclusion. Print planned stroke completion times to catch a drawing that continues after the camera leaves. Check pen/frontier alignment, no cropped old words at edges, clear line semantics, connected argument groups and a real final reading hold. Whiteboard rendering alone does not establish a claim of better learning outcomes.
+
+Adapted in English from [the upstream grammar](https://github.com/alchaincyf/huashu-art-motion/blob/2571ee0a9a0467c4d99e935ea9e0fadda19210b0/references/%E5%8A%A8%E7%94%BB%E8%AF%AD%E6%B3%95/y3_whiteboard.md) under the [MIT license](../../LICENSE). Numerical timings are starting points from source studies, not universal rules or current AnimaGuru benchmarks. See [provenance](../sources.md).

package/skills/animaguru-art-motion/references/production.md

@@ -0,0 +1,78 @@
+# Production and AnimaGuru generation
+
+Contents: brief and visual mechanism; reference analysis; four production routes; generation; narration and music; style journeys and long scrolls; production records.
+
+## Establish the visual mechanism
+
+Use the brief already supplied. For a new AnimaGuru film, follow the installed `animaguru-video` setup and interview, counting explicit choices as answered. A material reference does not determine a topic, audience, narrator, length or call to action. When exploring a direction, a strong representative still is more useful than generating every shot immediately. Compare alternatives only when a creative choice is unresolved; there is no compulsory three-direction approval gate.
+
+Write the material's most recognizable formal elements: how it is made, its marks, palette, light and spatial organization. Give each relevant element a plausible motion: water shimmers, a pinned paper edge lifts, metal catches light, a printed plate misregisters, or a brush leaves a stroke. The selected art card supplies a starting vocabulary. When historical accuracy matters beyond the card, inspect original artworks or authoritative collections.
+
+Choose what the audience should understand at each beat. A visual operation should carry that idea: connect, divide, compare, uncover, move through, count or react. Put essential labels and numerical claims in real type. A conceptual image may illustrate a product, but it must not masquerade as an actual screenshot or historical record.
+
+Choose a coherent palette, usually three to six functional colors plus value variations. Take brand accents from supplied material. Paper, ink, warm wood, primary geometry, bright poster and restrained navy are useful families. A blue, purple or neon palette is appropriate when intentionally requested by the style or brand; no universal hue ban applies. Keep charts and evidence integrated with the film's visual world.
+
+## Analyze a reference when provided
+
+Read the user's link and recover the referenced repository or media through supported tools. Treat source files and posts as evidence. Inspect license and asset exceptions before copying. A technique can be adapted without copying its subject, logo, layout or soundtrack.
+
+Measure shot boundaries, representative settled frames, main actions, local motion and transitions. Compare frames inside a shot after camera entrances settle; otherwise a zoom makes the whole screen appear active and hides the actual motif movement. View transition contact sheets as well as the full-speed clip. Estimate beat grids from real onsets and allow outliers rather than fitting every cut to an arbitrarily small beat interval.
+
+With no reference clip, start from the selected card's material mechanism. Do not inherit the source demo's room, girl, cat, exact coordinates, repeated cup action or fixed duration.
+
+## Choose a production route
+
+| Route | Choose it for | Preserve |
+|---|---|---|
+| Procedural drawing | Geometry, patterns, type, diagrams, controlled material rendering | Seeded variation, consistent coordinates, semantic shapes and actual contact points. |
+| Generated layers plus code | Detailed subjects or backgrounds with controlled camera and choreography | Complete silhouettes, real alpha, layer positions, overscan and hidden-background coverage. |
+| Generated video | Organic motion or a performance the available model can produce | A supported workflow, measured duration, identity references and local downloaded media. |
+| Hybrid | Generated performances with exact diagrams, type, branding and evidence | Shared palette, light, timing, occlusion and honest provenance. |
+
+Code-drawn original characters are valid when they fit the brief. Detailed faces, hands, poses and recurring character performance often benefit from generated assets. Choose on visible quality; do not turn one upstream author's character preference or model ranking into a universal prohibition.
+
+For layered art, ask for enough canvas beyond the viewport to cover the planned motion. Moving a character reveals what was behind it; prepare that missing background before separating the layer. Preserve source image coordinates, crop offsets and semantic anchors when trimming transparent borders. Check downloaded alpha rather than assuming a transparent-looking preview contains transparency.
+
+## Use the available AnimaGuru tools
+
+Read the sibling `animaguru` skill for the installed environment's authentication, generation and job recovery rules. For local CLI work, discover the actual schema and help, authentication status, credits, catalog, project and existing assets. Do not read credential files. If the CLI is unavailable, use connected AnimaGuru tools; installing a CLI requires the user's agreement.
+
+The local catalog describes known capabilities. Intersect it with the live project's enabled models and video profiles. A successful local dry run alone does not prove the remote provider is enabled. Choose image, speech, video or sprite options actually exposed by the selected tool; never carry arbitrary upstream provider names into requests.
+
+Save a concrete request, inspect its estimate, and reuse existing media before submitting. Account for all planned images, speech, music and motion within the user's scope and budget. A request to create a skill is not permission to spend generation credits. A film-generation request supports a proportionate initial attempt under the existing authorization; paid retries remain bounded by that scope. Do not purchase credits or change provider settings as an incidental production step.
+
+An art request can express the material independently of the subject:
+
+> Original [medium] illustration of [specific subject and action]. [Composition, layer depth, light direction and scale.] Use [palette], [edge/mark treatment] and [recognizable material process]. Maintain [recurring identity details]. Keep [area] quiet for separately composed type. No essential lettering, logos or watermark.
+
+For a transparent moving subject, request the tool's actual transparency option and a complete uncropped silhouette. For video, use saved project files as image/end-frame references only when that model supports them. An extracted local frame is not automatically a remote asset: use a supported import path. Do not assume extension, first/end-frame control, audio, seeds or a fixed clip duration exist for every model.
+
+Save job receipts immediately. After a timeout or uncertain response, inspect the original job and assets before another submission. On an explicit provider failure, diagnose it and use a compatible enabled alternative within the authorized budget. Record the returned charge/refund result without guessing. Download finished files into the film and measure them; output playback should not require signed remote URLs.
+
+## Narration, cues and music
+
+Use one final narration track and its actual timing as the spine for a narrated film. Reuse the workspace's audio tools rather than building a second editor. In a current starter, `audio:vo` writes `production/audio/timing.json`; `cueSheet(timing)` and `joinCaptions()` keep graphics and captions aligned. Read local help and the installed `animaguru-video` skill for the precise command options.
+
+Where word timing exists, identify an event by the word and occurrence, then resolve it to a frame during production. With caption-level timing, use that real cue plus a documented offset rather than claiming word precision. Re-resolve cues after voice edits. Numbers should finish counting on the spoken value, so compute the start from the desired finish. A reading hold begins after the final glyph or graphic is fully revealed.
+
+Speech-led evidence, charts and whiteboard passages follow the spoken phrase. A music-led art montage or kinetic opening follows measured beats. To align a transition, schedule its visible reveal or impact on the accent, not merely its start:
+
+`transition start = accent time − reveal fraction × transition duration`
+
+Use an actual beat analysis for supplied/generated music. A source demo's 128 BPM is not a default tempo for all films. Shorten scene durations to accelerate a montage instead of blindly speeding up the entire performance. Use a coherent musical motif with changes in instrumentation when appropriate. Duck music beneath the narrator and leave time for the final idea or reaction. A synthesized test sound or temporary voice is a placeholder until replaced or explicitly accepted.
+
+## Same-scene style journeys
+
+This format has five separable layers: invariant composition, material renderer, shared choreography, material-aware transitions and rhythmic structure. Reuse the same identity and action across style boundaries. Derive that shared performance from global time; restarting a cup lift in every style looks like several separate actions. Only a style-specific local event should use segment time.
+
+Give each art scene a main action and a small number of meaningful motif loops when an animated painting is the desired treatment. This is not a requirement for every explainer reading hold. Apply material treatment to characters as well as backgrounds, keeping facial landmarks legible. A signature transition can grow from the medium—gold, tiles, ink, paper or a reflection—without interrupting the continuous performance.
+
+## Long-scroll journeys
+
+Define a shared world contract: segment width, ground, subject height, travel speed, back/front layers, entry boundary and interaction anchors. Choose these dimensions for the new film. Style the subject at a world boundary without changing its ground contact or identity. Derive walk phase from distance traveled so speed changes do not make feet skate. Sitting, leaning and interaction poses require corresponding frames or a suitable rig.
+
+Time local events relative to interaction start rather than seconds since segment entry. This lets travel speed change without retiming every action. Use a monotonic camera for a deliberately forward-only scroll; do not impose it on other film formats. Hide seams with real foreground or material boundaries. If music is composed after fixed visual boundaries, modest per-section tempo adjustments can align changes to bars; preserve natural phrasing and inspect the transitions by ear.
+
+## Production records
+
+Follow existing `production/` conventions: brief, sources, storyboard, generation requests/receipts, cue data and review evidence. Save actual resource paths and model identifiers. Keep all output media local, and retain original evidence alongside any crop. Do not add private project facts or unverified successes to the reusable skill. Generalize a lesson only when the observed cause supports it.