Fixing Motion Performance skill
Repair animation jank by reviewing measurements, scroll work, paint cost and compositor behavior.
Community · ibelick| Author | ibelick |
|---|---|
| Licence | MIT |
| Source | ibelick/ui-skills · SKILL.md on GitHub |
| Project website | www.ui-skills.com |
| Works in | Claude Code · Codex, Gemini CLI, Cursor, Copilot |
| Read from the source on |
fixing-motion-performance reviews animation work within an application’s existing motion stack.
It targets layout read/write interleaving, unbounded loops, scroll polling, costly paint and oversized layers. Recommendations still need browser measurements on the actual surface.
From the skill's SKILL.md: # fixing-motion-performance
What it does
- Identify the rendering work behind a stutter or costly transition.
- Batch measurements and choose a suitable animation mechanism.
- Reduce continuous work, scope layers and verify the result.
What you get
- Scoped animation fixes and performance review notes.
- A concrete explanation of the rendering cost being changed.
When to use it
- Investigate a janky scroll or layout transition.
- Review blur, filters, will-change and animation cleanup.
When not to use it
- Migrating animation libraries without an explicit request.
What it needs
- Source access to the animation and its surrounding interface.
- Browser performance tooling and representative devices for validation; no required paid service.
Files in the skill
| File or folder | What it is for |
|---|---|
SKILL.md | Rendering glossary, priority rules and review guidance. |
Licence as found in the repository on 2026-11-17: MIT.
Example prompts
Type one of these after installing; naming the skill makes sure it is used.
- Find layout thrashing in this animation and batch reads before writes.
- Review this full-screen blur transition and propose a measured cheaper effect.
- Keep our Motion stack while fixing scroll polling and off-screen work.
How to install fixing-motion-performance
Measure the changed surface
Copy the individual skill folder. It is guidance for the agent, not a profiler installed in the browser.
Compositor-friendly properties do not guarantee promotion or acceptable memory use. Validate layers and frame behavior with tooling.
A skill is a folder with a SKILL.md file. You install it once; the agent reads its short description at the start of each session and loads the full instructions only when a request matches. Pick the place you use:
Claude Code: copy the folder into your skills folder
Put the skill's folder in ~/.claude/skills/ to use it in every project on this computer, or in .claude/skills/ inside a repository to share it with everyone who works there (commit it).
git clone --depth 1 https://github.com/ibelick/ui-skills.git
mkdir -p ~/.claude/skills
cp -R ui-skills/skills/fixing-motion-performance ~/.claude/skills/Claude Code notices new or changed skills in these folders during the session. If the skills folder did not exist when the session started, run /reload-skills once. Then type /fixing-motion-performance or just describe the task.
On Windows, run the commands in Git Bash or WSL, or copy the folder into the same place with File Explorer.
Codex, Gemini CLI, Cursor and GitHub Copilot
These agents read the same SKILL.md folders. The one folder all four accept inside a project is .agents/skills/, so this copies the skill there:
git clone --depth 1 https://github.com/ibelick/ui-skills.git
mkdir -p .agents/skills
cp -R ui-skills/skills/fixing-motion-performance .agents/skills/| Agent | Project folder | Your user folder | Notes |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | Type $ or run /skills to pick a skill; Codex also chooses one when your task matches. |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | Or install from Git with gemini skills install <git URL> --path <folder> --consent. Google replaced Gemini CLI with Antigravity CLI for free-tier and Google One users on 18 June 2026; Antigravity uses .agents/skills/ in a project and ~/.gemini/config/skills/ for you. |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Type / in Agent chat to pick a skill. Cursor also reads Claude Code's .claude/skills/ folders. |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Works in Copilot CLI, the cloud agent, and agent mode in VS Code, Visual Studio and JetBrains (IDE support depends on the version). Or run gh skill install OWNER/REPOSITORY SKILL (public preview, GitHub CLI 2.90.0 or later). |
Sources for these steps
Checked against each vendor's documentation on 2026-11-14:
Choose work the browser can sustain
One-shot effects on small isolated elements differ from continuous paint across a large surface. Duration, area and interaction needs determine the tradeoff.
Pause off-screen work and stop loops when no longer needed. A screenshot cannot establish animation smoothness.
Questions about fixing-motion-performance
Does it require Motion or GSAP?
No. The rules apply to CSS, WAAPI, requestAnimationFrame and existing animation libraries.
Are transform and opacity always free?
No. They are preferred starting points, but layer behavior and actual surface cost must be measured.
Will it remove all animation?
The source prefers a cheaper suitable technique before removing motion entirely.
Why avoid permanent will-change?
Many large promoted layers can consume memory. Promotion should be temporary and narrowly scoped.
More AI skills
Related skills
Fixing Accessibility skill
Community · ibelickReview names, keyboard access, focus, semantics and announcements with small targeted changes.Locomotive Scroll skill
Community · Claude Design SkillstackPlan smooth scrolling, parallax and GSAP integration while checking API versions and accessibility.Motion & Framer Motion skill
Community · Claude Design SkillstackCreate React motion components, exit transitions, variants, gestures and layout animations.Lottie Animations skill
Community · Claude Design SkillstackIntegrate JSON and dotLottie assets with playback controls, cleanup and performance checks.Improve UI skill
Community · ibelickAudit one product surface from proven design evidence and write selected implementation plans.Thumbnail Design skill
Community · Frank HeijdenrijkBrief honest, mobile-readable video thumbnails and plan a native comparison test.