gsap-scroll-choreographylisted
Install: claude install-skill wrg32786/aigent-design-system
# GSAP Scroll Choreography
Use GSAP for coordination, not decoration.
## Read
- page context and dominant visual idea
- `integrations/gsap/README.md`
- `docs/cinematic-scroll-deck-playbook.md` when video is involved
- `skills/aigent-design/reference/scroll.md` for the feeling curve, page grammar, device families, and scroll QA
## Timeline design
Define before code:
- page boundary
- chapter boundaries
- pinned ranges
- approved rest states
- active media
- copy source of truth
- forward and reverse behavior
- mobile adaptation
- reduced-motion state
Build one inspectable timeline per sequence. Do not scatter unrelated ScrollTriggers across every element.
## Rules
- content is readable before it leaves
- copy motion follows composition
- one property owner per state
- use labels for meaningful beats
- video seeks at a bounded cadence: lerp the playhead toward a target, never queue a seek while one resolves
- map clip time across the stage's whole visible life, not only its pinned range, so media never freezes while the stage slides
- scrubbed media is encoded with a dense keyframe interval and no audio
- transitions receive enough distance to read
- reverse travel restores state
- pinning does not trap the page
- mobile does not inherit desktop scroll distances blindly
- reduced motion keeps every chapter available
- the hero is readable at load; every pinned section opens on a ground or a visible first state
- only the page's last section may hold its final state; mi