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

nextjs-app-router-expert — скилл для Claude Code: настройка

Скилл nextjs-app-router-expert помогает проектировать и отлаживать приложения на Next.js 14/15 с App Router. Пригодится при настройке маршрутов, Server Actions и загрузки данных.

MIT 176 установок ★ 274 обновлён 2026-10-30

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add curiositech/some_claude_skills --skill nextjs-app-router-expert -a claude-code
Открыть на GitHub

Что делает nextjs-app-router-expert

Скилл разбирает файловую маршрутизацию в app/, включая динамические, параллельные и перехватывающие маршруты, группы маршрутов и границы загрузки и ошибок. Он помогает распределять работу между Server и Client Components, настраивать потоковую передачу через Suspense и выбирать стратегию кэширования для fetch().

Для изменений данных скилл рассматривает Server Actions: валидацию, обработку ошибок, обновление кэша и перенаправление. Также он охватывает middleware для авторизации и редиректов, статическую генерацию и оптимизацию изображений, шрифтов и разделения кода. Описанные практики относятся к Next.js 14/15, поэтому для другой версии их нужно сверить с проектом.

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

  • спроектировать динамические и параллельные маршруты в app/
  • разделить Server и Client Components
  • настроить кэширование и повторную валидацию данных
  • добавить Server Action для отправки формы
  • разобраться с ошибкой гидратации или middleware

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

  • Спроектируй параллельный маршрут для модального окна с фотографией в моём приложении Next.js.
  • Проверь, где в этой странице нужны Server и Client Components, и предложи стратегию кэширования fetch().
  • Добавь Server Action для формы: проверь поля, обнови кэш и перенаправь после отправки.

Как установить nextjs-app-router-expert

1Через Skills CLI (Vercel)

npx skills add curiositech/some_claude_skills --skill nextjs-app-router-expert -a claude-code

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

~/.claude/skills/nextjs-app-router-expert/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/nextjs-app-router-expert/

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

Вопросы о nextjs-app-router-expert

Как установить nextjs-app-router-expert в Claude Code?

Выполните npx skills add curiositech/some_claude_skills --skill nextjs-app-router-expert -a claude-code. Файл скилла находится по пути ~/.claude/skills/nextjs-app-router-expert/SKILL.md.

Что делает nextjs-app-router-expert?

Помогает работать с архитектурой Next.js App Router: маршрутами, Server и Client Components, загрузкой данных, кэшированием и Server Actions.

Для каких версий Next.js предназначен скилл?

Скилл описывает App Router в Next.js 14/15. В нём также рассматриваются middleware, потоковая передача через Suspense и статическая генерация.

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

SKILL.md · MIT
---
name: nextjs-app-router-expert
description: Expert in Next.js 14/15 App Router architecture, React Server Components (RSC), Server Actions, and modern full-stack React development. Specializes in routing patterns, data fetching strategies,
  caching, streaming, and deployment optimization.
version: 1.0.0
metadata:
  category: frontend
  tags:
  - nextjs
  - react
  - app-router
  - rsc
  - server-components
  - full-stack
  pairs-with:
  - skill: react-performance-optimizer
    reason: RSC and streaming SSR in App Router require React-specific performance optimization
  - skill: vercel-deployment
    reason: Vercel is the primary deployment platform optimized for Next.js App Router features
  - skill: fullstack-debugger
    reason: App Router debugging spans server components, client hydration, and API routes
  - skill: typescript-advanced-patterns
    reason: App Router server/client component types benefit from advanced TypeScript generics
---

# Next.js App Router Expert

## Overview

Expert in Next.js 14/15 App Router architecture, React Server Components (RSC), Server Actions, and modern full-stack React development. Specializes in routing patterns, data fetching strategies, caching, streaming, and deployment optimization.

## When to Use

