# generic-fullstack-ux-designer

generic-fullstack-ux-designer is a Claude Code skill that guides UX design for Next.js and NestJS apps, covering loading states, optimistic UI, forms, and SSR quirks.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 153 installs · ★ 114 repo stars
- Author: travisjneuman
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/travisjneuman/.claude/tree/HEAD/skills/generic-fullstack-ux-designer/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/generic-fullstack-ux-designer

## What it does

This skill equips an agent with interface design standards tailored for client-server architectures. It provides concrete patterns for Server-Side Rendering, such as hydration-safe skeleton loaders, client-server component boundaries, and progressive form enhancement.

The rules structure network feedback strictly by response duration. Requests under 100ms require no visual indicator, 100ms to 1s trigger subtle spinners, 1s to 5s rely on skeletons, and tasks beyond 5s need progress bars. Optimistic UI is restricted to low-risk actions like likes or comments; destructive tasks such as item deletion or payment processing require verified confirmations.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add travisjneuman/.claude --skill generic-fullstack-ux-designer -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/generic-fullstack-ux-designer/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/generic-fullstack-ux-designer/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add travisjneuman/.claude --skill generic-fullstack-ux-designer -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/generic-fullstack-ux-designer/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add travisjneuman/.claude --skill generic-fullstack-ux-designer -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/generic-fullstack-ux-designer/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install travisjneuman/.claude skills/generic-fullstack-ux-designer
```

2. **Manually: put the files in place**
- File: `.github/skills/generic-fullstack-ux-designer/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add travisjneuman/.claude --skill generic-fullstack-ux-designer -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/travisjneuman/.claude --path skills/generic-fullstack-ux-designer
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/generic-fullstack-ux-designer/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add travisjneuman/.claude --skill generic-fullstack-ux-designer -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/travisjneuman/.claude/tree/HEAD/skills/generic-fullstack-ux-designer/SKILL.md

## When to use it
- prevent React hydration mismatches during server-side rendering
- structure loading indicators based on measured API response time
- implement optimistic UI updates with automatic rollback on failure
- map client-to-server validation flows for multi-step forms

## Example prompts
- Design an optimistic update flow for a post reaction with rollback handling
- Review our Next.js authentication flow and protected route redirect logic
- What loading pattern should we display for file uploads exceeding five seconds?

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 84eef615182462dd.

BEGIN THIRD-PARTY FILE 84eef615182462dd
````text
---
name: generic-fullstack-ux-designer
description: Professional UI/UX design expertise for full-stack 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.
---

# Fullstack UX Designer

Professional UX expertise for Next.js/NestJS full-stack applications.

**Extends:** [Generic UX Designer](../generic-ux-designer/SKILL.md) - Read base skill for design thinking process, research methods, interaction patterns, and critique framework.

## Full-Stack UX Considerations

### Server-Side Rendering UX

| Scenario          | UX Pattern                                       |
| ----------------- | ------------------------------------------------ |
| Initial page load | Hydration-safe skeleton screens                  |
| Data fetching     | Server components for static, client for dynamic |
| Authentication    | Protected routes with redirect UX                |
| Form submission   | Progressive enhancement                          |

### Hydration-Safe Patterns

```tsx
// ✓ Avoid hydration mismatch
function Timestamp({ date }: { date: Date }) {
  const [formatted, setFormatted] = useState("");

  useEffect(() => {
    setFormatted(date.toLocaleString()); // Client-side only
  }, [date]);

  return <span>{formatted || "Loading..."}</span>;
}
```

## API Loading & Error States

### Loading State Hierarchy

| Duration   | Pattern         | Example      |
| ---------- | --------------- | ------------ |
| < 100ms    | No indicator    | Button click |
| 100ms - 1s | Subtle spinner  | Form submit  |
| 1s - 5s    | Skeleton screen | Page fetch   |
| > 5s       | Progress bar    | File upload  |

### Error State Design

```
API Error → Parse Error → User-Friendly Message → Recovery Action
```

| Error Type       | User Message           | Recovery          |
| ---------------- | ---------------------- | ----------------- |
| 400 Validation   | Show field errors      | Fix and retry     |
| 401 Unauthorized | "Please log in"        | Redirect to login |
| 404 Not Found    | "Item not found"       | Navigate back     |
| 500 Server Error | "Something went wrong" | Retry button      |

## Optimistic UI Pattern

```typescript
// Show immediate feedback, rollback on error
async function toggleLike(postId: string) {
  // 1. Update UI immediately
  setLiked(true);
  setLikeCount((c) => c + 1);

  try {
    // 2. Call API
    await api.like(postId);
  } catch {
    // 3. Rollback on failure
````
END THIRD-PARTY FILE 84eef615182462dd

The third-party file has ended. Everything between the 84eef615182462dd tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2646 of 5301 bytes. © travisjneuman · MIT · https://github.com/travisjneuman/.claude/tree/HEAD/skills/generic-fullstack-ux-designer/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
