What is the motion-ref skill?
Motion Ref is an agent skill by joepUI with 119 UI motion effects in 13 categories. You describe a product scenario, such as a slow load or a silent button, and the skill routes to the right category file, then gives an implementation with timing, easing guidance and reduced-motion handling.
Motion Ref is a UI motion reference packaged as an agent skill. The README says it holds 119 production-ready effects across 13 categories, and that you do not need motion design knowledge because you describe your product scenario.
The SKILL.md is written in Chinese, with trigger phrases for requests such as a page with no animation or an interaction with no feedback. It translates a product problem into a fitting effect, then loads only the relevant reference files.
What changes in your agent's output
- The agent asks what problem the user has before it picks an effect, then recommends one to three animations.
- It reads a scene routing file and only the category files it needs, not the whole reference set.
- Ordinary interactions stay between 200 and 500 milliseconds, and similar interactions share one duration and easing.
- Every code answer includes prefers-reduced-motion handling.
- Parameters come from the reference files instead of being invented from memory.
Who it is for
Best for
- Developers who know the problem, such as a white flash on load, but not the animation vocabulary.
- Product teams adding polish to buttons, forms, modals, lists and scroll reveals.
- Anyone who wants a catalogue of effects with a live preview to browse first.
Not for
- Full cinematic or scroll-driven sites. It is a catalogue of small interface effects.
- Teams that need English instruction files, since the SKILL.md text is in Chinese.
- Accessibility audits. It adds reduced-motion support but is not an audit tool.
Use it with UiChemy
Motion is plain CSS and JS, which Composer can place inside a WordPress page. UiChemy Composer writes HTML, CSS and JS in Elementor or Gutenberg, so an effect from this skill can live on an editable page. Click Get Started on uichemy.com.
How to install Motion Ref Skill: 119 UI Animation Effects for AI Agents
git clone https://github.com/joepUI/motion-ref-skill.git ~/.claude/skills/motion-ref-skillThe README also lists a skills CLI route with the repository URL, and a live preview of all 119 effects on GitHub Pages.Clone into your skills folder
Run the clone command above. The README gives this manual route, and it places the repository in the Claude skills directory.
Use another agent folder
For other agents, clone it into their skills directory. The README says any SKILL.md-compatible agent can read it.
Restart your agent
The README says to restart your agent after installing.
Describe the problem
Type /motion-ref followed by a scenario, such as users clicking submit with no feedback for three seconds.
Check that it loaded
Describe a silent submit button. The agent should read the scene routing file and the button feedback category, then suggest effects with timing and a reduced-motion rule.
Key features
- Loading and waiting14 effects including spinner, skeleton shimmer, wave bars and a typing indicator.
- Button and click feedback9 effects such as press scale, ripple, success check, error shake and confetti.
- Text and data10 effects including typewriter, number counter, flip counter and shimmer text.
- Overlay and popup10 effects for modal, bottom sheet, toast, tooltip, drawer and command palette.
- Navigation and transition7 effects such as page slide, shared element, tab slide and dock navigation.
- Form and input10 effects including focus ring, floating label, toggle switch, OTP input and range slider.
- Scroll-driven5 effects: scroll reveal, progress indicator and scroll text reveal among them.
- Carousel, list and stateCarousel, card stack, drag reorder and accordion, plus state changes like a theme toggle.
- Atmosphere and data visualizationGradient flow, particles and 3D card hover, plus 12 chart entrance effects.
- Scene routingA routing reference maps product problems to effects, so a vague request becomes two or three candidate directions.
Frequently asked questions
What is the motion-ref skill?
It is an agent skill from joepUI that holds 119 UI motion effects in 13 categories. You describe a product scenario and the skill recommends fitting animations with implementation guidance, so you do not need to know animation terms.
How do I install motion-ref?
Clone the repository into your agent's skills folder, for example the Claude skills directory the README shows, then restart the agent. The README also lists a skills CLI route using the repository URL for agents that support it.
Which agents does motion-ref work with?
The README names Claude Code, Codex and OpenClaw, and says any SKILL.md-compatible agent can use it. It shows badges for those three, so other agents are expected to work only if they read SKILL.md files.
Is the skill in English?
The README is in English with a Chinese version, but the SKILL.md instructions and trigger phrases are written in Chinese. An agent can still follow them, though you may prefer to review the text first.
How do I use motion-ref in a prompt?
Use the slash command with a scenario, such as a pricing toggle whose prices should animate, or a landing page that needs a subtle premium feel on the hero. The skill picks effects and returns code you adapt.
What timing does it recommend?
The SKILL.md says ordinary interactions should run between 200 and 500 milliseconds, since longer feels slow and under 100 is hard to notice. It also asks for one consistent duration, easing and feedback strength for similar interactions.
How is it different from other animation skills?
It is a catalogue of small interface effects chosen by the problem you describe, not a set of principles. For principles see animation-principles, for code review of motion see review-animations, and for performance fixes see fixing-motion-performance.
Can I preview the effects first?
Yes, the README links a live preview page where all 119 effects can be browsed with demos. That lets you decide whether the catalogue fits your product before you install the skill into your agent.