- Starting a new Next.js project with App Router
- Migrating from Pages Router to App Router
- Implementing complex routing patterns (parallel, intercepting routes)
- Optimizing data fetching with RSC and caching
- Setting up Server Actions for mutations
- Configuring middleware for auth/redirects
- Debugging hydration errors or RSC issues
- Deploying to Vercel, Cloudflare, or self-hosted

## Capabilities

### Routing Architecture
- File-based routing with `app/` directory
- Dynamic routes (`[slug]`, `[...catchAll]`, `[[...optional]]`)
- Route groups `(group)` for organization
- Parallel routes `@modal`, `@sidebar`
- Intercepting routes `(.)`, `(..)`, `(..)(..)`
- Loading and error boundaries per route segment

### React Server Components
- Server vs Client component boundaries
- `'use client'` directive placement
- Composition patterns (server wrapping client)
- Streaming with Suspense boundaries
- Progressive rendering strategies

### Data Fetching
- `fetch()` with automatic deduplication
- Caching strategies (`force-cache`, `no-store`, `revalidate`)
- `generateStaticParams()` for static generation
- Incremental Static Regeneration (ISR)
- On-demand revalidation with `revalidatePath()` / `revalidateTag()`

### Server Actions
- Form mutations with `'use server'`
- Optimistic updates with `useOptimistic`
- Progressive enhancement (works without JS)
- Error handling and validation
- Redirect after mutation

### Middleware & Edge
- `middleware.ts` for auth, redirects, rewrites
- Edge Runtime vs Node.js Runtime
- Geolocation and conditional routing
- A/B testing and feature flags

### Performance Optimization
- Image optimization with `next/image`
- Font optimization with `next/font`
- Script loading strategies
- Bundle analysis and code splitting
- Partial prerendering (PPR)

## Dependencies

Works well with:
- `react-performance-optimizer` - React-specific performance patterns
- `vercel-deployment` - Vercel deployment configuration
- `cloudflare-worker-dev` - Edge deployment patterns
- `postgresql-optimization` - Database queries for RSC

## Examples

### Basic Route Structure
```
app/
├── layout.tsx          # Root layout (required)
├── page.tsx            # Home page (/)
├── loading.tsx         # Loading UI
├── error.tsx           # Error boundary
├── not-found.tsx       # 404 page
├── blog/
│   ├── page.tsx        # /blog
│   └── [slug]/
│       ├── page.tsx    # /blog/:slug
│       └── loading.tsx # Per-route loading
└── (auth)/             # Route group (no URL impact)
    ├── login/
    │   └── page.tsx    # /login
    └── register/
        └── page.tsx    # /register
```

### Server Component with Data Fetching
```typescript
// app/posts/page.tsx
import { Suspense } from 'react';

async function getPosts() {
  const res = await fetch('https://api.example.com/posts', {
    next: { revalidate: 3600 }, // ISR: revalidate every hour
  });
  return res.json();
}

export default async function PostsPage() {
  const posts = await getPosts();

  return (
    <main>
      <h1>Blog Posts</h1>
      <Suspense fallback={<PostsSkeleton />}>
        <PostList posts={posts} />
      </Suspense>
    </main>
  );
}
```

### Server Action Form
```typescript
// app/contact/page.tsx
import { redirect } from 'next/navigation';
import { revalidatePath } from 'next/cache';

async function submitContact(formData: FormData) {
  'use server';

  const email = formData.get('email') as string;
  const message = formData.get('message') as string;

  // Validate
  if (!email || !message) {
    throw new Error('Email and message required');
  }

  // Save to database
  await db.contacts.create({ email, message });

  // Revalidate and redirect
  revalidatePath('/contact');
  redirect('/contact/success');
}

export default function ContactPage() {
  return (
    <form action={submitContact}>
      <input name="email" type="email" required />
      <textarea name="message" required />
      <button type="submit">Send</button>
    </form>
  );
}
```

