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

server-actions — скилл для Claude Code: что делает и как установить

Помогает агенту писать Server Actions в Next.js App Router: от валидации форм через Zod до хука useFormStatus и сброса кэша.

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

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

Что делает server-actions

Скилл содержит паттерны работы с серверными функциями в Next.js. Ассистент учится объявлять директиву 'use server' внутри серверных компонентов или в отдельных файлах actions.ts. Это позволяет вызывать мутации из форм или напрямую по клику без отдельных маршрутов API.

В инструкциях собраны готовые примеры валидации данных через Zod, хуки useFormState и useFormStatus для показа спиннера, а также сброс кэша через revalidatePath и revalidateTag. Дополнительно описаны паттерны для оптимистичного обновления интерфейса с помощью useOptimistic.

Без директивы 'use client' хуки вроде useFormStatus и useOptimistic работать не будут, поэтому логику форм придётся выносить в клиентские компоненты.

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

  • написать Server Action для отправки формы в Next.js
  • валидировать поля формы на сервере с помощью Zod
  • добавить индикатор загрузки с хуком useFormStatus
  • инвалидировать кэш страниц через revalidatePath или теги

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

  • Сделай Server Action для формы регистрации с проверкой через Zod
  • Добавь кнопку отправки с состоянием загрузки через useFormStatus
  • Настрой сброс кэша постов после создания записи через revalidatePath

Как установить server-actions

1Через Skills CLI (Vercel)

npx skills add davepoon/buildwithclaude --skill server-actions -a claude-code

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

~/.claude/skills/server-actions/SKILL.md

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

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

Вопросы о server-actions

Как установить server-actions в Claude Code?

Выполните команду npx skills add davepoon/buildwithclaude --skill server-actions -a claude-code. Также можно положить файл вручную по пути ~/.claude/skills/server-actions/SKILL.md.

Что делает скилл server-actions?

Он даёт модели готовые шаблоны для мутаций данных в Next.js App Router: директивы 'use server', хуки форм и управление серверным кэшем.

Как этот скилл предлагает проверять входные данные?

Через парсинг FormData схемой Zod на сервере с последующей отправкой ошибок валидации обратно в компонент через useFormState.

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

SKILL.md · MIT
---
name: server-actions
description: This skill should be used when the user asks about "Server Actions", "form handling in Next.js", "mutations", "useFormState", "useFormStatus", "revalidatePath", "revalidateTag", or needs guidance on data mutations and form submissions in Next.js App Router.
version: 1.0.0
---

# Next.js Server Actions

## Overview

Server Actions are asynchronous functions that execute on the server. They can be called from Client and Server Components for data mutations, form submissions, and other server-side operations.

## Defining Server Actions

### In Server Components

Use the `'use server'` directive inside an async function:

```tsx
// app/page.tsx (Server Component)
export default function Page() {
  async function createPost(formData: FormData) {
    'use server'
    const title = formData.get('title') as string
    await db.post.create({ data: { title } })
  }

  return (
    <form action={createPost}>
      <input name="title" />
      <button type="submit">Create</button>
    </form>
  )
}
```

### In Separate Files

Mark the entire file with `'use server'`:

```tsx
// app/actions.ts
'use server'

export async function createPost(formData: FormData) {
  const title = formData.get('title') as string
  await db.post.create({ data: { title } })
}

export async function deletePost(id: string) {
  await db.post.delete({ where: { id } })
}
```

## Form Handling

### Basic Form

```tsx
// app/actions.ts
'use server'

export async function submitContact(formData: FormData) {
  const name = formData.get('name') as string
  const email = formData.get('email') as string
  const message = formData.get('message') as string

  await db.contact.create({
    data: { name, email, message }
  })
}

// app/contact/page.tsx
import { submitContact } from '@/app/actions'

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

### With Validation (Zod)

```tsx
// app/actions.ts
'use server'

import { z } from 'zod'

const schema = z.object({
  email: z.string().email(),
  password: z.string().min(8),
})

export async function signup(formData: FormData) {
  const parsed = schema.safeParse({
    email: formData.get('email'),
    password: formData.get('password'),
  })

  if (!parsed.success) {
    return { error: parsed.error.flatten() }
  }

  await createUser(parsed.data)
  return { success: true }
}
```

## useFormState Hook

Handle form state and errors:

```tsx
// app/signup/page.tsx
'use client'

import { useFormState } from 'react-dom'
import { signup } from '@/app/actions'

const initialState = {
  error: null,
  success: false,
}

export default function SignupPage() {
  const [state, formAction] = useFormState(signup, initialState)

  return (
    <form action={formAction}>
      <input name="email" type="email" />
      <input name="password" type="password" />
      {state.error && (
        <p className="text-red-500">{state.error}</p>
      )}
      <button type="submit">Sign Up</button>
    </form>
  )
}

// app/actions.ts
'use server'

export async function signup(prevState: any, formData: FormData) {
  const email = formData.get('email') as string

  if (!email.includes('@')) {
    return { error: 'Invalid email', success: false }
  }

  await createUser({ email })
  return { error: null, success: true }
}
```

## useFormStatus Hook

Show loading states during submission:

```tsx
// components/submit-button.tsx
'use client'

import { useFormStatus } from 'react-dom'

export function SubmitButton() {
  const { pending } = useFormStatus()

  return (
    <button type="submit" disabled={pending}>
      {pending ? 'Submitting...' : 'Submit'}
    </button>
  )
}

// Usage in form
import { SubmitButton } from '@/components/submit-button'

export default function Form() {
  return (
    <form action={submitAction}>
      <input name="title" />
      <SubmitButton />
    </form>
  )
}
```

## Revalidation

### revalidatePath

Revalidate a specific path:

```tsx
'use server'

import { revalidatePath } from 'next/cache'

export async function createPost(formData: FormData) {
  await db.post.create({ data: { ... } })

  // Revalidate the posts list page
  revalidatePath('/posts')

  // Revalidate a dynamic route
  revalidatePath('/posts/[slug]', 'page')

  // Revalidate all paths under /posts
  revalidatePath('/posts', 'layout')
}
```

### revalidateTag

Revalidate by cache tag:

```tsx
// Fetching with tags
const posts = await fetch('https://api.example.com/posts', {
  next: { tags: ['posts'] }
})

// Server Action
'use server'

import { revalidateTag } from 'next/cache'

export async function createPost(formData: FormData) {
  await db.post.create({ data: { ... } })
  revalidateTag('posts')
}
```

## Redirects After Actions

```tsx
'use server'

import { redirect } from 'next/navigation'

export async function createPost(formData: FormData) {
  const post = await db.post.create({ data: { ... } })

  // Redirect to the new post
  redirect(`/posts/${post.slug}`)
}
```

## Optimistic Updates

Update UI immediately while action completes:

```tsx
'use client'

import { useOptimistic } from 'react'
import { addTodo } from '@/app/actions'

export function TodoList({ todos }: { todos: Todo[] }) {
  const [optimisticTodos, addOptimisticTodo] = useOptimistic(
    todos,
    (state, newTodo: string) => [
      ...state,
      { id: 'temp', title: newTodo, completed: false }
    ]
  )

  async function handleSubmit(formData: FormData) {
    const title = formData.get('title') as string
    addOptimisticTodo(title) // Update UI immediately
    await addTodo(formData)  // Server action
  }

  return (
    <>
      <form action={handleSubmit}>
        <input name="title" />
        <button>Add</button>
      </form>
      <ul>
        {optimisticTodos.map(todo => (
          <li key={todo.id}>{todo.title}</li>
        ))}
      </ul>
    </>
  )
}
```

## Non-Form Usage

Call Server Actions programmatically:

```tsx
'use client'

import { deletePost } from '@/app/actions'

export function DeleteButton({ id }: { id: string }) {
  return (
    <button onClick={() => deletePost(id)}>
      Delete
    </button>
  )
}
```

## Error Handling

```tsx
'use server'

export async function createPost(formData: FormData) {
  try {
    await db.post.create({ data: { ... } })
    return { success: true }
  } catch (error) {
    if (error instanceof PrismaClientKnownRequestError) {
      if (error.code === 'P2002') {
        return { error: 'A post with this title already exists' }
      }
    }
    return { error: 'Failed to create post' }
  }
}
```

## Security Considerations

1. **Always validate input** - Never trust client data
2. **Check authentication** - Verify user is authorized
3. **Use CSRF protection** - Built-in with Server Actions
4. **Sanitize output** - Prevent XSS attacks

```tsx
'use server'

import { auth } from '@/lib/auth'

export async function deletePost(id: string) {
  const session = await auth()

  if (!session) {
    throw new Error('Unauthorized')
  }

  const post = await db.post.findUnique({ where: { id } })

  if (post.authorId !== session.user.id) {
    throw new Error('Forbidden')
  }

  await db.post.delete({ where: { id } })
}
```

## Resources

For detailed patterns, see:
- `references/form-handling.md` - Advanced form patterns
- `references/revalidation.md` - Cache revalidation strategies
- `examples/mutation-patterns.md` - Complete mutation examples

© davepoon · MIT · davepoon/buildwithclaude

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

Все скиллы по теме «Фронтенд и UI» →
safe-action-client next-safe-action Скилл safe-action-client помогает агенту объявлять и настраивать серверные действия next-safe-action с валидацией через Zod или Valibot. Пригодится при типизации Server Actions в Next.js. CX Codex +1 1 300установок server-auth-actions zebbern Правило server-auth-actions требует проверять аутентификацию и права внутри каждой Server Action. Оно защищает серверные мутации, которые можно вызвать напрямую. CX Codex +1 ★ 4 719звёзд репо mcp-server-skills gocallum Скилл mcp-server-skills для Claude Code задаёт структуру MCP-сервера в Next.js с общими Zod-схемами, тонким route и серверными экшенами для веб-интерфейса. CX Codex +1 387установок clerk-nextjs-patterns clerk Скилл clerk-nextjs-patterns для Claude Code и Codex помогает внедрять авторизацию Clerk в Next.js. Направляет агента при настройке Server Actions, middleware и кеширования. CX Codex +1 56 200установок nextjs-app-router giuseppe-trisciuoglio Скилл nextjs-app-router для Claude Code помогает создавать приложения на Next.js 16+ с App Router. Подключается при работе с серверными компонентами, формами, API-маршрутами и кэшированием. CX Codex +1 4 100установок nextjs-core bobmatnyc Скилл nextjs-core задаёт правила разработки на Next.js App Router: серверные компоненты по умолчанию, мутации через Server Actions и точечную ревалидацию кеша. CX Codex +1 365установок

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

Весь набор →
file-organizer Скилл file-organizer анализирует папки, находит дубликаты, предлагает структуру и переносит файлы по твоему одобрению. Работает через bash-команды. CX Codex +1 355установок 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установок app-router Скилл для создания маршрутов, лейаутов, состояний загрузки и границ ошибок в Next.js App Router. Помогает агенту правильно организовать файловую структуру проекта. CX Codex +1 153установок 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установок

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

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