interaction-design · podo — Claude Code skill: what it does, how to install
Hands the agent a working reference for interaction design: flows, component states, micro-interactions and handoff notes.
MIT 284 installs ★ 35 updated 2026-10-21
npx skills add podo/design-agent-skills --skill interaction-design -a claude-codeWhat interaction-design does
Point the agent at this skill before you spec a screen and it works from named interaction-design material instead of improvising. It covers task and user flows, every state a component can sit in (default, hover, focus, active, disabled, loading, error, success, empty, skeleton), micro-interactions, affordances, feedback, response-time limits and handoff annotations.
The install ships a reference/ folder holding the principle notes, the response-time thresholds and the patterns-and-flows write-ups the skill leans on. Those thresholds are 100 ms, 1 s and 10 s, and the same notes use them to argue for a progress indicator or an optimistic UI.
What it won't do: open a browser, time an animation, or run a WCAG audit. It names neo-user-journey, gsap-skills, framer-motion-skills and wcag-ai-skill for those jobs, so on a pure accessibility pass you'd be reaching for the wrong skill.
What it helps with
- spell out every state of a button before handoff
- map a task flow with its branches and dead ends
- pick a progress indicator that fits the response-time budget
- describe a micro-interaction from trigger to loop
- audit a screen against established design principles
Example prompts for the agent
- Map the checkout flow step by step and spec the states of the pay button: hover, focus, loading, error, disabled.
- Write the interaction spec for the address picker, with handoff annotations for the developer.
- Audit the settings screen and list where feedback and affordances are missing.
How to install interaction-design
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill interaction-design -a claude-code2Manually: put the files in place
~/.claude/skills/interaction-design/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/interaction-design/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill interaction-design -a codex2Manually: put the files in place
.agents/skills/interaction-design/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill interaction-design -a cursor2Manually: put the files in place
.cursor/skills/interaction-design/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/interaction-design2Manually: put the files in place
.github/skills/interaction-design/SKILL.md1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill interaction-design -a gemini-cli2Platform CLI
gemini skills install https://github.com/podo/design-agent-skills --path skills/interaction-designManually: put the files in place
.devin/skills/interaction-design/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill interaction-design -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 interaction-design
How do I install interaction-design in Claude Code?
Run npx skills add podo/design-agent-skills --skill interaction-design -a claude-code. The skill file then sits at ~/.claude/skills/interaction-design/SKILL.md.
What does interaction-design do?
It gives the agent a reference for interaction design: task flows, component states, micro-interactions, affordances and the annotation format for handoff. The grounding is Norman's principles and Tognazzini's first principles.
Which platforms does the skill support?
Claude, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode. The -a flag in npx skills add selects the platform, and Copilot has its own gh skill install command.
Source text
SKILL.md · MIT
--- name: interaction-design description: | Interaction design (IxD) principles and frameworks for digital product work. Covers interaction flows, component state design (hover/focus/error/loading/empty), micro-interactions, affordances, feedback mechanisms, mental models, task flows, gesture design, response time guidelines, and handoff annotations. Grounded in Norman's design principles and Tognazzini's first principles of interaction design. triggers: - "interaction design" - "interaction flow" - "component states" - "micro-interaction" - "affordance" - "interaction spec" - "interaction-design" das: type: skill category: interaction-polish upstream: "https://github.com/rastian/interaction-design-skills" upstream_path: "SKILL.md" version: latest --- # interaction-design > Catalogue stub — full skill: [rastian/interaction-design-skills](https://github.com/rastian/interaction-design-skills) <!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block --> ## Decision tree 1. **Is the full skill already installed?** - Global: `f=~/.agents/skills/interaction-design/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - Project: `f=.agents/skills/interaction-design/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - `installed` → the skill is installed as `interaction-design`, invoke it and proceed - `pointer` → go to step 2 2. **Detect scope, then install:** ```bash [ -e ~/.agents/skills/interaction-design ] && echo "global" || echo "project" ``` **Global:** ```bash npx skills add rastian/interaction-design-skills --skill interaction-design -g -y ``` **Project:** ```bash npx skills add rastian/interaction-design-skills --skill interaction-design -y ``` > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation. **Heads-up** - **License:** no LICENSE file in the repo <!-- das:install:end --> ## Invoke after install - Skill name: `interaction-design` - Trigger phrases: "interaction design", "interaction flow", "component states", "micro-interaction", "affordance", "interaction spec" ## What it does A practitioner's guide to interaction design — from foundational principles to practical state design, flow specification, and interaction review: - **Interaction flows** — task flows, user flows, navigation patterns, decision trees - **State design** — the full set of component states: default, hover, focus, active, disabled, loading, error, success, empty, skeleton - **Micro-interactions** — trigger → rules → feedback → loops model; timing and easing guidelines - **Affordances** — signifiers, feedback, constraints, mapping, consistency, discoverability - **IxD principles** — Norman's principles (Design of Everyday Things) and Tognazzini's First Principles of Interaction Design - **Response time** — 100ms/1s/10s thresholds, progress indicators, optimistic UI - **Interaction specs** — handoff annotation format, interaction specification documents - **Interaction audit** — review checklist against established principles The install includes a `reference/` folder with the principles, response-time and patterns-and-flows notes the skill points to. ## When NOT to use - UX journey mapping + Playwright testing → use `neo-user-journey` - Animation and motion timing → use `gsap-skills` or `framer-motion-skills` - WCAG accessibility audit → use `wcag-ai-skill` - Full UX strategy → use `ux-designer-skill`
© podo · MIT · podo/design-agent-skills
Similar skills
All skills for Design →interaction-design by other authors comes first.