### Parallel Routes (Modal Pattern)
```
app/
├── layout.tsx
├── page.tsx
├── @modal/
│   ├── default.tsx     # Empty state when no modal
│   └── (.)photo/[id]/
│       └── page.tsx    # Intercept /photo/[id] as modal
└── photo/[id]/
    └── page.tsx        # Full page when direct navigation
```

```typescript
// app/layout.tsx
export default function Layout({
  children,
  modal,
}: {
  children: React.ReactNode;
  modal: React.ReactNode;
}) {
  return (
    <>
      {children}
      {modal}
    </>
  );
}
```

### Middleware for Auth
```typescript
// middleware.ts
import { NextResponse } from 'next/server';
import type { NextRequest } from 'next/server';

export function middleware(request: NextRequest) {
  const token = request.cookies.get('auth-token');
  const isAuthPage = request.nextUrl.pathname.startsWith('/login');
  const isProtectedPage = request.nextUrl.pathname.startsWith('/dashboard');

  // Redirect authenticated users away from login
  if (isAuthPage && token) {
    return NextResponse.redirect(new URL('/dashboard', request.url));
  }

  // Redirect unauthenticated users to login
  if (isProtectedPage && !token) {
    return NextResponse.redirect(new URL('/login', request.url));
  }

  return NextResponse.next();
}

export const config = {
  matcher: ['/dashboard/:path*', '/login'],
};
```

### Static Generation with Dynamic Params
```typescript
// app/blog/[slug]/page.tsx
import { notFound } from 'next/navigation';

export async function generateStaticParams() {
  const posts = await fetch('https://api.example.com/posts').then(r => r.json());

  return posts.map((post: { slug: string }) => ({
    slug: post.slug,
  }));
}

export async function generateMetadata({ params }: { params: { slug: string } }) {
  const post = await getPost(params.slug);

  return {
    title: post?.title ?? 'Post Not Found',
    description: post?.excerpt,
  };
}

export default async function PostPage({ params }: { params: { slug: string } }) {
  const post = await getPost(params.slug);

  if (!post) {
    notFound();
  }

  return (
    <article>
      <h1>{post.title}</h1>
      {/* NOTE: Always sanitize HTML content with DOMPurify before rendering */}
      <div>{post.content}</div>
    </article>
  );
}
```

### Streaming with Suspense
```typescript
// app/dashboard/page.tsx
import { Suspense } from 'react';

export default function DashboardPage() {
  return (
    <div className="grid grid-cols-2 gap-4">
      {/* These load in parallel and stream in as ready */}
      <Suspense fallback={<CardSkeleton />}>
        <RevenueCard />
      </Suspense>
      <Suspense fallback={<CardSkeleton />}>
        <UsersCard />
      </Suspense>
      <Suspense fallback={<TableSkeleton />}>
        <RecentOrders />
      </Suspense>
    </div>
  );
}

// Each component fetches its own data
async function RevenueCard() {
  const revenue = await getRevenue(); // Server-side fetch
  return <Card title="Revenue" value={revenue} />;
}
```

## Best Practices

1. **Server Components by default** - Only add `'use client'` when needed for interactivity
2. **Colocate data fetching** - Fetch data in the component that needs it
3. **Use Suspense boundaries** - Wrap async components for streaming
4. **Leverage caching** - Use `revalidate` and tags for efficient caching
5. **Progressive enhancement** - Server Actions work without JavaScript
6. **Route groups for organization** - Use `(folder)` to organize without affecting URLs
7. **Error boundaries per segment** - Add `error.tsx` to critical routes
8. **Metadata API** - Use `generateMetadata` for dynamic SEO
9. **Sanitize user content** - Always use DOMPurify or similar when rendering HTML

## Common Pitfalls

