motion-audit

Audits existing web and mobile UI to identify missing, excessive, or inconsistent motion.

1|Updated Sep 11, 2026
One-click install
npx skills add https://github.com/rebuildup/my-web-2026 --skill motion-audit-rebuildup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: motion-audit
Source: https://github.com/rebuildup/my-web-2026/tree/main/skills/motion-audit
Command: npx skills add https://github.com/rebuildup/my-web-2026 --skill motion-audit-rebuildup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Interfaces often suffer from motion that is missing where it would aid comprehension, excessive where it slows users down, or inconsistent with the spatial model of the UI. This Skill performs a read-only investigation of an existing UI and reports only high-confidence motion opportunities and motion debt, without modifying any source code. ## Core Features & Use Cases - Read-only UI investigation: Inspects existing motion primitives, tokens, libraries, and key interactions, then observes rendered behavior across state changes, gestures, feedback, and navigation. - Four-gate candidate filtering: Every candidate must pass frequency, purpose, interference, and spatial continuity checks before being reported, eliminating weak or decorative suggestions. - Prioritized reporting: Surviving candidates are reported with location, current behavior, purpose, frequency, observed problem, suggested motion relationship, and relevant existing tokens or primitives. - Use Case: Before a redesign sprint, run the audit on your app's navigation and list interactions to find where route transitions break spatial continuity or where async completions lack feedback, then hand the surviving candidates to an implementation pass. ## Quick Start Audit this project's UI for motion opportunities and motion debt, and report only the candidates that pass all four motion gates.

Frequently Asked Questions about motion-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit my website's animations and motion design?

Run a read-only motion audit that inspects existing motion primitives, tokens, and libraries, then observes rendered interactions like state changes, gestures, and navigation. Each finding is filtered through frequency, purpose, interference, and spatial continuity gates before being reported.

How to find where a UI needs more or less animation?

Inspect conditional renders, menus, list add/remove, accordions, route transitions, drag gestures, async completions, and hover feedback. Candidates only survive if they have a clear purpose such as feedback, continuity, orientation, attention, progress, or expression.

Does a motion audit modify my source code?

No. The audit is strictly read-only and never changes source code. Implementation of accepted findings is delegated to a separate motion-implement skill, and critique of existing implementations belongs to motion-review.

When should I not add motion to a UI?

Avoid motion that delays reading, comparison, or direct manipulation, such as decorative movement over text, lag on direct manipulation, or animation queues blocking repeated actions. High-frequency interactions should use short or no motion.

What makes a motion suggestion high quality?

A strong suggestion passes four gates: appropriate frequency for the interaction, an explicit purpose, no interference with tasks, and spatial continuity matching the UI's source, destination, and navigation hierarchy. Generic presets and universal duration rules are rejected.