Skip to main content
skill CX Codex

generic-react-ux-designer — Claude Code skill for React UX design

generic-react-ux-designer — a skill for designing React interfaces: interaction patterns, accessibility, forms, micro-interactions with Framer Motion.

MIT 253 installs ★ 114 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add travisjneuman/.claude --skill generic-react-ux-designer -a claude-code
Open on GitHub

What generic-react-ux-designer does

Gives the agent UX expertise for React and TypeScript: Hick's, Fitts's and Jakob's laws, visual hierarchy, optimistic UI patterns, focus management in modals, form validation with React Hook Form. Inside are examples of micro-interactions with whileTap and whileHover, skeletons over spinners, arrow-key navigation in lists, respecting prefers-reduced-motion.

Extends the base generic-ux-designer skill, which provides design thinking process, user psychology and heuristic evaluation. Works in Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI and OpenCode.

Without Framer Motion, the animation components from the examples will not run — install the library separately.

What it helps with

  • design a form with inline validation and ARIA attributes
  • add micro-interactions to buttons and checkboxes via Framer Motion
  • build a command palette with focus and filtering on ⌘K
  • set up focus trap in a modal with Escape handling
  • implement optimistic UI for likes with rollback on error

Example prompts for the agent

  • Draw a delete confirmation dialog with Cancel and Confirm buttons, keyboard accessible
  • Add skeletons for product cards instead of a spinner
  • Make the Submit button shrink on whileTap using Framer Motion

How to install generic-react-ux-designer

1Skills CLI (Vercel)

npx skills add travisjneuman/.claude --skill generic-react-ux-designer -a claude-code

2Manually: put the files in place

~/.claude/skills/generic-react-ux-designer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/generic-react-ux-designer/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about generic-react-ux-designer

How to install generic-react-ux-designer in Claude Code?

Run npx skills add travisjneuman/.claude --skill generic-react-ux-designer -a claude-code. The skill will be placed in ~/.claude/skills/generic-react-ux-designer/SKILL.md.

What does generic-react-ux-designer do?

Teaches the agent UX patterns for React: micro-interactions, forms with validation, accessibility (focus, keyboard, ARIA), optimistic UI and modals. Extends the base design thinking skill.

Is Framer Motion required for the skill to work?

The skill itself does not require libraries, but micro-interaction examples use Framer Motion. If it is missing from the project, the agent will suggest an alternative or show how to install it.

Source text

