Skip to content

v2.7.0 — Motion personality, GSAP reference, effects extraction

Choose a tag to compare

@staurus86 staurus86 released this 17 Aug 12:32
· 8 commits to master since this release

Five external skills reviewed (zanwei/design-dna, lottiefiles/motion-design-skill, AThevon/genjutsu, cloudai-x/threejs-skills, greensock/gsap), and only the gaps taken. None was adopted wholesale — their weaker conventions (raw hex, force-filled schemas, unpinned CDN versions) were deliberately left behind.

Added

  • references/gsap-patterns.md — the library's biggest coverage gap. GSAP previously existed only as scattered snippets in a blueprint and the parallax pattern. Now: tool-choice table with the bundle cost of each tier (CSS → motion/react → GSAP), useGSAP() scoping for React, timeline position parameter, stagger grid distribution, ScrollTrigger.batch, pin/scrub, containerAnimation for horizontal tracks, current SplitText.create() API (autoSplit, mask, aria), gsap.matchMedia() as the reduced-motion gate, and five failure modes that produce working-but-broken scroll animations. Licensing verified against the GreenSock repository at 3.15.0: the full plugin set, SplitText and MorphSVG included, is free for commercial use.

Extended

  • rules/05-animation.md — Motion Personality (4 archetypes mapping MOTION_INTENSITY to concrete duration / easing / overshoot values), the three motion layers (primary / secondary / ambient) as the diagnostic for flat-feeling builds, distance-scaled duration, exits at 65–75% of their entrance, the frequency rule, new R13 (no scale(0), third-of-screen travel limit, third-of-elements limit), and a symptom→cause troubleshooting table.
  • references/motion-systems.md — spring stiffness/damping table with the damping-ratio explanation, and a context-based overshoot budget (errors at 0%).
  • references/3d-animations.md — post-processing pass table with cost ratings (bloom, DOF, vignette, chromatic aberration, noise, SSAO) and the banding fix; custom-shader minimum (uniforms over state, lerped pointer, noise-type selection).
  • recipes/extract-design-from-reference.md — Step 2b, the effects layer: code-signal detection for live sites (<canvas>, three/pixi/ogl, GSAP/lenis, feTurbulence, cursor: none), per-effect record format with confidence marker, four cost tiers, mandatory fallback above css tier. Effects inventory added as the 4th artifact. The source skill's force-fill rule is explicitly rejected — an absent effect is absent, not an empty row.
  • templates/specs/design-system-master.md — Effect fallback and Fallback triggers in the motion budget.

Wired in

skills/global-design/SKILL.md (frontmatter 2.7.0, Task Routing row, domain enumeration), skills/global-design/task-routing.md (Effects table + knowledge lookup), CLAUDE.md, README.md (badge, references tree 27 → 28), agents/motion-designer.md (new Phase 6 — Personality and layers), checklists/wow-effects-checklist.md (+10 GSAP items), integrations/claude-code/CLAUDE.md (motion rules + 4 banned patterns).

Verified

73 tests pass · 0 broken links · no orphaned files · LF endings throughout.