Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add podo/design-agent-skills --skill interaction-design -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/interaction-design/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/interaction-design/

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.

interaction-design Seth Hobson The interaction-design skill helps design microinteractions, transitions, and feedback states. Use it when polishing a UI or building loading and gesture patterns. CX Codex +1 16,146installs interaction-design aj-geddes interaction-design — a skill for Claude Code, Cursor and Codex that helps design interfaces with animations, microinteractions and feedback. Triggers when designing user flows, transitions and loading states. CX Codex +1 511installs interaction-design secondsky interaction-design — a skill for designing interface feedback: loading states, errors, empty screens, animation timing and accessibility. Useful when you need to plan how UI behaves, not just how it looks. CX Codex +1 463installs interaction-reviewer ShuaiMXu interaction-reviewer is a Claude Code skill that reviews interaction flow and control behavior. It detects missing feedback, unnecessary steps, and unsafe UI state transitions. CX Codex +1 ★ 529repo stars micro-interaction-spec Owl-Listener micro-interaction-spec specifies one micro-interaction end to end: trigger, rules, feedback, loops and modes. Useful when a single interaction goes to engineering. CX Codex +1 2,700installs animation-micro-interaction-pack patricio0312rev animation-micro-interaction-pack — a set of reusable motion patterns for interfaces: hover effects, entrances and exits, gesture feedback. Useful when a UI feels static and you want it to move without hand-tuning timings. CX Codex +1 516installs design-interaction Rudolf S. design-interaction is a Claude Code subagent that designs navigation, user flows, and information architecture. Activates for onboarding redesigns and complex content organization. CX Codex ★ 587repo stars interaction-patterns-components hueyexe interaction-patterns-components guides the agent through picking and critiquing UI interaction patterns and reusable components: navigation, tables, modals, forms, states. CX Codex +1 622installs screenshot-interaction-analyzer davila7 screenshot-interaction-analyzer — a subagent that reads a UI screenshot and maps what can be clicked, where navigation leads and which states change. Useful when you have a screen image but no spec. CX Codex 414installs

From the same set108

The whole set →
design-brief The design-brief skill turns an I-Lang or plain-language visual brief into DESIGN.md and an HTML preview. Use it when the interface direction is still vague. CX Codex +1 211installs distinctive-frontend distinctive-frontend — a skill for Claude Code and other coding agents that generates interfaces in four themed styles instead of default AI aesthetics. Pick a theme by name and the component code follows that visual direction. CX Codex +1 633installs emilkowalski-skill emilkowalski-skill applies Emil Kowalski's design engineering rules: custom easing curves, animation decision flow, typography standards, and mobile interaction patterns. CX Codex +1 298installs apple-hig-skills The apple-hig-skills skill gives your agent Apple Human Interface Guidelines advice for iOS, macOS, visionOS, watchOS, and tvOS. Use it when designing or reviewing a platform-specific interface. CX Codex +1 286installs anthropics-skills anthropics-skills is a Claude Code skill that installs six official Anthropic skills for UI work, HTML artifacts, graphics, themes, brand guidelines and PowerPoint. CX Codex +1 280installs antvis-chart-skills antvis-chart-skills is a Claude Code skill for creating charts, diagrams, and infographics with AntV, including data visualization and turning text into diagrams. CX Codex +1 277installs figma-official-skills figma-official-skills is a Claude Code skill package that moves Figma designs into code, builds design-system libraries and links Figma components to repository components. CX Codex +1 271installs shadcn-ui Guides AI coding agents through searching, adding, and composing shadcn/ui components accurately. CX Codex +1 271installs

Project sponsors

Companies that keep this analytics open