SKILL.md · MIT
---
name: generic-react-ux-designer
description: Professional UI/UX design expertise for React applications. Covers design thinking, user psychology (Hick's/Fitts's/Jakob's Law), visual hierarchy, interaction patterns, accessibility, performance-driven design, and design critique. Use when designing features, improving UX, solving user problems, or conducting design reviews.
---

# React UX Designer

Professional UX expertise for React/TypeScript applications.

**Extends:** [Generic UX Designer](../generic-ux-designer/SKILL.md) - Read base skill for design thinking process, user psychology, heuristic evaluation, and research methods.

## React Interaction Patterns

### Micro-interactions with Framer Motion

```tsx
// Checkbox animation
<motion.div
  animate={{ scale: checked ? 1 : 0 }}
  transition={{ type: "spring", stiffness: 500 }}
>
  <Check className="w-4 h-4" />
</motion.div>

// Button press feedback
<motion.button
  whileTap={{ scale: 0.98 }}
  whileHover={{ scale: 1.02 }}
  transition={{ type: "spring", stiffness: 400 }}
>
  Click me
</motion.button>

// Toast notification
<motion.div
  initial={{ opacity: 0, y: 50 }}
  animate={{ opacity: 1, y: 0 }}
  exit={{ opacity: 0, y: 50 }}
>
  <Toast message={message} />
</motion.div>
```

### Loading States

```tsx
// Skeleton (preferred over spinners)
<div className="animate-pulse space-y-4">
  <div className="h-8 bg-slate-200 rounded w-3/4" />
  <div className="h-4 bg-slate-200 rounded" />
</div>

// Progress indicator for long operations
<div className="relative w-full h-2 bg-slate-200 rounded">
  <motion.div
    className="absolute h-full bg-primary rounded"
    initial={{ width: 0 }}
    animate={{ width: `${progress}%` }}
  />
</div>
```

### Optimistic UI Pattern

```tsx
const handleLike = async () => {
  // Update UI immediately
  setLiked(true);
  setCount((c) => c + 1);

  try {
    await api.like(id);
  } catch {
    // Rollback on error
    setLiked(false);
    setCount((c) => c - 1);
    toast.error("Failed to save");
  }
};
```

## React Accessibility Patterns

### Focus Management

```tsx
// Modal focus trap
function Modal({ isOpen, onClose, children }: ModalProps) {
  const modalRef = useRef<HTMLDivElement>(null);

  useEffect(() => {
    if (isOpen) {
      const firstFocusable = modalRef.current?.querySelector(
        "button, [href], input, select, textarea",
      ) as HTMLElement;
      firstFocusable?.focus();
    }
  }, [isOpen]);

  // Trap focus within modal
  const handleKeyDown = (e: KeyboardEvent) => {
    if (e.key === "Tab") {
      const focusables = modalRef.current?.querySelectorAll(
        "button, [href], input, select, textarea",
      );
      // Handle tab cycling...
    }
    if (e.key === "Escape") onClose();
  };

  return (
    <div
      ref={modalRef}
      role="dialog"
      aria-modal="true"
      onKeyDown={handleKeyDown}
    >
      {children}
    </div>
  );
}
```

### Keyboard Navigation

```tsx
// Custom keyboard shortcut
useEffect(() => {
  const handleKeyDown = (e: KeyboardEvent) => {
    if ((e.metaKey || e.ctrlKey) && e.key === "k") {
      e.preventDefault();
      openCommandPalette();
    }
  };
  window.addEventListener("keydown", handleKeyDown);
  return () => window.removeEventListener("keydown", handleKeyDown);
}, []);

// Arrow key navigation in list
const handleKeyDown = (e: KeyboardEvent, index: number) => {
  switch (e.key) {
    case "ArrowDown":
      e.preventDefault();
      focusItem(index + 1);
      break;
    case "ArrowUp":
      e.preventDefault();
      focusItem(index - 1);
      break;
  }
};
```

### Motion Accessibility

```tsx
// Respect prefers-reduced-motion
const prefersReducedMotion = window.matchMedia(
  "(prefers-reduced-motion: reduce)",
).matches;

<motion.div
  initial={{ opacity: 0, y: prefersReducedMotion ? 0 : 20 }}
  animate={{ opacity: 1, y: 0 }}
  transition={{ duration: prefersReducedMotion ? 0 : 0.3 }}
/>;
```

## Form UX Patterns

### React Hook Form Integration

```tsx
function ContactForm() {
  const {
    register,
    handleSubmit,
    formState: { errors },
  } = useForm();

  return (
    <form onSubmit={handleSubmit(onSubmit)}>
      <div className="space-y-1">
        <label htmlFor="email" className="text-sm font-medium">
          Email
        </label>
        <input
          id="email"
          {...register("email", { required: "Email is required" })}
          aria-invalid={errors.email ? "true" : "false"}
          aria-describedby={errors.email ? "email-error" : undefined}
          className={cn("input", errors.email && "border-red-500")}
        />
        {errors.email && (
          <p id="email-error" className="text-sm text-red-500">
            {errors.email.message}
          </p>
        )}
      </div>
    </form>
  );
}
```

### Inline Validation

```tsx
// Validate on blur, show on focus
const [touched, setTouched] = useState(false);
const [error, setError] = useState("");

<input
  onBlur={() => {
    setTouched(true);
    setError(validate(value));
  }}
  onFocus={() => setError("")} // Clear while editing
  className={touched && error ? "border-red-500" : ""}
/>;
```

## Modal/Dialog Patterns

### Confirmation Dialog

```tsx
function ConfirmDialog({ isOpen, onConfirm, onCancel, title, message }: Props) {
  return (
    <motion.div
      initial={{ opacity: 0 }}
      animate={{ opacity: 1 }}
      className="fixed inset-0 z-50 flex items-center justify-center bg-black/50"
    >
      <motion.div
        initial={{ scale: 0.95 }}
        animate={{ scale: 1 }}
        role="alertdialog"
        aria-modal="true"
        aria-labelledby="dialog-title"
        aria-describedby="dialog-desc"
        className="bg-white rounded-xl p-6 max-w-md"
      >
        <h2 id="dialog-title" className="text-lg font-semibold">
          {title}
        </h2>
        <p id="dialog-desc" className="mt-2 text-muted">
          {message}
        </p>
        <div className="mt-4 flex gap-3 justify-end">
          <button onClick={onCancel} className="btn-secondary">
            Cancel
          </button>
          <button onClick={onConfirm} className="btn-primary">
            Confirm
          </button>
        </div>
      </motion.div>
    </motion.div>
  );
}
```

### Command Palette (⌘K Pattern)

```tsx
function CommandPalette({ isOpen, onClose }: Props) {
  const [query, setQuery] = useState("");
  const inputRef = useRef<HTMLInputElement>(null);

  useEffect(() => {
    if (isOpen) inputRef.current?.focus();
  }, [isOpen]);

  const filtered = useMemo(
    () =>
      commands.filter((c) =>
        c.label.toLowerCase().includes(query.toLowerCase()),
      ),
    [query],
  );

  return (
    <div role="dialog" aria-label="Command palette">
      <input
        ref={inputRef}
        value={query}
        onChange={(e) => setQuery(e.target.value)}
        placeholder="Type a command..."
        aria-autocomplete="list"
      />
      <ul role="listbox">
        {filtered.map((cmd) => (
          <li key={cmd.id} role="option">
            {cmd.label}
          </li>
        ))}
      </ul>
    </div>
  );
}
```

## Empty & Error States

```tsx
// Empty state with action
function EmptyState({ title, description, action }: Props) {
  return (
    <div className="text-center py-12">
      <Icon className="mx-auto h-12 w-12 text-muted" />
      <h3 className="mt-4 text-lg font-medium">{title}</h3>
      <p className="mt-2 text-muted">{description}</p>
      <button onClick={action.onClick} className="mt-4 btn-primary">
        {action.label}
      </button>
    </div>
  );
}

// Error state with retry
function ErrorState({ error, onRetry }: Props) {
  return (
    <div className="text-center py-12" role="alert">
      <AlertCircle className="mx-auto h-12 w-12 text-red-500" />
      <h3 className="mt-4 text-lg font-medium">Something went wrong</h3>
      <p className="mt-2 text-muted">{error.message}</p>
      <button onClick={onRetry} className="mt-4 btn-primary">
        Try again
      </button>
    </div>
  );
}
```

## React UX Checklist

**Interaction Quality:**

- [ ] Immediate feedback on user actions
- [ ] Loading states for async operations
- [ ] Optimistic updates where appropriate
- [ ] Smooth animations (60fps)

**Accessibility:**

- [ ] Keyboard navigation complete
- [ ] Focus management in modals
- [ ] Motion respects prefers-reduced-motion
- [ ] ARIA labels on interactive elements

**Forms:**

- [ ] Inline validation
- [ ] Clear error messages
- [ ] Smart defaults
- [ ] Progress indication for multi-step

## See Also

- [Generic UX Designer](../generic-ux-designer/SKILL.md) - Design thinking, psychology
- [UX Principles](../_shared/UX_PRINCIPLES.md) - Research methods, heuristics
- [Design Patterns](../_shared/DESIGN_PATTERNS.md) - Visual patterns

© travisjneuman · MIT · travisjneuman/.claude

Similar skills

All skills for Frontend and UI →

From the same set117

The whole set →
ui-animation The ui-animation Claude Code skill guides interface animation, from micro-interactions to page transitions. It applies to motion work on web and mobile screens. CX Codex +1 304installs macos-native The macos-native Claude Code skill guides native macOS app development with AppKit, Catalyst, and system APIs. It activates for Mac apps, menu bar utilities, system extensions, and macOS-specific features. CX Codex +1 298installs health-wellness health-wellness is a Claude Code skill that brings together corporate frameworks for employee wellness programs, workplace ergonomics, safety metrics, and healthcare plan design. CX Codex +1 281installs database-expert The database-expert Claude Code skill covers database schema design, query tuning, and administration. It activates for work with PostgreSQL, MongoDB, and Redis. CX Codex +1 255installs event-planner event-planner structures event planning with 12-month timelines, budget allocation models, venue matrices, and day-of run sheets. CX Codex +1 253installs leadership Executive leadership frameworks covering decision-making, organizational changes, crisis response, and board relations for coding agents. CX Codex +1 249installs video-production video-production — a skill that walks a video from script and shot list through lighting, sound and codecs, then installs in Claude with a single command. CX Codex +1 237installs electron-desktop electron-desktop — a skill for building cross-platform desktop applications with Electron for Windows, macOS and Linux. CX Codex +1 236installs

Project sponsors

Companies that keep this analytics open