Lottie Animation Integration
freshtechbro/claudedesignskills
Implements After Effects Lottie animations in web and React apps: picking JSON or dotLottie format, a rendering library, and a data source, with an optimizer script.
Motion and interaction design expert based on Emil Kowalski, Jakub Krehel, and Jhey Tompkins' techniques.
Install Design Motion Principles
$ npx skills add Dinil-Thilakarathne/sona-ui --skill design-motion-principles -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Dinil-Thilakarathne/sona-ui design-motion-principles --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Dinil-Thilakarathne/sona-ui.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/design-motion-principles .claude/skills/design-motion-principles && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "design-motion-principles" agent skill from https://github.com/Dinil-Thilakarathne/sona-ui/tree/master/.agents/skills/design-motion-principles into .claude/skills/design-motion-principles/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-motion-principles", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Dinil-Thilakarathne/sona-ui/tree/master/.agents/skills/design-motion-principlesType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Dinil-Thilakarathne/sona-ui --skill design-motion-principles -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Dinil-Thilakarathne/sona-ui design-motion-principles --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Dinil-Thilakarathne/sona-ui.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/design-motion-principles .agents/skills/design-motion-principles && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "design-motion-principles" agent skill from https://github.com/Dinil-Thilakarathne/sona-ui/tree/master/.agents/skills/design-motion-principles into .agents/skills/design-motion-principles/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-motion-principles", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Dinil-Thilakarathne/sona-ui --skill design-motion-principles -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Dinil-Thilakarathne/sona-ui design-motion-principles --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Dinil-Thilakarathne/sona-ui.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/design-motion-principles .cursor/skills/design-motion-principles && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "design-motion-principles" agent skill from https://github.com/Dinil-Thilakarathne/sona-ui/tree/master/.agents/skills/design-motion-principles into .cursor/skills/design-motion-principles/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-motion-principles", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Dinil-Thilakarathne/sona-ui.git --path .agents/skills/design-motion-principles--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Dinil-Thilakarathne/sona-ui --skill design-motion-principles -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Dinil-Thilakarathne/sona-ui design-motion-principles --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Dinil-Thilakarathne/sona-ui.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/design-motion-principles .gemini/skills/design-motion-principles && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "design-motion-principles" agent skill from https://github.com/Dinil-Thilakarathne/sona-ui/tree/master/.agents/skills/design-motion-principles into .gemini/skills/design-motion-principles/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-motion-principles", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Dinil-Thilakarathne/sona-ui design-motion-principlesInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Dinil-Thilakarathne/sona-ui --skill design-motion-principles -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Dinil-Thilakarathne/sona-ui.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/design-motion-principles .github/skills/design-motion-principles && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "design-motion-principles" agent skill from https://github.com/Dinil-Thilakarathne/sona-ui/tree/master/.agents/skills/design-motion-principles into .github/skills/design-motion-principles/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-motion-principles", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Dinil-Thilakarathne/sona-ui --skill design-motion-principles -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Dinil-Thilakarathne/sona-ui design-motion-principles --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Dinil-Thilakarathne/sona-ui.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/design-motion-principles .opencode/skills/design-motion-principles && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "design-motion-principles" agent skill from https://github.com/Dinil-Thilakarathne/sona-ui/tree/master/.agents/skills/design-motion-principles into .opencode/skills/design-motion-principles/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-motion-principles", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
design-motion-principles- GitHub stars
- 118
- Used in
- 1 other repo
- Token cost
- ~1.7k tokens
- SKILL.md length
- 681 words
- Files
- 15 (incl. references)
- Skills in repo
- 10
- Repo updated
- First seen
- Licence
- MIT
At a glance
Motion and interaction design expert based on Emil Kowalski, Jakub Krehel, and Jhey Tompkins' techniques.
- Reviewing UI motion: transitions
- SKILL.md covers STEP 0: Detect Mode (DO THIS…, The Three Designers, Context-to-Perspective Mapping and Core Principles (Both Modes), plus 2 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Micro-interactions
What it does
Design Motion Principles is an agent skill from Dinil-Thilakarathne/sona-ui. Motion and interaction design expert based on Emil Kowalski, Jakub Krehel, and Jhey Tompkins' techniques. Two modes — build interactive components with purposeful motion, or audit existing animations to catch AI-slop motion patterns (audit emits a branded HTML report with looping demos). Use when creating, adding, animating, or reviewing UI motion: transitions, hover states, micro-interactions, enter/exit animations, or any motion design work in React, Framer Motion, CSS, or HTML. Provides per-designer…
Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 16 other files, including reference files (for example `references/accessibility.md`, `references/anti-checklist.md` and `references/audit-checklist.md`).
It sits in Frontend & Design, covering Web animation and motion and Motion graphics. It works with React and Motion. The repository describes itself as: A modern UI component library built with React and TailwindCSS to help you build beautiful and accessible web applications faster. The licence is MIT.
When your agent uses it
- Reviewing UI motion: transitions
- Micro-interactions
- Enter/exit animations
- Any motion design work in React
Example prompts
- “/design-motion-principles”
What it can do on your machine
Read from SKILL.md and the folder at commit 9a72ffe. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Design Motion Principles loads about 1.7k tokens when it runs, and up to ~40k if it reads all its reference files. Until then it costs about 144 tokens; SKILL.md has 681 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from Dinil-Thilakarathne/sona-ui at commit 9a72ffe, republished under its MIT licence (© Dinil-Thilakarathne). 681 words, ~1,699 tokens.
Download SKILL.mdSave it as
.claude/skills/design-motion-principles/SKILL.md (or your agent's skills folder). This skill also uses 14 other files; get the full folder from GitHub.- name
- design-motion-principles
- description
- Motion and interaction design expert based on Emil Kowalski, Jakub Krehel, and Jhey Tompkins' techniques. Two modes — build interactive components with purposeful motion, or audit existing animations to catch AI-slop motion patterns (audit emits a branded HTML report with looping demos). Use when creating, adding, animating, or reviewing UI motion: transitions, hover states, micro-interactions, enter/exit animations, or any motion design work in React, Framer Motion, CSS, or HTML. Provides per-designer perspectives with context-aware weighting.
Design Motion Principles
You are a senior design engineer specializing in motion and interaction design. This skill operates in two modes:
- Create — Build interactive components with purposeful motion →
workflows/create.md - Audit — Review existing motion design and report findings →
workflows/audit.md
Scope: Web and app UI motion — HTML/CSS, React, Framer Motion / Motion, iOS/Android transitions, design system animations. The frequency framework still applies to other motion work (game engines, Lottie, Rive, video), but designer-specific techniques may not translate.
STEP 0: Detect Mode (DO THIS FIRST)
| Signal in the request | Mode |
|---|---|
| "build", "create", "add animation", "animate this", "implement", "make it feel…" | Create |
| "audit", "review", "evaluate", "check", "feedback on", "is this motion good" | Audit |
| Ambiguous (e.g. "look at this modal animation") | Ask the user |
For ambiguous requests, if AskUserQuestion is available, present:
- Create — Build or improve the component's motion
- Audit — Review existing motion and report findings
Otherwise ask in plain text: "Should I build/improve the motion (Create mode), or review existing motion and report findings (Audit mode)?"
Once the mode is known, read the matching workflow file and follow it exactly.
The Three Designers
- Emil Kowalski (Linear, ex-Vercel) — Restraint, speed, purposeful motion. Best for productivity tools.
- Jakub Krehel (jakub.kr) — Subtle production polish, professional refinement. Best for shipped consumer apps.
- Jhey Tompkins (@jh3yy) — Playful experimentation, CSS innovation. Best for creative sites, kids apps, portfolios.
These three lenses distill each designer's publicly published work — courses, articles, talks, and open-source projects. The weighting framework and the "lens" framing are this skill's interpretation of their principles, named in tribute; they are not authored or endorsed by the designers themselves.
Each designer answers a different question:
- Emil — "Should this animate at all?"
- Jakub — "Is this subtle and polished enough for production?"
- Jhey — "What could this become?"
Critical insight: These perspectives are context-dependent, not universal rules. A kids' app should prioritize Jakub + Jhey (polish + delight), not Emil's productivity-focused speed rules. Both modes weight the designers by project context before doing anything.
Context-to-Perspective Mapping
| Project Type | Primary | Secondary | Selective |
|---|---|---|---|
| Productivity tool (Linear, Raycast) | Emil | Jakub | Jhey (onboarding only) |
| Kids app / Educational | Jakub | Jhey | Emil (high-freq game interactions) |
| Creative portfolio | Jakub | Jhey | Emil (high-freq interactions) |
| Marketing/landing page | Jakub | Jhey | Emil (forms, nav) |
| SaaS dashboard | Emil | Jakub | Jhey (empty states) |
| Mobile app | Jakub | Emil | Jhey (delighters) |
| E-commerce | Jakub | Emil | Jhey (product showcase) |
Core Principles (Both Modes)
The Frequency Gate
Before adding or approving any animation, ask how often the user triggers it:
| Frequency | Recommendation |
|---|---|
| Rare (monthly) | Delightful, expressive motion welcome |
| Occasional (daily) | Subtle, fast motion |
| Frequent (100s/day) | No animation or instant transition |
| Keyboard-initiated | Never animate |
Show full SKILL.md (261 more words)Show less
Duration Guidelines (Context-Dependent)
| Context | Guideline |
|---|---|
| Productivity UI (Emil) | Under 300ms — 180ms ideal |
| Production polish (Jakub) | 200-500ms for smoothness |
| Creative/kids/playful (Jhey) | Whatever serves the effect |
Do not universally flag or cap durations. Check the context weighting first.
The Golden Rule
"The best animation is that which goes unnoticed."
If users comment "nice animation!" on every interaction, it's probably too prominent for production. (Exception: kids apps and playful contexts where delight IS the goal.)
Accessibility is NOT Optional
Every animation — generated in Create mode or reviewed in Audit mode — must handle prefers-reduced-motion. No exceptions. See references/accessibility.md.
Reference Index
| File | Contents | Load When |
|---|---|---|
| Motion Cookbook | All motion recipes — enter/exit, easing, springs, clip-path, @property, FLIP, scroll-driven | Create mode (always); Audit mode for implementation recommendations |
| Creation Gotchas | Claude's failure modes when writing motion | Create mode (always) |
| Audit Checklist | Systematic audit checklist | Audit mode (always) |
| Anti-Checklist | Quality gate — AI-slop motion categories + anti-patterns to flag | Audit mode (always) |
| Emil Kowalski | Restraint philosophy, frequency rule, decision frameworks | Either mode, if Emil is weighted |
| Jakub Krehel | Production polish philosophy and decision frameworks | Either mode, if Jakub is weighted |
| Jhey Tompkins | Playful experimentation philosophy and frameworks | Either mode, if Jhey is weighted |
| Accessibility | prefers-reduced-motion, vestibular safety | Both modes (mandatory) |
| Performance | GPU optimization, will-change, layout thrash | Either mode, for complex animations |
| Output Format | Audit report template — HTML mode (default) + terminal mode (flag) | Audit mode only |
| Demo Shell | Visual container template for per-finding demo cards in the HTML report | Audit mode, HTML output |
Workflow Index
© Dinil-Thilakarathne, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 14 other files (references) in .agents/skills/design-motion-principles of Dinil-Thilakarathne/sona-ui.
- SKILL.md
- references/accessibility.md
- references/anti-checklist.md
- references/audit-checklist.md
- references/creation-gotchas.md
- references/demo-shell.html
- references/emil-kowalski.md
- references/jakub-krehel.md
- references/jhey-tompkins.md
- references/motion-cookbook.md
- references/output-format.md
- references/performance.md
- references/report-template.html
- workflows/audit.md
- workflows/create.md
Open the folder on GitHubat commit 9a72ffe
Used in 1 other repository
We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in Dinil-Thilakarathne/sona-ui, which our catalogue first saw on October 7, 2026.
Compare with similar skills
Design Motion Principles next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Design Motion Principles this skillDinil-Thilakarathne/sona-ui | 118 | 1 repos | ~1.7k | Automated safety check: Pass | MIT | |
| Lottie Animation Integrationfreshtechbro/claudedesignskills | 1k | — | ~4.5k | Automated safety check: Pass | MIT | |
| Motiscope RecreateKumarSashank/motiscope | 122 | — | ~2k | Automated safety check: Pass | MIT | |
| RecreateKumarSashank/motiscope | 122 | — | ~1.8k | Automated safety check: Notes | MIT | |
| AnimateOneWave-AI/claude-skills | 336 | — | ~1.4k | Automated safety check: Notes | MIT | |
| Animated React Component LibrariesHainrixz/editor-pro-max | 264 | 1 repos | ~5.7k | Automated safety check: Pass | Custom licence |
Similar skills
Motiscope Recreate
KumarSashank/motiscope
Recreate an analyzed animation as working web code — GSAP (JavaScript), CSS/Web Animations, Framer Motion (React), or Lottie/SVG.
Recreate
KumarSashank/motiscope
Recreate an analyzed animation as working web code — GSAP (JavaScript), CSS/Web Animations, Framer Motion (React), or Lottie/SVG.
Animate
OneWave-AI/claude-skills
Generate animated videos and motion graphics from natural language descriptions.
Animated React Component Libraries
Hainrixz/editor-pro-max
Helps choose and drop in animated React components from Magic UI and React Bits for landing pages, marketing sites and dashboards, instead of hand-coding animations.
Motion Dev Animations
199-biotechnologies/motion-dev-animations-skill
Creates 120fps GPU-accelerated animations with Motion.dev (Framer Motion successor) for React, Next.js, Svelte, and Astro projects.
More from Dinil-Thilakarathne/sona-ui
All 10 skills in this repoOklch Skill
Dinil-Thilakarathne/sona-ui
OKLCH color space for web projects. An agent skill from Dinil-Thilakarathne/sona-ui.
Sona UI
Dinil-Thilakarathne/sona-ui
Discover and integrate Sona UI registry components. An agent skill from Dinil-Thilakarathne/sona-ui.
Smooth Shadow Ring
Dinil-Thilakarathne/sona-ui
A skill your agent uses when styling any elevated surface (card, dialog, popover, dropdown, menu, tooltip, sheet, toast) in a Tailwind project that has shadow-plugin installed.
Add Sona Component
Dinil-Thilakarathne/sona-ui
Integrate a new component into the Sona UI library end to end — the full per-component pipeline of writing the component, demo, docs, registry entry, nav link, playground controls, regenerating the…
Component Anatomy
Dinil-Thilakarathne/sona-ui
Create a source-backed Inspection Board around an existing Sona UI component for social demonstrations and later documentation experiments.
Promote Portfolio Component
Dinil-Thilakarathne/sona-ui
Promote a finished Craft, experimental UI, or reusable React component from the user's portfolio into the Sona UI library through an approval-gated two-phase workflow.
Related
Categories
Questions about Design Motion Principles
What does Design Motion Principles do?
Motion and interaction design expert based on Emil Kowalski, Jakub Krehel, and Jhey Tompkins' techniques. Design Motion Principles is an agent skill from Dinil-Thilakarathne/sona-ui. Motion and interaction design expert based on Emil Kowalski, Jakub Krehel, and Jhey Tompkins' techniques.
When should I use Design Motion Principles?
Design Motion Principles fits situations like: reviewing UI motion: transitions; micro-interactions; enter/exit animations; any motion design work in React.
How do I install Design Motion Principles in Claude Code?
Run `npx skills add Dinil-Thilakarathne/sona-ui --skill design-motion-principles -a claude-code`. Or copy the skill folder (.agents/skills/design-motion-principles in Dinil-Thilakarathne/sona-ui) into .claude/skills/design-motion-principles in your project. Claude Code loads it when a task matches its description.
How do I install Design Motion Principles in Codex?
Run `npx skills add Dinil-Thilakarathne/sona-ui --skill design-motion-principles -a codex`. Or copy the skill folder (.agents/skills/design-motion-principles in Dinil-Thilakarathne/sona-ui) into .agents/skills/design-motion-principles in your project. Codex loads it when a task matches its description.
Can I use Design Motion Principles in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Dinil-Thilakarathne/sona-ui --skill design-motion-principles -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/design-motion-principles, .gemini/skills/design-motion-principles, .github/skills/design-motion-principles and .opencode/skills/design-motion-principles in your project.
What does Design Motion Principles need to run?
SKILL.md names no scripts, command-line tools or credentials: Design Motion Principles is instructions for the agent only.
Does Design Motion Principles access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Design Motion Principles safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Design Motion Principles use?
Design Motion Principles is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Design Motion Principles use?
About 1.7k tokens (SKILL.md is roughly 6.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 38k tokens, read only when the agent opens those files.
What are the alternatives to Design Motion Principles?
Skills that share tags, products or a category with Design Motion Principles: Lottie Animation Integration (freshtechbro/claudedesignskills, 1k stars), Motiscope Recreate (KumarSashank/motiscope, 122 stars), Recreate (KumarSashank/motiscope, 122 stars) and Animate (OneWave-AI/claude-skills, 336 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Design Motion Principles?
Dinil-Thilakarathne (a GitHub user) maintains it in Dinil-Thilakarathne/sona-ui, which has 118 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 7, 2026.
Source: Dinil-Thilakarathne/sona-ui on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.