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

app-router — скилл для Claude Code: маршрутизация Next.js App Router

Скилл для создания маршрутов, лейаутов, состояний загрузки и границ ошибок в Next.js App Router. Помогает агенту правильно организовать файловую структуру проекта.

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

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

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

Скилл объясняет агенту соглашения файловой структуры Next.js App Router: какие файлы создавать (page.tsx, layout.tsx, loading.tsx, error.tsx), как организовать динамические маршруты ([slug]), catch-all сегменты ([...slug]) и группы маршрутов ((folder)). Внутри — примеры компонентов страниц, вложенных лейаутов, обработки параметров через params, настройки метаданных и работы с параллельными маршрутами.

Скилл срабатывает, когда вы просите создать маршрут, добавить страницу, настроить лейаут или обработать ошибки. Без него агент может выбрать устаревшие паттерны pages/ вместо app/.

Установка через npx skills add — команда скопирует файл скилла в директорию платформы.

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

  • создать новый маршрут в Next.js с правильной структурой папок
  • добавить динамический маршрут с параметрами
  • настроить вложенные лейауты с общим UI
  • обработать состояния загрузки через Suspense
  • добавить границы ошибок для сегментов маршрута

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

  • Создай маршрут /blog/[slug] с динамическим параметром
  • Добавь лейаут для раздела dashboard с боковой панелью
  • Настрой обработку ошибок и состояние загрузки для /products

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

1Через Skills CLI (Vercel)

npx skills add davepoon/buildwithclaude --skill app-router -a claude-code

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

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

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

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

Вопросы об app-router

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

Выполни команду npx skills add davepoon/buildwithclaude --skill app-router -a claude-code, файл скилла появится в ~/.claude/skills/app-router/SKILL.md.

Что делает скилл app-router?

Учит агента создавать маршруты, лейауты и обрабатывать ошибки по соглашениям Next.js App Router — использовать app/ вместо pages/, правильно именовать файлы и папки, работать с динамическими сегментами и группами маршрутов.

Чем отличается app-router от старого роутера Next.js?

App Router использует директорию app/ с файловыми соглашениями (page.tsx, layout.tsx), поддерживает React Server Components, встроенные состояния загрузки через Suspense и вложенные лейауты, которые сохраняют состояние при навигации.

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

SKILL.md · MIT
---
name: app-router
description: This skill should be used when the user asks to "create a Next.js route", "add a page", "set up layouts", "implement loading states", "add error boundaries", "organize routes", "create dynamic routes", or needs guidance on Next.js App Router file conventions and routing patterns.
version: 1.0.0
---

# Next.js App Router Patterns

## Overview

The App Router is Next.js's file-system based router built on React Server Components. It uses a `app/` directory structure where folders define routes and special files control UI behavior.

## Core File Conventions

### Route Files

Each route segment is defined by a folder. Special files within folders control behavior:

| File | Purpose |
|------|---------|
| `page.tsx` | Unique UI for a route, makes route publicly accessible |
| `layout.tsx` | Shared UI wrapper, preserves state across navigations |
| `loading.tsx` | Loading UI using React Suspense |
| `error.tsx` | Error boundary for route segment |
| `not-found.tsx` | UI for 404 responses |
| `template.tsx` | Like layout but re-renders on navigation |
| `default.tsx` | Fallback for parallel routes |

### Folder Conventions

| Pattern | Purpose | Example |
|---------|---------|---------|
| `folder/` | Route segment | `app/blog/` → `/blog` |
| `[folder]/` | Dynamic segment | `app/blog/[slug]/` → `/blog/:slug` |
| `[...folder]/` | Catch-all segment | `app/docs/[...slug]/` → `/docs/*` |
| `[[...folder]]/` | Optional catch-all | `app/shop/[[...slug]]/` → `/shop` or `/shop/*` |
| `(folder)/` | Route group (no URL) | `app/(marketing)/about/` → `/about` |
| `@folder/` | Named slot (parallel routes) | `app/@modal/login/` |
| `_folder/` | Private folder (excluded) | `app/_components/` |

## Creating Routes

### Basic Route Structure

To create a new route, add a folder with `page.tsx`:

```
app/
├── page.tsx              # / (home)
├── about/
│   └── page.tsx          # /about
└── blog/
    ├── page.tsx          # /blog
    └── [slug]/
        └── page.tsx      # /blog/:slug
```

### Page Component

A page is a Server Component by default:

```tsx
// app/about/page.tsx
export default function AboutPage() {
  return (
    <main>
      <h1>About Us</h1>
      <p>Welcome to our company.</p>
    </main>
  )
}
```

### Dynamic Routes

Access route parameters via the `params` prop:

```tsx
// app/blog/[slug]/page.tsx
interface PageProps {
  params: Promise<{ slug: string }>
}

export default async function BlogPost({ params }: PageProps) {
  const { slug } = await params
  const post = await getPost(slug)

  return <article>{post.content}</article>
}
```

## Layouts

### Root Layout (Required)

Every app needs a root layout with `<html>` and `<body>`:

```tsx
// app/layout.tsx
export default function RootLayout({
  children,
}: {
  children: React.ReactNode
}) {
  return (
    <html lang="en">
      <body>{children}</body>
    </html>
  )
}
```

