К основному содержанию
скилл CX Codex

generic-fullstack-ux-designer — скилл для Claude Code

Скилл generic-fullstack-ux-designer для Claude Code задаёт UX-правила для приложений на Next.js и NestJS: состояния загрузки, формы, ошибки и SSR.

MIT 153 установок ★ 114 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add travisjneuman/.claude --skill generic-fullstack-ux-designer -a claude-code
Открыть на GitHub

Что делает generic-fullstack-ux-designer

Скилл передаёт ИИ-агенту систему правил для проектирования интерфейсов на стыке клиента и сервера. Внутри собраны готовые шаблоны для Server-Side Rendering: защита от расхождений гидратации, разделение серверных и клиентских компонентов и прогрессивное улучшение форм.

Особое внимание уделено задержкам сети. Для откликов быстрее 100 мс индикатор не нужен, от 100 мс до 1 с используется спиннер, до 5 с — скелетон, а свыше 5 с — прогресс-бар. Скилл прямо запрещает оптимистичный UI для деструктивных действий вроде удаления данных или проведения платежей: для них обязательна серверная верификация.

Какие задачи решает

  • устранить расхождения гидратации в React и Next.js
  • выстроить иерархию состояний загрузки по времени ответа API
  • внедрить оптимистичные обновления интерфейса с откатом при сбое
  • спроектировать валидацию и шаги многостраничных форм

Примеры запросов агенту

  • Спроектируй сценарий добавления лайка с оптимистичным UI и откатом при ошибке сети
  • Как оформить форму входа и редирект для защищённого роута в Next.js?
  • Подбери подходящий индикатор загрузки для API с длительностью ответа от двух до шести секунд

Как установить generic-fullstack-ux-designer

1Через Skills CLI (Vercel)

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

2Вручную: положить файлы

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

Папка скилла целиком; для одного проекта — .claude/skills/generic-fullstack-ux-designer/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о generic-fullstack-ux-designer

Как установить generic-fullstack-ux-designer в Claude Code?

Выполните в терминале команду npx skills add travisjneuman/.claude --skill generic-fullstack-ux-designer -a claude-code.

Что делает generic-fullstack-ux-designer?

Встраивает в агента правила проектирования фулстек-интерфейсов, включая паттерны SSR, иерархию загрузки и восстановление после ошибок API.

Когда скилл запрещает использовать оптимистичный UI?

При деструктивных операциях вроде удаления записей и при проведении платежей. В таких сценариях интерфейс обязан дождаться подтверждения сервера.

Исходный текст

SKILL.md · MIT
---
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
    setLiked(false);
    setLikeCount((c) => c - 1);
    showToast("Failed to like");
  }
}
```

### When to Use Optimistic UI

| Action        | Optimistic? | Why                        |
| ------------- | ----------- | -------------------------- |
| Like/favorite | Yes         | Low risk, common action    |
| Add comment   | Yes         | Can show pending state     |
| Delete item   | No          | Destructive, needs confirm |
| Payment       | No          | Critical, must verify      |
| Form submit   | Maybe       | Depends on complexity      |

## Form Submission UX

### Client → Server Flow

```
User Input → Client Validation → Submit → Server Validation → Response
     ↓              ↓              ↓              ↓              ↓
  Feedback    Inline errors   Loading...   Field errors    Success/Error
```

### Multi-Step Forms

```tsx
// Show progress and allow back navigation
<FormStepper
  steps={["Details", "Payment", "Confirm"]}
  currentStep={step}
  onBack={() => setStep((s) => s - 1)}