- **Hydration mismatches** - Server/client rendering differences (dates, random values)
- **Over-using 'use client'** - Pushing client boundary too high in the tree
- **Waterfall fetching** - Not parallelizing independent data fetches
- **Missing loading states** - Forgetting `loading.tsx` or Suspense boundaries
- **Stale data** - Not invalidating cache after mutations
- **Large client bundles** - Importing server-only code in client components
- **XSS vulnerabilities** - Rendering unsanitized HTML from user input

© curiositech · MIT · curiositech/some_claude_skills

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

Все скиллы по теме «Фронтенд и UI» →
nextjs-app-router-patterns Seth Hobson Скилл nextjs-app-router-patterns помогает строить приложения на Next.js App Router: выбирать режим рендеринга, организовывать маршруты и получать данные. Подойдёт при миграции с Pages Router или работе с Server Components. CX Codex +1 32 529установок nextjs-app-architecture aurorascharff Скилл nextjs-app-architecture задаёт единую архитектуру App Router в Next.js 16: страницы только компонуют, данные читают фичи. Пригодится при старте проекта и при разборе чужого кода. CX Codex +1 540установок app-router davepoon Скилл для создания маршрутов, лейаутов, состояний загрузки и границ ошибок в Next.js App Router. Помогает агенту правильно организовать файловую структуру проекта. CX Codex +1 153установок nextjs-development manutej Скилл nextjs-development для Claude Code задаёт правила разработки на Next.js в каталоге app: серверные компоненты, кэширование и маршруты. CX Codex +1 475установок nextjs-app-router giuseppe-trisciuoglio Скилл nextjs-app-router для Claude Code помогает создавать приложения на Next.js 16+ с App Router. Подключается при работе с серверными компонентами, формами, API-маршрутами и кэшированием. CX Codex +1 4 100установок nextjs-app-router-fundamentals wsimmonds Скилл nextjs-app-router-fundamentals ведёт агента по Next.js App Router: перенос с Pages Router, вложенные layout, метаданные, динамические маршруты. Пригодится при переходе на app/. CX Codex +1 2 200установок

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

Весь набор →
pet-memorial-creator Скилл pet-memorial-creator помогает справиться с утратой питомца, написать памятный текст и подобрать идеи для мемориала — от фотокниги до церемонии. CX Codex +1 179установок munger-worldly-wisdom Скилл munger-worldly-wisdom для принятия решений через ментальные модели из психологии, экономики и математики. Помогает отсеивать когнитивные искажения и находить возможности с высокой убеждённостью. CX Codex +1 178установок clinical-diagnostic-reasoning Скилл clinical-diagnostic-reasoning помогает находить когнитивные искажения во врачебных решениях, проверять диагнозы на предвзятость и разбирать клинические ошибки. Пригодится при составлении плана обследования и лечения. CX Codex +1 178установок event-detection-temporal-intelligence-expert Скилл event-detection-temporal-intelligence-expert группирует фотоархивы по событиям через алгоритм ST-DBSCAN с учётом времени и GPS. Находит важные моменты жизни и подбирает снимки для коллажей. CX Codex +1 178установок windows-95-web-designer Скилл windows-95-web-designer стилизует современные веб-приложения под интерфейс Windows 95 с характерным синим градиентом заголовков, 3D-фасками и кнопкой «Пуск». Переносит ретро-эстетику на чат-ботов и мобильные экраны. CX Codex +1 176установок panic-room-finder Скилл panic-room-finder для Claude Code помогает составить карту дома, заметить возможные пустоты и спланировать безопасную комнату. Описывает неразрушающее обследование собственного жилья. CX Codex +1 176установок pixel-art-infographic-creator Скилл pixel-art-infographic-creator для Claude Code, Cursor и других платформ, который рисует диаграммы и инфографику в стиле 16-битных игр SNES. CX Codex +1 176установок cost-accrual-tracker Скилл cost-accrual-tracker для Claude Code и пяти других платформ, который считает расходы на API в режиме реального времени во время выполнения LLM-запросов. Фиксирует частичные затраты даже при прерванных запросах. CX Codex +1 175установок

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

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