nextjs-15 — скилл для Claude Code: что делает и как установить
Скилл задаёт паттерны работы с App Router в Next.js 15: маршрутизацию, Server Actions, параллельную загрузку данных и настройку middleware.
Apache-2.0 185 установок ★ 678 обновлён 2026-03-28
npx skills add Gentleman-Programming/Gentleman-Skills --skill nextjs-15 -a claude-codeЧто делает nextjs-15
Скилл добавляет в контекст правила структуры каталога app/ для Next.js 15. Он ориентирует агента на обязательные корневые макеты layout.tsx, группы маршрутов без влияния на URL вроде (auth)/, приватные папки _components/ и серверные компоненты по умолчанию.
Внутри собраны готовые шаблоны для Server Actions с вызовами revalidatePath и redirect, параллельных запросов через Promise.all и потоковой передачи через Suspense. Также описаны API-маршруты с NextRequest и NextResponse, генерация метаданных и конфигурация middleware.ts. Для защиты секретных методов от утечки на клиент скилл навязывает импорт пакета server-only, который вызовет ошибку сборки при случайном вызове в клиентском компоненте.
Какие задачи решает
- Собрать файловую структуру каталога
app/по правилам App Router - Написать Server Action для отправки формы с ревалидацией кеша
- Настроить параллельное получение данных через
Promise.allи Suspense - Защитить серверные функции от импорта в клиентские компоненты через
server-only
Примеры запросов агенту
- Напиши Server Action для создания пользователя и сброса кеша страницы
/users - Сделай обработчик
POSTвapp/api/users/route.tsс валидацией тела запроса - Настрой
middleware.tsдля перенаправления неавторизованных пользователей с маршрута/dashboard
Как установить nextjs-15
1Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill nextjs-15 -a claude-code2Вручную: положить файлы
~/.claude/skills/nextjs-15/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/nextjs-15/
1Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill nextjs-15 -a codex2Вручную: положить файлы
.agents/skills/nextjs-15/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill nextjs-15 -a cursor2Вручную: положить файлы
.cursor/skills/nextjs-15/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Gentleman-Programming/Gentleman-Skills curated/nextjs-15/SKILL.md2Вручную: положить файлы
.github/skills/nextjs-15/SKILL.md1Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill nextjs-15 -a gemini-cli2Командой платформы
gemini skills install https://github.com/Gentleman-Programming/Gentleman-Skills --path curated/nextjs-15Вручную: положить файлы
.devin/skills/nextjs-15/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill nextjs-15 -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о nextjs-15
Как установить nextjs-15 в Claude Code?
Выполните в терминале команду npx skills add Gentleman-Programming/Gentleman-Skills --skill nextjs-15 -a claude-code.
Что делает скилл nextjs-15?
Он передаёт агенту актуальные паттерны Next.js 15: правила именования файлов в App Router, синтаксис Server Actions, потоковый рендеринг и маршрутные обработчики.
Зачем скилл рекомендует импортировать server-only?
Импорт пакета server-only блокирует запуск кода на клиенте и выдаёт ошибку сборки, если модуль с секретными данными случайно импортируют в клиентский компонент.
Исходный текст
SKILL.md · Apache-2.0
---
name: nextjs-15
description: >
Next.js 15 App Router patterns.
Trigger: When working with Next.js - routing, Server Actions, data fetching.
license: Apache-2.0
metadata:
author: gentleman-programming
version: "1.0"
---
## App Router File Conventions
```
app/
├── layout.tsx # Root layout (required)
├── page.tsx # Home page (/)
├── loading.tsx # Loading UI (Suspense)
├── error.tsx # Error boundary
├── not-found.tsx # 404 page
├── (auth)/ # Route group (no URL impact)
│ ├── login/page.tsx # /login
│ └── signup/page.tsx # /signup
├── api/
│ └── route.ts # API handler
└── _components/ # Private folder (not routed)
```
## Server Components (Default)
```typescript
// No directive needed - async by default
export default async function Page() {
const data = await db.query();
return <Component data={data} />;
}
```
## Server Actions
```typescript
// app/actions.ts
"use server";
import { revalidatePath } from "next/cache";
import { redirect } from "next/navigation";
export async function createUser(formData: FormData) {
const name = formData.get("name") as string;
await db.users.create({ data: { name } });
revalidatePath("/users");
redirect("/users");
}
// Usage
<form action={createUser}>
<input name="name" required />
<button type="submit">Create</button>
</form>
```
## Data Fetching
```typescript
// Parallel
async function Page() {
const [users, posts] = await Promise.all([
getUsers(),
getPosts(),
]);
return <Dashboard users={users} posts={posts} />;
}
// Streaming with Suspense
<Suspense fallback={<Loading />}>
<SlowComponent />
</Suspense>
```
## Route Handlers (API)
```typescript
// app/api/users/route.ts
import { NextRequest, NextResponse } from "next/server";
export async function GET(request: NextRequest) {
const users = await db.users.findMany();
return NextResponse.json(users);
}
export async function POST(request: NextRequest) {
const body = await request.json();
const user = await db.users.create({ data: body });
return NextResponse.json(user, { status: 201 });
}
```
## Middleware
```typescript
// middleware.ts (root level)
import { NextResponse } from "next/server";
import type { NextRequest } from "next/server";
export function middleware(request: NextRequest) {
const token = request.cookies.get("token");
if (!token && request.nextUrl.pathname.startsWith("/dashboard")) {
return NextResponse.redirect(new URL("/login", request.url));
}
return NextResponse.next();
}
export const config = {
matcher: ["/dashboard/:path*"],
};
```
## Metadata
```typescript
// Static
export const metadata = {
title: "My App",
description: "Description",
};
// Dynamic
export async function generateMetadata({ params }) {
const product = await getProduct(params.id);
return { title: product.name };
}
```
## server-only Package
```typescript
import "server-only";
// This will error if imported in client component
export async function getSecretData() {
return db.secrets.findMany();
}
```
## Keywords
nextjs, next.js, app router, server components, server actions, streaming
© gentleman-programming · Apache-2.0 · Gentleman-Programming/Gentleman-Skills