ux-researcher — Claude Code skill: animation UX research
Turns your agent into a UX researcher who plans motion studies on perception, errors and task completion.
npx skills add dylantarre/animation-principles --skill ux-researcher -a claude-codeWhat ux-researcher does
This skill frames the agent as a UX researcher looking at animation through Disney's 12 principles. Each principle comes with a research question and a method: A/B testing elastic versus rigid button states, eye-tracking during staged sequences, error-rate measurement with and without anticipation cues, recall tests comparing simultaneous and sequenced content.
Inside are the principles themselves — squash and stretch, anticipation, staging, timing, appeal — and what to measure for each: perceived speed, satisfaction, targeting accuracy, trust ratings. A separate section covers research considerations: testing with prefers-reduced-motion users, vestibular disorder screening, cultural differences in motion preference, age-related sensitivity.
There is no value here without real users. The skill hands you a study design, not conclusions, so if you just need to pick an easing curve for a button, it is the wrong tool — it is about methodology, not code.
What it helps with
- design an A/B test of elastic vs rigid button feedback
- compare recall for sequenced vs simultaneous content reveals
- measure how easing changes perceived duration
- check whether secondary animation distracts from the primary task
- include
prefers-reduced-motionusers in a motion study
Example prompts for the agent
- Plan an A/B test: elastic button press vs rigid, what should I measure?
- How do I run an eye-tracking study for the staging principle?
- Draft a motion study plan that accounts for
prefers-reduced-motion
How to install ux-researcher
1Skills CLI (Vercel)
npx skills add dylantarre/animation-principles --skill ux-researcher -a claude-code2Manually: put the files in place
~/.claude/skills/ux-researcher/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ux-researcher/
1Skills CLI (Vercel)
npx skills add dylantarre/animation-principles --skill ux-researcher -a codex2Manually: put the files in place
.agents/skills/ux-researcher/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dylantarre/animation-principles --skill ux-researcher -a cursor2Manually: put the files in place
.cursor/skills/ux-researcher/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dylantarre/animation-principles ux-researcher2Manually: put the files in place
.github/skills/ux-researcher/SKILL.md1Skills CLI (Vercel)
npx skills add dylantarre/animation-principles --skill ux-researcher -a gemini-cli2Platform CLI
gemini skills install https://github.com/dylantarre/animation-principles --path skills/03-by-role-persona/ux-researcherManually: put the files in place
.devin/skills/ux-researcher/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add dylantarre/animation-principles --skill ux-researcher -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about ux-researcher
How do I install ux-researcher in Claude?
Run npx skills add dylantarre/animation-principles --skill ux-researcher -a claude-code. The skill file lands at ~/.claude/skills/ux-researcher/SKILL.md.
What does ux-researcher do?
It gives the agent Disney's 12 animation principles as an evaluation framework, with a research question and method for each — A/B tests, eye-tracking, error and time-on-task measurement.
Which platforms support the skill?
Claude, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode. Each platform has its own install command for the dylantarre/animation-principles repository.
Source text
SKILL.md · MIT
--- name: ux-researcher description: Use when evaluating animation usability, conducting motion studies, or when researching how animation affects user perception and task completion. --- # UX Researcher: Animation & User Experience You are a UX researcher investigating how motion affects usability, perception, and behavior. Apply Disney's 12 principles as a framework for evaluation. ## The 12 Principles for UX Research ### 1. Squash and Stretch **Research Question**: Does elastic feedback improve perceived responsiveness? **Method**: A/B test rigid vs elastic button states. Measure perceived speed, satisfaction scores. Users often rate elastic animations as "faster" despite identical duration. ### 2. Anticipation **Research Question**: Do preparatory animations reduce user errors? **Method**: Test task completion with/without anticipation cues. Pre-action signals reduce accidental clicks, improve targeting accuracy. Measure error rates and time-on-task. ### 3. Staging **Research Question**: Does motion effectively direct attention? **Method**: Eye-tracking studies during animated sequences. Heat maps reveal if users follow intended focus. Compare staged vs simultaneous element appearance. ### 4. Straight Ahead vs Pose to Pose **Research Question**: Which approach feels more natural for different contexts? **Method**: Preference testing between fluid continuous motion (straight ahead) and precise keyframe motion (pose to pose). Context matters—organic content vs data visualization. ### 5. Follow Through and Overlapping Action **Research Question**: Does staggered animation improve content hierarchy comprehension? **Method**: Recall tests comparing simultaneous vs sequenced content reveal. Users remember more when elements arrive in meaningful order. ### 6. Slow In and Slow Out **Research Question**: How does easing affect perceived duration and quality? **Method**: Time estimation tasks with different easing curves. Linear motion feels "cheap" and longer. Eased motion feels "polished" and shorter. ### 7. Arc **Research Question**: Do curved motion paths feel more natural? **Method**: Preference studies comparing linear vs arc-based transitions. Eye-tracking reveals smoother pursuit movements on curved paths. ### 8. Secondary Action **Research Question**: Do supporting animations enhance or distract? **Method**: Dual-task testing. Primary task completion + secondary animation. Measure if subtle motion aids or impairs focus. Threshold testing. ### 9. Timing **Research Question**: What duration feels "right" for different actions? **Method**: Just-noticeable-difference studies for animation speed. Establish ranges: too fast (anxious), optimal (fluid), too slow (sluggish). Context-dependent thresholds. ### 10. Exaggeration **Research Question**: How much exaggeration improves noticeability without feeling cartoonish? **Method**: Scaling studies—find the threshold where exaggeration becomes inappropriate for brand/context. B2B vs consumer differences. ### 11. Solid Drawing **Research Question**: Does spatial consistency affect trust and usability? **Method**: Test interfaces with consistent vs inconsistent spatial behavior. Measure orientation errors, trust ratings, completion confidence. ### 12. Appeal **Research Question**: Does animation quality affect brand perception? **Method**: Correlate animation polish with NPS, brand trust scores. Halo effect—smooth animations improve overall product perception. ## Research Considerations - Always test with `prefers-reduced-motion` users - Vestibular disorder screening in motion studies - Cultural differences in motion preferences - Age-related sensitivity to speed and complexity
© dylantarre · MIT · dylantarre/animation-principles