What is the react-spring-physics skill?
React-spring-physics is a skill in freshtechbro's design skills repository on GitHub. It covers React Spring hooks, spring configuration presets, trails, list transitions, scroll and viewport animation, plus Popmotion utilities, so an AI coding agent writes interruptible, physics based motion instead of fixed duration tweens.
It is a skill from the claudedesignskills collection that pairs React Spring's declarative spring animations with Popmotion's low-level utilities. Springs run on mass, tension and friction instead of a set duration, so motion stays natural and can be interrupted by the user.
What changes in your agent's output
- Animations use useSpring, useSprings, useTrail, useTransition, useScroll and useInView from the react-spring web package.
- The agent picks a config preset such as gentle, wobbly, stiff, slow or molasses, or sets mass, tension and friction directly.
- The function form of useSpring with its api is used for click or gesture driven updates.
- Pitfalls are called out: missing dependency arrays, mutating spring values, ignoring velocity and animating non-numerical values.
- Reduced motion is handled by setting the skipAnimation global.
What is bundled with it
Beyond SKILL.md the folder lists two scripts, a spring generator and a physics calculator, three reference files on the React Spring API, Popmotion and physics tuning, and a React and Vite starter template with examples.
Who the skill is for
Best for
- React developers building drag, swipe, inertia and other gesture driven interfaces.
- Interfaces where an animation must change direction mid-motion and keep its velocity.
- Projects that already use React Spring or want a physics alternative to a duration based library.
Not for
- Precise timeline choreography, which the skill assigns to GSAP.
- Non-React projects, since the hooks are React specific.
- Declarative variant based animation, where the skill points to a Motion based alternative.
For timeline sequences use gsap-core, and for a declarative alternative see motion-framer. Check the cost of what you build with animation-performance.
How to install React Spring Physics Skill for UI Animation
git clone https://github.com/freshtechbro/claudedesignskills.gitThe repository README targets Claude Code first. Copying the folder into another agent's skills folder is the generic route.Clone the repository
Run
git clone https://github.com/freshtechbro/claudedesignskills.git. The skill is under plugins/individual/react-spring-physics/skills/react-spring-physics.Copy the skill folder
Copy that folder, with its scripts, references and assets, into your AI coding agent's skills folder.
Or use the Claude Code marketplace
The README lists /plugin marketplace add freshtechbro/claudedesignskills and says the animation-components bundle includes React Spring.
Add the library
In your React project install the react-spring web package so the code the agent writes will run.
Check that it loaded
Ask for a card that springs in with a gentle preset and a staggered list. The code should use useSpring or useTrail with a config preset and an animated element.
Key features
- Spring fundamentalsExplains animating from a current value to a target using mass, tension and friction.
- Two hook patternsShows the object form for simple cases and the function form that returns an api for imperative starts.
- Config presetsLists default, gentle, wobbly, stiff, slow and molasses with their tension and friction values.
- TrailsUses useTrail to stagger several elements with the same spring settings.
- List transitionsUses useTransition to animate items entering and leaving a list.
- Scroll and viewport springsCovers useScroll for progress based motion and useInView for animations when elements enter view.
- Three.js and PopmotionShows integration with React Three Fiber through the three package and with Popmotion for keyframes, decay and inertia.
- Performance tipsBatches many springs with useSprings and tunes precision to cut updates.
- Pitfall listDocuments six common mistakes with a wrong and right example for each.
Frequently asked questions
What is the react-spring-physics skill?
It is a skill in freshtechbro/claudedesignskills that teaches an AI coding agent spring based animation in React using React Spring and Popmotion. It covers hooks, presets, trails, transitions, scroll animation, three dimensional use and common pitfalls.
How do I install it?
Clone freshtechbro/claudedesignskills and copy the react-spring-physics skill folder into your agent's skills folder. In Claude Code the README also describes adding the repository as a plugin marketplace and installing the animation-components bundle.
How are springs different from duration animations?
Springs calculate motion from physical properties, mass, tension and friction, so they feel natural and can be interrupted while keeping velocity. Duration based tweens run a fixed time and usually restart from a set curve.
Does it work with React Three Fiber?
Yes. The SKILL.md lists an integration with React Three Fiber and the react-spring three package for animating 3D scenes, and says to use it alongside a separate react-three-fiber skill for scene management.
How does it handle reduced motion?
It shows assigning skipAnimation to React Spring's Globals so animations are skipped when a user prefers reduced motion. That is the pattern in its performance section, and you wire it to the preference yourself.
When should I pick GSAP instead?
The skill says to use React Spring for natural motion that responds to input and GSAP for precise timeline choreography and complex multi-step sequences. See gsap-timeline for the timeline side.
Is it only for Claude Code?
The repository README is written for Claude Code and its marketplace. The skill itself is a SKILL.md folder, so another agent that reads skill folders can load it by copying it, but the repository does not document that.


