
Design Motion Principles
Skill交互动效技能,综合 Emil Kowalski、Jakub Krehel、Jhey Tompkins 三位设计工程师的动效理念:可按项目类型生成带动效的界面组件,也能审查现有动画并输出带循环演示的 HTML 报告。需在 Claude Code、Cursor 等编程 agent 中配合本地前端项目使用。
Design Motion Principles
A motion and interaction design skill with two modes — build interactive components with purposeful motion, or audit existing animations. Both modes give context-aware, per-designer guidance drawn from three distinct motion-design lenses.
Distilled from the publicly published work of Emil Kowalski, Jakub Krehel, and Jhey Tompkins (see Credits).
Installation
npx skills add kylezantos/design-motion-principles
Works with Claude Code, Cursor, Windsurf, and other AI coding assistants.
What It Does
The skill applies three distinct motion-design philosophies, weighted by your project's context:
| Lens | Philosophy | Key question | Best for |
|---|---|---|---|
| Emil Kowalski | Restraint & speed | "Should this animate at all?" | Productivity tools, high-frequency interactions |
| Jakub Krehel | Production polish | "Is this subtle enough?" | Shipped consumer apps, professional refinement |
| Jhey Tompkins | Creative experimentation | "What could this become?" | Kids apps, portfolios, playful contexts |
The point isn't a single set of rules — it's the productive tension between three lenses that genuinely disagree. Emil would cut an animation Jhey would add. The skill weights them to your context instead of applying one philosophy everywhere.
Two Modes
Create — Build interactive components with motion baked in. The skill runs a light discovery (project context + which lenses to weight), then generates components — React, Framer Motion, CSS, or HTML — applying the right recipes, accessibility, and performance defaults.
Audit — Review existing motion design. The skill does reconnaissance on your project, runs a motion-gap analysis (finds UI that should animate but doesn't), checks the code against an anti-AI-slop checklist (pulsing indicators, hover-scale-on-everything, stagger-spam, and other 2026 AI-generated motion tells), proposes a per-lens weighting, and delivers a branded HTML report with auto-looping CSS demos beside each Critical and Important finding. Pass --terminal for the inline markdown report instead.
The skill detects which mode you want from your request. If it's ambiguous, it asks.
Key Features
-
Context-aware weighting — Maps your project type (productivity tool, kids app, marketing site, dashboard…) to a primary/secondary/selective lens weighting before doing anything.
-
Motion gap analysis (Audit) — Searches for conditional UI that should be animated but isn't: conditional renders without
AnimatePresence, dynamic styles without transitions, instant state swaps. -
Anti-AI-slop checklist (Audit) — A quality gate that flags the recognizable motion fingerprints of AI-generated UIs: pulsing indicators, blur-everywhere entrances, hover-scale-on-everything, stagger-spam, bouncy springs on utility actions, uniform fade-ins, motion-on-mount for static content. Each category has a frequency heuristic so single intentional uses don't trip it.
-
Branded HTML report (Audit) — The default audit output is a self-contained HTML file with auto-looping CSS demos beside each Critical and Important finding, so you can see the recommended motion instead of reading code. Writes to
motion-audits/, opens in your browser.--terminalfalls back to the inline markdown report for headless/CI use. -
Motion cookbook (Create) — A single, consolidated recipe library: enter/exit animations, easing, springs, clip-path,
@property, shared-layout/FLIP, scroll-driven animation. -
Creation gotchas (Create) — Built-in self-check against the common failure modes of AI-generated motion: decorative-by-default animation,
scale(0)starts, bareease, missingprefers-reduced-motion.
Usage
Once installed, just ask in natural language.
To build:
Add a polished enter/exit animation to this modal
Build an animated toast component for this dashboard
To audit:
Audit the motion design in this codebase
Review the animations in this component
Example: Audit output
## Reconnaissance Complete
**Project type**: Kids educational app, mobile-first PWA
**Existing animation style**: Spring animations (500-600ms), framer-motion
**Motion gaps found**: 4 conditional renders without AnimatePresence
**Proposed perspective weighting**:
- **Primary**: Jakub Krehel — Production polish for a shipped consumer app
- **Secondary**: Jhey Tompkins — Playful experimentation for kids
- **Selective**: Emil Kowalski — Only for high-frequency game interactions
Does this approach sound right?
What's Included
skills/
└── design-motion-principles/
├── SKILL.md # Router: mode detection + shared principles
├── workflows/
│ ├── create.md # Build interactive components
│ └── audit.md # Review existing motion design
└── references/
├── motion-cookbook.md # All motion recipes (single source of truth)
├── creation-gotchas.md # Failure modes when generating motion
├── audit-checklist.md # Structured audit criteria
├── anti-checklist.md # Quality gate: AI-slop categories + anti-patterns
├── demo-shell.html # Minimal single-card template for HTML-report demos
├── report-template.html # Full worked-example audit report (HTML output reference)
├── emil-kowalski.md # Emil's philosophy & decision frameworks
├── jakub-krehel.md # Jakub's philosophy & decision frameworks
├── jhey-tompkins.md # Jhey's philosophy & decision frameworks
├── accessibility.md # Motion accessibility guidelines
├── performance.md # Performance best practices
└── output-format.md # Report template (HTML + terminal modes)
Manual Installation
If you prefer not to use npx skills add:
Global (all projects):
git clone https://github.com/kylezantos/design-motion-principles.git
cp -r design-motion-principles/skills/design-motion-principles ~/.claude/skills/
For Cursor:
cp -r design-motion-principles/skills/design-motion-principles ~/.cursor/skills/
Credits
This skill is an interpretation and distillation of motion-design principles from the publicly published work — courses, articles, talks, and open-source projects — of three designers. The three-lens weighting framework and the "through X's lens" framing are this skill's own synthesis, named in tribute. The skill is not authored or endorsed by the designers below; for their actual work, go to the source:
- Emil Kowalski — emilkowal.ski, animations.dev, Sonner, Vaul
- Jakub Krehel — krehel.com
- Jhey Tompkins — jhey.dev, @jh3yy
License
MIT
相關資源

UI UX Pro Max
Skill界面设计知识库技能:按产品类型检索界面风格、配色、字体搭配、图表与 UX 规范,并生成完整设计系统,覆盖 React、SwiftUI、Flutter 等 22 种技术栈。需本机安装 Python 3。
nextlevelbuilder/ui-ux-pro-max-skill151k
Impeccable
Skill前端设计打磨技能:一个技能提供 polish、audit、critique、typeset 等 24 条命令,并用 61 条确定性检测规则找出典型的 AI 生成界面问题,支持在浏览器里实时迭代。适用于 Claude Code、Codex、Cursor 等工具。
pbakaus/impeccable112k
Skills For Designers and Engineers
SkillSonner、Vaul 作者 Emil Kowalski 编写的设计工程技能:帮助选择动画曲线与时长,评审和改进动效,吸收 Apple 设计原则,让网页在手机上更像原生应用,并协助选择 UI 库、做多版本原型。
emilkowalski/skills57.9k
Jakub Krehel Skills
Skill设计工程师 Jakub Krehel 的界面技能合集,共 11 个:排版、配色、布局、无障碍与界面文案专项改进,外加整体界面走查、拆解网页动效做法、组件全状态压力测试和多版本方案生成。作用于网页项目代码,安装需本机 Node.js。
jakubkrehel/skills12.4k
UI Skills
Skill面向设计工程师的界面技能合集:清理 AI 生成界面的间距与层级、修复可访问性和网页元数据、排查动效卡顿、从现有产品或网站整理 DESIGN.md,并只读评审界面、写出改进方案。需在 Claude Code、Codex 等编程 agent 中配合本地前端项目使用。
ibelick/ui-skills11.2k
Figma Skills (mcp-server-guide)
SkillFigma 官方技能合集:把设计稿还原成代码、用 Code Connect 映射组件、从代码生成设计系统组件库、在画布上搭建页面和 FigJam 图表。需连接 Figma MCP 服务器;写入画布目前处于 Beta 阶段,暂时免费。
figma/mcp-server-guide2.2k