Skip to content
Back to search

design-motion-principles

A motion design skill with two modes — build interactive components with purposeful motion, or audit existing animations. Context-aware, per-designer guidance distilled from the published work of Emil Kowalski, Jakub Krehel, and Jhey Tompkins.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kylezantos--design-motion-principles/badge.svg)](/listings/kylezantos--design-motion-principles)

HTML

<a href="/listings/kylezantos--design-motion-principles"><img src="/api/listings/kylezantos--design-motion-principles/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx skills add kylezantos/design-motion-principles

Works with Claude Code, Cursor, Windsurf, and other AI coding assistants.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 131 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Design Motion Principles
  2. 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.
  3. Distilled from the publicly published work of **Emil Kowalski**, **Jakub Krehel**, and **Jhey Tompkins** (see [Credits](#credits)).
  4. ## Installation
  5. ```bash
  6. npx skills add kylezantos/design-motion-principles
  7. ```
  8. Works with Claude Code, Cursor, Windsurf, and other AI coding assistants.
  9. ## What It Does
  10. The skill applies three distinct motion-design philosophies, weighted by your project's context:
  11. | Lens | Philosophy | Key question | Best for |
  12. |------|-----------|--------------|----------|
  13. | **Emil Kowalski** | Restraint & speed | "Should this animate at all?" | Productivity tools, high-frequency interactions |
  14. | **Jakub Krehel** | Production polish | "Is this subtle enough?" | Shipped consumer apps, professional refinement |
  15. | **Jhey Tompkins** | Creative experimentation | "What could this become?" | Kids apps, portfolios, playful contexts |
  16. 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.
  17. ### Two Modes
  18. **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.
  19. **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.
  20. The skill detects which mode you want from your request. If it's ambiguous, it asks.
  21. ### Key Features
  22. 1. **Context-aware weighting** — Maps your project type (productivity tool, kids app, marketing site, dashboard…) to a primary/secondary/selective lens weighting before doing anything.
  23. 2. **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.
  24. 3. **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.
  25. 4. **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. `--terminal` falls back to the inline markdown report for headless/CI use.
  26. 5. **Motion cookbook** (Create) — A single, consolidated recipe library: enter/exit animations, easing, springs, clip-path, `@property`, shared-layout/FLIP, scroll-driven animation.
  27. 6. **Creation gotchas** (Create) — Built-in self-check against the common failure modes of AI-generated motion: decorative-by-default animation, `scale(0)` starts, bare `ease`, missing `prefers-reduced-motion`.
  28. ## Usage
  29. Once installed, just ask in natural language.
  30. **To build:**
  31. ```
  32. Add a polished enter/exit animation to this modal
  33. Build an animated toast component for this dashboard
  34. ```
  35. **To audit:**
  36. ```
  37. Audit the motion design in this codebase
  38. Review the animations in this component
  39. ```
  40. ### Example: Audit output
  41. ```
  42. ## Reconnaissance Complete
  43. **Project type**: Kids educational app, mobile-first PWA
  44. **Existing animation style**: Spring animations (500-600ms), framer-motion
  45. **Motion gaps found**: 4 conditional renders without AnimatePresence
  46. **Proposed perspective weighting**:
  47. - **Primary**: Jakub Krehel — Production polish for a shipped consumer app
  48. - **Secondary**: Jhey Tompkins — Playful experimentation for kids
  49. - **Selective**: Emil Kowalski — Only for high-frequency game interactions
  50. Does this approach sound right?
  51. ```
  52. ## What's Included
  53. ```
  54. skills/
  55. └── design-motion-principles/
  56. ├── SKILL.md # Router: mode detection + shared principles
  57. ├── workflows/
  58. │ ├── create.md # Build interactive components
  59. │ └── audit.md # Review existing motion design
  60. └── references/
  61. ├── motion-cookbook.md # All motion recipes (single source of truth)
  62. ├── creation-gotchas.md # Failure modes when generating motion
  63. ├── audit-checklist.md # Structured audit criteria
  64. ├── anti-checklist.md # Quality gate: AI-slop categories + anti-patterns
  65. ├── demo-shell.html # Minimal single-card template for HTML-report demos
  66. ├── report-template.html # Full worked-example audit report (HTML output reference)
  67. ├── emil-kowalski.md # Emil's philosophy & decision frameworks
  68. ├── jakub-krehel.md # Jakub's philosophy & decision frameworks
  69. ├── jhey-tompkins.md # Jhey's philosophy & decision frameworks
  70. ├── accessibility.md # Motion accessibility guidelines
  71. ├── performance.md # Performance best practices
  72. └── output-format.md # Report template (HTML + terminal modes)
  73. ```
  74. ## Manual Installation
  75. If you prefer not to use `npx skills add`:
  76. **Global (all projects):**
  77. ```bash
  78. git clone https://github.com/kylezantos/design-motion-principles.git
  79. cp -r design-motion-principles/skills/design-motion-principles ~/.claude/skills/
  80. ```
  81. **For Cursor:**
  82. ```bash
  83. cp -r design-motion-principles/skills/design-motion-principles ~/.cursor/skills/
  84. ```
  85. ## Credits
  86. 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:
  87. - **Emil Kowalski** — [emilkowal.ski](https://emilkowal.ski), [animations.dev](https://animations.dev), [Sonner](https://sonner.emilkowal.ski), [Vaul](https://vaul.emilkowal.ski)
  88. - **Jakub Krehel** — [krehel.com](https://krehel.com)
  89. - **Jhey Tompkins** — [jhey.dev](https://jhey.dev), [@jh3yy](https://twitter.com/jh3yy)
  90. ## License
  91. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.