BjornMelin/dev-skills / plugins/web-motion/skills/gsap-timeline
gsap-timeline
VerifiedOfficial GSAP skill for timelines — gsap.timeline(), position parameter, nesting, playback. Use when sequencing animations, choreographing keyframes, or when the user asks about animation sequencing, timelines, or animation order (in GSAP or when recommending a library that supports timelines).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.3 KB |
| agents/openai.yaml | config | 300 B |
| assets/examples/gsap-timeline-starter.js | script | 271 B |
| assets/templates/gsap-timeline-audit-report.md | markdown | 633 B |
| assets/templates/gsap-timeline-review-checklist.md | markdown | 1.3 KB |
| evals/evals.json | config | 3.9 KB |
| evals/trigger-queries.json | config | 4.1 KB |
| references/docs-timeline-current-notes.md | markdown | 4.7 KB |
| references/index.md | markdown | 547 B |
| references/official-source.md | markdown | 1.4 KB |
| references/playback-control.md | markdown | 1.4 KB |
| references/position-parameter.md | markdown | 1.4 KB |
| references/provenance.json | config | 1.9 KB |
| references/sequence-design-taxonomy.md | markdown | 2.2 KB |
| references/source-ledger.md | markdown | 1.6 KB |
| references/timeline-state-machine-patterns.md | markdown | 2.2 KB |
| scripts/audit.mjsexecutable | script | 20.5 KB |
references/sequence-design-taxonomy.md
View on GitHub# Timeline sequence design taxonomy
Skill: gsap-timeline
Checked at: 2026-06-04
## When To Load
- Read before converting delay chains, staggered entrances, or product choreography into timelines.
## Source Anchors
- https://gsap.com/docs/v3/GSAP/Timeline/
- https://gsap.com/docs/v3/GSAP/gsap.to()
## Reference Notes
- Model the sequence as named phases, labels, and relative positions. Labels document product intent and make later edits safer.
- Use timeline defaults for repeated duration/ease values and explicit child vars only when they differ.
- A timeline should own order; individual child tweens should not smuggle independent delays that make the sequence hard to reason about.
## Focused Checks
- Inspect whether labels map to meaningful UI phases.
- Verify replay, reverse, seek, pause, and interruption semantics if exposed to users.
## Failure Modes
- Constructor `duration` used as if it controlled every child tween.
- Long delay chains instead of position parameters.
## Operating Guidance
GSAP timelines, sequencing, position parameter, labels, nesting, playback controls, defaults, and timeline review.
### Decision Boundaries
- Use gsap-core for one-off tweens.
- Use gsap-scrolltrigger when scroll owns the playhead.
- Use CSS keyframes only for simple fixed loops.
### Workflow Details
1. Model the sequence as labels, relative positions, and defaults.
2. Use position parameters instead of delay chains.
3. Store timeline handles when playback control or cleanup is needed.
4. Verify interruptions and reverse/restart behavior.
### Gotchas
- Timeline constructor duration is not child tween duration.
- Nested ScrollTriggers are usually wrong; attach scroll control to the top-level tween/timeline.
- Labels are a maintainability tool, not just comments.
## Validation Notes
- Inspect installed package versions and local architecture before applying examples.
- Prefer the bundled `scripts/audit.mjs doctor --root <repo> --format json` command when setup is unclear.
- Use `scripts/audit.mjs scan --root <repo> --format markdown` for repeatable static findings, then manually verify every finding against current code.
- Close with repo-specific checks and user-visible runtime proof when this skill affects a rendered surface.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |