Repository navigation
v2.7.0 — Motion personality, GSAP reference, effects extraction
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,staggergrid distribution,ScrollTrigger.batch, pin/scrub,containerAnimationfor horizontal tracks, currentSplitText.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 mappingMOTION_INTENSITYto 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 (noscale(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 abovecsstier. 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 fallbackandFallback triggersin 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.