Skip to content

Fixing Motion Performance skill

Repair animation jank by reviewing measurements, scroll work, paint cost and compositor behavior.

Community · ibelick
Authoribelick
LicenceMIT
Sourceibelick/ui-skills · SKILL.md on GitHub
Project websitewww.ui-skills.com
Works inClaude 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

This is a community skill by ibelick, not checked by us or by Anthropic. Skills can tell the agent to run code, read files or call the network. Before installing, read its SKILL.md and every script in the folder, and look for anything that does not match what it says it does.

What it does

  1. Identify the rendering work behind a stutter or costly transition.
  2. Batch measurements and choose a suitable animation mechanism.
  3. 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 folderWhat it is for
SKILL.mdRendering 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/
AgentProject folderYour user folderNotes
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).
Only install skills you trust. Anthropic's advice is to use skills only from trusted sources, and to read every file of any other skill before using it: a skill can direct the agent to run commands, read files or send data in ways its description does not mention.

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

Skill categories