### Nested Layouts

Layouts wrap their children and preserve state:

```tsx
// app/dashboard/layout.tsx
export default function DashboardLayout({
  children,
}: {
  children: React.ReactNode
}) {
  return (
    <div className="flex">
      <Sidebar />
      <main className="flex-1">{children}</main>
    </div>
  )
}
```

## Loading and Error States

### Loading UI

Create instant loading states with Suspense:

```tsx
// app/dashboard/loading.tsx
export default function Loading() {
  return <div className="animate-pulse">Loading...</div>
}
```

### Error Boundaries

Handle errors gracefully:

```tsx
// app/dashboard/error.tsx
'use client'

export default function Error({
  error,
  reset,
}: {
  error: Error
  reset: () => void
}) {
  return (
    <div>
      <h2>Something went wrong!</h2>
      <button onClick={reset}>Try again</button>
    </div>
  )
}
```

## Route Groups

Organize routes without affecting URL structure:

```
app/
├── (marketing)/
│   ├── layout.tsx        # Marketing layout
│   ├── about/page.tsx    # /about
│   └── contact/page.tsx  # /contact
└── (shop)/
    ├── layout.tsx        # Shop layout
    └── products/page.tsx # /products
```

## Metadata

### Static Metadata

```tsx
// app/about/page.tsx
import { Metadata } from 'next'

export const metadata: Metadata = {
  title: 'About Us',
  description: 'Learn more about our company',
}
```

### Dynamic Metadata

```tsx
// app/blog/[slug]/page.tsx
export async function generateMetadata({ params }: PageProps): Promise<Metadata> {
  const { slug } = await params
  const post = await getPost(slug)
  return { title: post.title }
}
```

## Key Patterns

1. **Colocation**: Keep components, tests, and styles near routes
2. **Private folders**: Use `_folder` for non-route files
3. **Route groups**: Use `(folder)` to organize without URL impact
4. **Parallel routes**: Use `@slot` for complex layouts
5. **Intercepting routes**: Use `(.)` patterns for modals

## Resources

For detailed patterns, see:
- `references/routing-conventions.md` - Complete file conventions
- `references/layouts-templates.md` - Layout composition patterns
- `references/loading-error-states.md` - Suspense and error handling
- `examples/dynamic-routes.md` - Dynamic routing examples
- `examples/parallel-routes.md` - Parallel and intercepting routes

© davepoon · MIT · davepoon/buildwithclaude

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

Все скиллы по теме «Фронтенд и 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-router-expert curiositech Скилл nextjs-app-router-expert помогает проектировать и отлаживать приложения на Next.js 14/15 с App Router. Пригодится при настройке маршрутов, Server Actions и загрузки данных. CX Codex +1 176установок nextjs PyModel Внедряет стандарты Next.js 16 App Router. Направляет рефакторинг серверных компонентов, кэширования и маршрутов. CX Codex +1 621установок nextjs-app-router-fundamentals wsimmonds Скилл nextjs-app-router-fundamentals ведёт агента по Next.js App Router: перенос с Pages Router, вложенные layout, метаданные, динамические маршруты. Пригодится при переходе на app/. CX Codex +1 2 200установок nextjs-app-router giuseppe-trisciuoglio Скилл nextjs-app-router для Claude Code помогает создавать приложения на Next.js 16+ с App Router. Подключается при работе с серверными компонентами, формами, API-маршрутами и кэшированием. CX Codex +1 4 100установок next-intl-app-router liuchiawei Скилл next-intl-app-router для Claude Code. Настраивает next-intl с локалью в пути: конфиг, прокси, навигация и файлы сообщений. Закрывает добавление второго языка в проект. CX Codex +1 619установок

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

Весь набор →
server-actions Помогает агенту писать Server Actions в Next.js App Router: от валидации форм через Zod до хука useFormStatus и сброса кэша. CX Codex +1 204установок macos-design Скилл macos-design для Claude Code помогает проектировать интерфейсы macOS по системным паттернам, со светлой и тёмной темами. Задача — проектирование интерфейсов десктопных приложений и утилит. CX Codex +1 192установок auth-patterns Скилл auth-patterns для Claude Code собирает шаблоны аутентификации Next.js: настройку NextAuth.js v5, защиту маршрутов через middleware, RBAC и работу с сессиями в серверных компонентах. CX Codex +1 183установок server-components Скилл объясняет архитектуру React Server Components в Next.js: границы Server и Client Components, композицию и загрузку данных. CX Codex +1 158установок route-handlers Скилл route-handlers помогает ИИ-агенту писать API-роуты для Next.js App Router: от стандартных эндпоинтов до потоковой передачи данных и настройки CORS. CX Codex +1 152установок canva-automation Скилл canva-automation управляет дизайнами, ассетами, папками и автозаполнением шаблонов в Canva через Rube MCP. CX Codex +1 149установок google-calendar-automation Скилл google-calendar-automation управляет событиями Google Calendar, ищет свободные интервалы и работает с участниками через Rube MCP. CX Codex +1 142установок outlook-automation Скилл outlook-automation для Claude Code автоматизирует работу с письмами, календарём, контактами и папками Outlook через Rube MCP. Ищет письма по условиям и управляет событиями и контактами. CX Codex +1 140установок

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

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