LottieFiles' motion-design-skill: An Open-Source Guide Teaching AI Agents UI Motion Principles
Published by LottieFiles, motion-design-skill is an open-source skill repository that guides AI coding agents to decide timing, easing, and Disney's 12 animatio
LottieFiles/motion-design-skill is an open-source repository maintained by LottieFiles that prompts AI coding agents to think like motion directors—deciding timing, easing, and choreography before generating user interface (UI) animation code. Originally created on GitHub on March 12, 2026, the repository drew renewed attention on X in mid-November 2026 alongside a curated list of motion and video creation tools for agents, reaching 3,074 stars and 217 forks as of November 14, 2026.

Image source: https://x.com/0xMovez/status/2121312707588583455
When asked to animate a button or modal, standard AI coding assistants often jump straight into emitting CSS transitions or JavaScript snippets without planning how elements should feel. motion-design-skill inserts a structured design step before implementation, establishing framework-agnostic motion rules that apply regardless of the target stack.
What Problem It Solves and How It Works
In interface engineering, the hardest part of motion design is rarely the syntax of a transition—it is choosing how fast an element should move (timing), how it accelerates and decelerates (easing), and how multiple components enter or exit together (choreography). Without clear guardrails, agent-generated animations frequently end up uniform, sluggish, or overly bouncy.
Here, a "skill" is not a runtime software package; it is a structured collection of Markdown instructions that compatible coding agents load when relevant tasks arise. According to the repository README, the skill activates when a developer works on UI transitions (buttons, cards, modals, page changes), micro-interactions, loading/success/error states, scroll-triggered effects, brand motion identity, or multi-element sequencing. Instead of locking the workflow to a single library, the instructions help the agent plan intent and motion parameters first, then translate them into CSS, Framer Motion, GSAP, Lottie, or spring-based code.
Repository Structure and Included Guides
Released under the MIT License, the repository organizes its motion guidance into a primary skill file and three supporting directories:
- Core (
SKILL.md): A concise reference file kept under 500 lines, bundling an 8-step checklist, four motion personality archetypes, duration and easing tables, property selection advice, and quality rules. - Philosophy (
director/): Explores the foundational Three Pillars (core-philosophy.md), a full decision pipeline (decision-framework.md), and Disney's 12 principles of animation adapted for UI (disney-principles.md). It also covers emotion-to-motion translation (emotion-mapping.md), multi-element coordination (choreography.md), micro-story framing (narrative-structure.md), and platform, accessibility, and performance adaptation (context-adaptation.md). - Patterns (
patterns/): Provides ready-to-use structural recipes for entrance and exit transitions (entrance-exit.md), state feedback across success, error, loading, and hover states (state-feedback.md), continuous looping or parallax motion (ambient-continuous.md), and staggered multi-element choreography (multi-element.md). - Reference (
reference/): Offers lookup tables for timing and easing (timing-easing-tables.md), guidance on what different animated properties communicate (property-selection.md), evaluation checklists (quality-checklist.md), and fixes for common animation issues (troubleshooting.md).
Installation and Practical Workflows
Developers can install the skill through a single command-line interface (CLI) command. The README notes compatibility with more than 40 agent environments supported via skills.sh, including Claude Code, Cursor, Codex, and GitHub Copilot.
npx skills add LottieFiles/motion-design-skill
Once installed, developers can describe motion goals in plain language rather than manually specifying cubic-bezier curves or millisecond offsets. In the repository's example workflows, a user might ask an agent to build a loading-to-success-to-error state transition on a form submit button, choreograph a dashboard entrance where the hero chart appears before stat cards and the sidebar, or audit existing animation code against established motion principles.
Verified Scope and Limitations
motion-design-skill is strictly a prompt and decision-framework repository rather than a rendering engine or component library. Projects still rely on native CSS or an external animation library to execute the generated code in production.
Readers should also note that the mid-November 2026 social media buzz reflects community discovery rather than a new product launch. Official GitHub activity metadata shows the repository was created on March 12, 2026, with its most recent commit pushed on May 18, 2026, and no formal GitHub Releases or CHANGELOG entries published. In addition, the repository documents design guidelines and workflows rather than independent empirical benchmarks measuring output quality across different AI models, so teams should still review generated motion for accessibility preferences and runtime performance.
Sources
- Official GitHub Repository: LottieFiles/motion-design-skill