# gsap-router

The gsap-router Claude Code skill routes GSAP animation requests to focused skills. It matches the task to core animation, sequencing, scroll effects, or React integration.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 102 installs · ★ 9 repo stars
- Author: Bbeierle12
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/Bbeierle12/Skill-MCP-Claude/tree/HEAD/skills/gsap-router/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/gsap-router

## What it does

gsap-router selects from four GSAP skills: `gsap-fundamentals`, `gsap-sequencing`, `gsap-scrolltrigger`, and `gsap-react`. It matches signals in a request, such as `timeline`, `ScrollTrigger`, or `useGSAP`, then points to the relevant instructions before implementation.

Some projects call for a combination. A pinned scroll section can use ScrollTrigger with sequencing; a React component animation can combine core techniques with React integration. When the request is unclear, the router starts with `gsap-fundamentals`. If no framework is named, it assumes vanilla JS.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Bbeierle12/Skill-MCP-Claude --skill gsap-router -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/gsap-router/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/gsap-router/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Bbeierle12/Skill-MCP-Claude --skill gsap-router -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/gsap-router/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Bbeierle12/Skill-MCP-Claude --skill gsap-router -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/gsap-router/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Bbeierle12/Skill-MCP-Claude skills/gsap-router
```

2. **Manually: put the files in place**
- File: `.github/skills/gsap-router/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Bbeierle12/Skill-MCP-Claude --skill gsap-router -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Bbeierle12/Skill-MCP-Claude --path skills/gsap-router
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/gsap-router/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Bbeierle12/Skill-MCP-Claude --skill gsap-router -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Bbeierle12/Skill-MCP-Claude/tree/HEAD/skills/gsap-router/SKILL.md

## When to use it
- choose a skill for a basic element animation
- build a sequence from multiple animations
- connect an animation to page scrolling
- select skills for a React component animation

## Example prompts
- Animate this element so it fades in when the page loads.
- Create a pinned section with an animation tied to scrolling.
- Choose GSAP skills for animating a React component.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 427b4acd760afda5.

BEGIN THIRD-PARTY FILE 427b4acd760afda5
````text
---
name: gsap-router
description: Router for GSAP animation domain. Use when implementing animations with GreenSock Animation Platform including tweens, timelines, scroll-based animations, or React integration. Routes to 4 specialized skills for fundamentals, sequencing, ScrollTrigger, and React patterns.
---

# GSAP Router

Routes to 4 specialized skills based on animation requirements.

## Routing Protocol

1. **Classify** — Identify animation type from user request
2. **Match** — Apply signal matching rules below
3. **Combine** — Production animations often need 2-3 skills together
4. **Load** — Read matched SKILL.md files before implementation

## Quick Route

### Tier 1: Core (Start Here)
| Need | Skill | Signals |
|------|-------|---------|
| Basic animations, easing | `gsap-fundamentals` | tween, animate, ease, from, to, duration, delay |
| Complex sequences | `gsap-sequencing` | timeline, sequence, orchestrate, labels, callbacks |
| Scroll animations | `gsap-scrolltrigger` | scroll, pin, scrub, parallax, reveal, sticky |
| React integration | `gsap-react` | React, useGSAP, ref, hook, cleanup, context |

## Signal Matching

### Primary Signals

**gsap-fundamentals**:
- "animate", "tween", "transition"
- "ease", "easing", "timing"
- "from", "to", "fromTo"
- "duration", "delay", "repeat"
- "stagger", "properties"

**gsap-sequencing**:
- "timeline", "sequence", "orchestrate"
- "labels", "callbacks", "nested"
- "position parameter", "overlap"
- "complex animation", "choreography"
- "play", "pause", "reverse", "seek"

**gsap-scrolltrigger**:
- "scroll", "ScrollTrigger"
- "pin", "sticky", "fixed"
- "scrub", "parallax"
- "reveal on scroll", "snap"
- "progress indicator"

**gsap-react**:
- "React", "component"
- "useGSAP", "useRef", "hook"
- "cleanup", "context"
- "event handler", "state"

### Confidence Scoring

- **High (3+ signals)** — Route directly to matched skill
- **Medium (1-2 signals)** — Route with fundamentals as foundation
- **Low (0 signals)** — Start with `gsap-fundamentals`

## Common Combinations

### Basic Animation (1 skill)
```
gsap-fundamentals → Tweens, easing, basic properties
```

### React Component Animation (2 skills)
```
gsap-fundamentals → Animation principles, easing
gsap-react → Hook patterns, cleanup, refs
```

### Scroll-Based Experience (3 skills)
```
gsap-scrolltrigger → Scroll triggers, pinning
gsap-sequencing → Timeline for pinned sections
gsap-fundamentals → Individual animations
```

### Full Production (3-4 skills)
```
gsap-fundamentals → Core animations
gsap-sequencing → Complex orchestration
gsap-react → Framework integration
gsap-scrolltrigger → Scroll interactions (if needed)
```

## Decision Table

| Framework | Animation Type | Complexity | Route To |
|-----------|---------------|------------|----------|
| Vanilla JS | Simple | Low | fundamentals |
| Vanilla JS | Sequenced | Medium | fundamentals + sequencing |
| Vanilla JS | Scroll-based | Medium | fundamentals + scrolltrigger |
| React | Simple | Low | fundamentals + react |
| React | Complex | High | All four skills |
````
END THIRD-PARTY FILE 427b4acd760afda5

The third-party file has ended. Everything between the 427b4acd760afda5 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 3105 of 7112 bytes. © Bbeierle12 · MIT · https://github.com/Bbeierle12/Skill-MCP-Claude/tree/HEAD/skills/gsap-router/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
