design-motion-principles

Creates and audits UI motion design using weighted designer perspectives and accessibility rules.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/singhaganesh/Urban-assist --skill design-motion-principles-singhaganesh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-motion-principles
Source: https://github.com/singhaganesh/Urban-assist/tree/main/.cursor/skills/design-motion-principles
Command: npx skills add https://github.com/singhaganesh/Urban-assist --skill design-motion-principles-singhaganesh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? UI animation work often suffers from inconsistent quality: AI-generated interfaces ship with repetitive motion patterns (pulsing indicators, blur-everywhere entrances, hover-scale on everything), missing reduced-motion support, and animations that ignore how frequently users trigger them. This Skill provides a structured framework for both building purposeful motion and auditing existing animations against expert design principles. ## Core Features & Use Cases - Create Mode: Builds interactive components with purposeful motion in React, Framer Motion, CSS, or HTML, applying a frequency gate (rare vs. daily vs. 100s/day interactions), context-appropriate durations, custom easing, and mandatory prefers-reduced-motion handling. - Audit Mode: Reviews existing animation code, detects motion gaps (conditional renders without AnimatePresence), flags AI-slop motion patterns with frequency heuristics, and emits a branded self-contained HTML report with looping per-finding demo cards. - Three Designer Lenses: Weights perspectives from Emil Kowalski (restraint and speed), Jakub Krehel (production polish), and Jhey Tompkins (playful experimentation) based on project type — productivity tools, kids apps, SaaS dashboards, portfolios, and more. - Use Case: Ask it to audit a Next.js dashboard's animations; it performs context reconnaissance, proposes a designer weighting for your confirmation, then produces an HTML report classifying findings as Critical, Important, or Opportunities with looping visual demos of the recommended fixes. ## Quick Start Ask the assistant to audit the animations in your current project, or to build a specific animated component such as a notification toast with Framer Motion.

Frequently Asked Questions about design-motion-principles

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

FAQPage Schema
How do I audit existing animations in a React project?

Ask for a motion audit of your project. The skill performs context reconnaissance on your package.json and existing animation code, proposes a designer weighting for confirmation, then checks your code against a systematic checklist and anti-pattern catalog before generating an HTML report with looping demos of recommended fixes.

How do I add an enter animation to a Framer Motion component?

Request the component in create mode. The skill applies the standard enter recipe combining opacity, translateY, and blur with a spring transition, makes exits subtler than enters, and includes prefers-reduced-motion handling in the same code.

Does this work with plain CSS animations or only Framer Motion?

It supports CSS, HTML, React, and Framer Motion. The motion cookbook includes pure-CSS techniques like the linear() easing function, @property typed custom properties, clip-path reveals, and scroll-driven animations alongside Framer Motion patterns.

What AI-slop motion patterns does the audit detect?

The audit flags pulsing indicators, blur-everywhere entrances, hover-scale on everything, stagger-spam on lists, bouncy springs on utility actions, uniform fade-ins, and motion on static text content. Each pattern has a frequency heuristic so single intentional uses are not flagged.

When should animations be removed instead of improved?

Remove animation from high-frequency interactions triggered hundreds of times daily and from keyboard-initiated actions, which should never animate. The frequency gate in both modes evaluates how often users trigger each interaction before recommending any motion.

Does the audit report require any special tooling to view?

No. The audit writes a self-contained HTML file to a motion-audits directory in your project root and opens it in your default browser. A terminal-mode flag renders the report inline instead if you prefer no HTML output.