/>
```

## Authentication UX

### Login Flow Patterns

| State         | UX                           |
| ------------- | ---------------------------- |
| Loading auth  | Full-page skeleton           |
| Not logged in | Show login form              |
| Logging in    | Disable form, show spinner   |
| Success       | Redirect with toast          |
| Error         | Inline error, keep form data |

### Protected Route Pattern

```tsx
// Redirect unauthenticated users
if (!user && !loading) {
  return <Navigate to="/login" state={{ from: location }} />;
}
```

## Real-Time Updates

| Pattern   | Use Case                              |
| --------- | ------------------------------------- |
| Polling   | Low-frequency updates (notifications) |
| WebSocket | Chat, live collaboration              |
| SSE       | One-way server updates                |

### Presence Indicators

- Online status dots
- "User is typing..." indicators
- Collaborative cursors

## Full-Stack Design Critique

| Aspect           | Questions                        |
| ---------------- | -------------------------------- |
| Loading states   | What shows during API calls?     |
| Error recovery   | Can users recover from errors?   |
| Offline behavior | What happens without network?    |
| Auth transitions | Smooth login/logout experience?  |
| Data freshness   | Is stale data clearly indicated? |

## See Also

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

© travisjneuman · MIT · travisjneuman/.claude

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
senior-fullstack borghei Скилл senior-fullstack для Claude Code разворачивает каркасы фулстек-проектов и проводит статический аудит качества кодовой базы. Запускается при старте нового веб-приложения или перед сдачей кода на ревью. CX Codex +1 322установок project-scaffolder patricio0312rev Скилл project-scaffolder разворачивает стартовые репозитории под популярные фреймворки с настроенным линтингом, тестовым эндпоинтом и документацией по запуску. CX Codex +1 287установок web-rules pproenca Скилл web-rules задаёт 34 строгих правила вёрстки и UX для связки React 19, Next.js 16 и Tailwind CSS 4. Помогает строить доступные интерфейсы и проверять код на регрессии дизайна. CX Codex +1 173установок next vercel-labs Превращает JSON-спецификации в приложения Next.js с маршрутами, страницами и серверным рендерингом. Включается при работе с @json-render/next и генерации многостраничных приложений из JSON. CX Codex +1 8 600установок nextjs-typescript-tailwindcss-supabase Mindrally Скилл nextjs-typescript-tailwindcss-supabase задаёт агенту правила для Next.js 14, TypeScript, TailwindCSS и Supabase: серверные компоненты, обработка ошибок, читаемый код. CX Codex +1 1 400установок vinext-vite-nextjs reason-machines Скилл vinext-vite-nextjs помогает перевести проект с Next.js на Vite и подготовить сборку для Cloudflare Workers. Поддерживает Pages Router и App Router. CX Codex +1 1 400установок

Из того же набора117

Весь набор →
seo-analytics-auditor Скилл seo-analytics-auditor для проверки SEO-разметки, структурированных данных и Core Web Vitals. Разбирает метатеги, robots.txt, sitemap.xml и вёрстку аналитических скриптов GA4 и Cloudflare. CX Codex +1 156установок financial-scenario-planner Скилл financial-scenario-planner для Claude Code стресс-тестирует финансовый план по трём сценариям, строит таблицы чувствительности, рассчитывает точку безубыточности и runway. Проверяет допущения модели. CX Codex +1 156установок product-management Скилл product-management даёт агенту шаблоны и метрики для продуктовой работы: расчёт скоринга RICE, структуру OKR, опрос на PMF и дизайн гипотез. CX Codex +1 153установок agent-teams Учит Claude собирать команды агентов: когда они уместны, сколько участников брать и как писать промпты запуска. Работает только при включённых Agent Teams. CX Codex +1 153установок fundraising-analyzer Скилл fundraising-analyzer помогает разбирать фандрайзинг: сегментировать доноров, считать ROI кампаний и отслеживать удержание. Нужен при оценке сборов и планировании кампаний. CX Codex +1 153установок microservices-architecture Скилл microservices-architecture для Claude Code помогает проектировать микросервисные системы, делить монолит и выбирать способы связи между сервисами. Активируется при обсуждении распределённой архитектуры. CX Codex +1 153установок debug-systematic Скилл debug-systematic для Claude Code ведёт агента через четыре фазы отладки: воспроизведение, локализацию, поиск причины и проверку исправления. Разбирает сложные и плавающие ошибки. CX Codex +1 152установок mobile-cicd Скилл mobile-cicd настраивает сборку, подпись кода и публикацию мобильных приложений для iOS и Android через Fastlane, GitHub Actions и EAS Build. CX Codex +1 152установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой