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

inngest-nextjs-patterns — скилл для Claude Code: Inngest в Next.js

Скилл inngest-nextjs-patterns для Claude Code собирает шаблоны Inngest для фоновых задач в Next.js App Router: клиент, обработчик, типизированные события, cron и функции с шагами.

MIT 141 установок ★ 227 обновлён 2026-08-15

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

Что делает inngest-nextjs-patterns

Скилл даёт агенту готовые заготовки для фоновой работы на Inngest внутри Next.js App Router. В наборе клиент-синглтон, обработчик /api/inngest, типизированное событие со схемой Zod, функция по событию, cron-функция и оркестратор, который раздаёт работу через step.sendEvent или Promise.all(step.invoke(...)).

Каждый шаблон лежит отдельным файлом с таблицей параметров сверху: агент подставляет значения и кладёт результат по пути вроде src/inngest/functions/{name}.ts. Новую функцию ещё нужно добавить в реестр src/inngest/functions/index.ts, иначе обработчик её не увидит. Файл references/conventions.md объясняет форму имени события (domain/entity.verb_past), стабильный kebab-case для id функции и требование идемпотентности к каждому step.run.

Проект без src/ или на Pages Router потребует правки путей в config.json, потому что шаблоны по умолчанию рассчитывают на src/. Для локальной проверки нужны npx inngest-cli@latest dev и INNGEST_DEV=1 в .env.local, иначе SDK не смотрит на dev-сервер. id функции после деплоя менять нельзя: по нему Inngest хранит состояние, и переименование рвёт связь с уже накопленными запусками.

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

  • добавить фоновую задачу в Next.js-приложение без ручной сборки очереди
  • завести типизированное событие со схемой Zod для нового домена
  • расписать cron-функцию с часовым поясом
  • раздать одну работу веером через step.sendEvent и дождаться результатов
  • проверить старые функции Inngest на стабильность id и идемпотентность шагов

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

  • Добавь фоновую задачу: после оплаты заказа отправь письмо, шаги оформи через Inngest.
  • Заведи событие shop/order.placed со схемой Zod и функцию, которая на него реагирует.
  • Сделай cron-функцию, которая каждый час чистит зависшие черновики.

Как установить inngest-nextjs-patterns

1Через Skills CLI (Vercel)

npx skills add pproenca/dot-skills --skill inngest-nextjs-patterns -a claude-code

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

~/.claude/skills/inngest-nextjs-patterns/SKILL.md

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

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

Вопросы об inngest-nextjs-patterns

Как установить inngest-nextjs-patterns в Claude Code?

Выполните npx skills add pproenca/dot-skills --skill inngest-nextjs-patterns -a claude-code. Скилл окажется в ~/.claude/skills/inngest-nextjs-patterns/SKILL.md.

Что делает inngest-nextjs-patterns?

Подсказывает агенту, как собрать фоновые задачи на Inngest в Next.js App Router: клиент, обработчик /api/inngest, события со схемами Zod, функции по событию, cron и оркестраторы.

Что нужно для локального запуска Inngest?

npx inngest-cli@latest dev поднимает dev-сервер, интерфейс открывается на http://localhost:8288. В .env.local добавьте INNGEST_DEV=1, чтобы SDK обращался именно к нему.

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

SKILL.md · MIT
---
name: inngest-nextjs-patterns
description: Inngest event-driven functions in a Next.js (App Router) project — creating the client, the /api/inngest route handler, typed events with Zod schemas, durable event-triggered functions, scheduled cron functions, or fan-out orchestrators. Trigger when scaffolding Inngest patterns — and even if the user just says "add a background job", "process this async", "schedule X every hour", or "send an event when Y happens" in a Next.js codebase. Also trigger when reviewing existing Inngest code to enforce event-naming, function-id stability, and step-idempotency conventions.
---
# Inngest + Next.js Patterns

Templates and conventions for building event-driven, durable background work on Inngest from a Next.js App Router project. The skill enforces the conventions Inngest's own docs use (decentralized `eventType()` schemas, kebab-case stable function IDs, idempotent steps) so that retries, replays, and concurrency controls actually do what they advertise.

## When to Apply

Read this skill when you are:

- Setting up Inngest in a Next.js app for the first time (client + route handler + first function)
- Adding a new background job, webhook handler, or scheduled task to a Next.js app
- Defining a new domain event that other functions will trigger on
- Orchestrating multi-step work that must survive process restarts (durable workflows, sagas)
- Reviewing existing Inngest code for event naming, step idempotency, or stable function IDs
- Migrating from `setTimeout` / a queue library / a cron service to Inngest's durable execution model

## How to Use

1. **First time in this codebase?** Read [`references/conventions.md`](references/conventions.md) before writing anything. The conventions explain *why* event names take a specific shape, why function IDs must be stable, and why every `step.run` must be idempotent — once you understand the reasoning, the templates make sense.
2. **Pick a template** from the catalog below based on what you're creating.
3. **Render it** by substituting the documented parameters. Each template has a parameter table at the top of its file.
4. **Wire it up:** new functions must be added to `src/inngest/functions/index.ts` (the registry the route handler reads). The conventions doc shows the registry pattern.

## Available Templates

| Template | Output Path | Use When |
|---|---|---|
| [`client.ts.template`](assets/templates/client.ts.template) | `src/inngest/client.ts` | One-time setup: create the singleton Inngest client. Generate **once per app**. |
| [`route-handler.ts.template`](assets/templates/route-handler.ts.template) | `src/app/api/inngest/route.ts` | One-time setup: the App Router endpoint Inngest hits to invoke your functions. Generate **once per app**. |
| [`event.ts.template`](assets/templates/event.ts.template) | `src/inngest/events/{domain}.ts` | Defining a new typed event (with Zod schema) that producers send and functions consume. |
| [`function.ts.template`](assets/templates/function.ts.template) | `src/inngest/functions/{name}.ts` | Standard event-triggered durable function with steps. Parameterized retries, concurrency, throttle, debounce, cancelOn, onFailure. |
| [`function-cron.ts.template`](assets/templates/function-cron.ts.template) | `src/inngest/functions/{name}.ts` | Scheduled function — runs on a cron expression (with timezone). Optionally also accepts a manual event trigger for ad-hoc invocation. |
| [`function-fan-out.ts.template`](assets/templates/function-fan-out.ts.template) | `src/inngest/functions/{name}.ts` | Orchestrator that receives one event and fans out work — via `step.sendEvent` (fire-and-forget) or `Promise.all(step.invoke(...))` (wait for results). |

## Quick Reference

- **Event name shape:** `domain/entity.verb_past` — e.g., `app/user.created`, `shop/order.placed`, `billing/invoice.paid`. The conventions doc has the full rule.
- **Function `id`:** stable kebab-case, **never rename it** after deploy — Inngest uses it as the durable state key.
- **Step `id`:** descriptive kebab-case, also durable; changing one re-runs that step on replay.
- **Idempotency:** every `step.run` must be safely retryable. If it calls a third-party API that mutates state, pass an idempotency key.
- **Dev server:** `npx inngest-cli@latest dev`, then UI at http://localhost:8288. Set `INNGEST_DEV=1` in `.env.local` to point the SDK at it.

## Project Layout Assumption

Templates assume a `src/` directory with App Router:

```
src/
├── app/api/inngest/route.ts          # generated by route-handler template
└── inngest/
    ├── client.ts                     # generated by client template
    ├── events/                       # one file per domain (events.shop.ts, events.user.ts)
    │   └── {domain}.ts               # generated by event template
    └── functions/
        ├── index.ts                  # registry: re-exports all functions as an array
        └── {name}.ts                 # generated by function/cron/fan-out templates
```

If your project uses a different layout (no `src/`, or Pages Router), override the output paths in `config.json`. The conventions doc explains the trade-offs.

## Setup

`config.json` controls path overrides. On first use, check whether its fields are filled in — if not, ask the user before generating (project root differs from the default assumption).

## Related Skills

- `vercel:ai-sdk` — if your Inngest functions invoke LLMs, the AI SDK gives you streaming + provider abstraction; pair them with `step.run` for retry safety.
- `vercel:vercel-functions` — Inngest's `serve()` adapter for Next.js runs as a Vercel Serverless Function by default; the AI SDK skill has notes on Fluid Compute and timeout extension for long agent runs.

© pproenca · MIT · pproenca/dot-skills

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

Все скиллы по теме «Бэкенд и API» →
inngest-durable-functions inngest Скилл inngest-durable-functions учит агента писать отказоустойчивые функции Inngest: шаги, мемоизация, ретраи, идемпотентность и отмена. CX Codex +1 4 100установок inngest-setup inngest Скилл inngest-setup для Claude Code ставит Inngest в TypeScript-проект: клиент, переменные окружения, serve-эндпоинты и локальный dev-сервер. Держит фоновые задачи и вебхуки живыми при падении процесса. CX Codex +1 4 000установок inngest davila7 Помогает проектировать фоновые задачи и событийные сценарии Inngest с пошаговым выполнением. Охватывает отложенную обработку, расписания и длительные процессы. CX Codex +1 80установок nextjs-best-practices davila7 Скилл nextjs-best-practices для Claude Code задаёт правила App Router: разделяет серверные и клиентские компоненты, настраивает кэширование и структуру маршрутов. CX Codex +1 1 785установок nextjs-react-typescript-cursorrules-prompt-file PatrickJS Правило nextjs-react-typescript-cursorrules-prompt-file для Cursor задаёт стиль кода в проектах на Next.js 14 App Router, React и TypeScript. Подключается как файл .cursor/rules. CX Codex +1 ★ 41 178звёзд репо optimized-nextjs-typescript Mindrally Скилл optimized-nextjs-typescript для Claude Code помогает писать и улучшать приложения на Next.js с TypeScript. Задаёт рекомендации по производительности, безопасности, архитектуре и интерфейсам. CX Codex +1 1 100установок

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

Весь набор →
implementation-design-patterns-python Скилл implementation-design-patterns-python для Claude Code помогает выбирать и применять паттерны проектирования в современном Python. Он помогает разбираться с разрастающимися ветвлениями, наследованием и связями между объектами. CX Codex +1 143установок better-auth-scaffold Скилл better-auth-scaffold раскладывает Better Auth по файлам в проекте Next.js с App Router и Drizzle: шаблоны, три набора плагинов, генерация схемы и миграции. CX Codex +1 143установок expo-ui Скилл помогает писать и проверять React Native-интерфейсы на @expo/ui для iOS. Пригодится при переносе экранов на SwiftUI и работе с компонентами iOS 26. CX Codex +1 142установок design-to-react-algorithms Скилл design-to-react-algorithms задаёт алгоритмический пайплайн переноса макетов Sketch и Figma в чистый React с CSS без регрессий вёрстки. CX Codex +1 142установок acceptance-pipeline-catalog Скилл acceptance-pipeline-catalog направляет агента при сборке и отладке пайплайна приёмочных тестов на базе Gherkin и мутационного тестирования по спецификации Роберта Мартина. CX Codex +1 142установок nuqs-codemod-runner Скилл nuqs-codemod-runner находит устаревшие паттерны nuqs версий до 2.5, показывает сухой отчёт изменений и безопасно переписывает код с проверкой типов и линтером. CX Codex +1 142установок acceptance-pipeline-feature-design Скилл acceptance-pipeline-feature-design помогает спроектировать расширения Acceptance Pipeline: от синтаксиса Gherkin и полей JSON IR до новых стадий и форматов отчётов. CX Codex +1 141установок dx-harness Скилл dx-harness для Claude Code, Cursor и других IDE, который находит и устраняет трение в dev-loop — медленную подготовку, повторяющиеся ручные шаги, отсутствующие скрипты bootstrap и reset. CX Codex +1 141установок

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

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