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

api-endpoint-scaffolder — скилл для Claude Code

Скилл api-endpoint-scaffolder собирает REST-эндпоинты по шаблонам для Next.js App Router и Express: схема Zod, коды ответов, обработка ошибок.

MIT 317 установок ★ 440 обновлён 2026-10-20

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

Что делает api-endpoint-scaffolder

Скилл работает как памятка плюс заготовки кода. Агент сначала выясняет фреймворк, потом HTTP-метод, описывает типы запроса и ответа, и только затем пишет реализацию — эти четыре шага прописаны в инструкции.

Внутри два шаблона: app/api/[resource]/route.ts для Next.js App Router и роутер Express. Оба на TypeScript, оба импортируют zod для проверки тела запроса. В Next.js-варианте ошибка ZodError превращается в ответ 400 с деталями, всё остальное — в 500. Рядом таблица кодов от 200 до 500 и напоминание про rate limiting и OpenAPI.

Шаблоны жёстко привязаны к TypeScript и zod.

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

  • создать POST-роут с валидацией тела через Zod
  • разложить ответы по статусам 200, 201, 400 и 500
  • добавить обработку ошибок в Express-роутер
  • описать типы запроса и ответа до написания кода
  • заложить rate limiting для публичного эндпоинта

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

  • Сделай новый эндпоинт POST /api/orders по шаблону скилла: валидация через Zod, ответ 201.
  • Добавь GET-роут в app/api/[resource]/route.ts с обработкой ошибок как в шаблоне.
  • Перепиши этот Express-роутер: схема Zod на вход, next(error) в catch.

Как установить api-endpoint-scaffolder

1Через Skills CLI (Vercel)

npx skills add OneWave-AI/claude-skills --skill api-endpoint-scaffolder -a claude-code

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

~/.claude/skills/api-endpoint-scaffolder/SKILL.md

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

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

Вопросы об api-endpoint-scaffolder

Как установить api-endpoint-scaffolder в Claude Code?

Одна команда: npx skills add OneWave-AI/claude-skills --skill api-endpoint-scaffolder -a claude-code. Файл скилла окажется по пути ~/.claude/skills/api-endpoint-scaffolder/SKILL.md.

Что делает api-endpoint-scaffolder?

Помогает агенту собрать REST-эндпоинт: определить фреймворк и метод, описать типы, добавить валидацию и обработку ошибок.

Какие фреймворки поддерживает скилл?

Готовые шаблоны кода есть для Next.js App Router и Express. Инструкция велит агенту сначала определить фреймворк, среди примеров названы Express, Next.js и FastAPI.

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

SKILL.md · MIT
---
name: api-endpoint-scaffolder
description: Generate REST API endpoints with proper structure, validation, error handling, and types. Use when creating new API routes, endpoints, or backend services.
---

# API Endpoint Scaffolder

## Instructions

When creating a new API endpoint:

1. **Identify the framework** (Express, Next.js, FastAPI, etc.)
2. **Determine HTTP method** (GET, POST, PUT, PATCH, DELETE)
3. **Define request/response types**
4. **Implement with best practices**

## Templates

### Next.js App Router (TypeScript)

```typescript
// app/api/[resource]/route.ts
import { NextRequest, NextResponse } from 'next/server';
import { z } from 'zod';

const RequestSchema = z.object({
  // Define your schema
});

export async function GET(request: NextRequest) {
  try {
    const { searchParams } = new URL(request.url);
    // Implementation
    return NextResponse.json({ data }, { status: 200 });
  } catch (error) {
    console.error('[API] Error:', error);
    return NextResponse.json(
      { error: 'Internal server error' },
      { status: 500 }
    );
  }
}

export async function POST(request: NextRequest) {
  try {
    const body = await request.json();
    const validated = RequestSchema.parse(body);
    // Implementation
    return NextResponse.json({ data }, { status: 201 });
  } catch (error) {
    if (error instanceof z.ZodError) {
      return NextResponse.json(
        { error: 'Validation failed', details: error.errors },
        { status: 400 }
      );
    }
    return NextResponse.json(
      { error: 'Internal server error' },
      { status: 500 }
    );
  }
}
```

### Express (TypeScript)

```typescript
import { Router, Request, Response, NextFunction } from 'express';
import { z } from 'zod';

const router = Router();

const CreateSchema = z.object({
  // Define schema
});

router.post('/', async (req: Request, res: Response, next: NextFunction) => {
  try {
    const data = CreateSchema.parse(req.body);
    // Implementation
    res.status(201).json({ success: true, data });
  } catch (error) {
    next(error);
  }
});

export default router;
```

## Best Practices

1. **Always validate input** using Zod, Yup, or similar
2. **Use proper HTTP status codes**:
   - 200: Success
   - 201: Created
   - 400: Bad Request
   - 401: Unauthorized
   - 403: Forbidden
   - 404: Not Found
   - 500: Server Error
3. **Log errors** but don't expose internals to clients
4. **Use consistent response format**
5. **Add rate limiting** for public endpoints
6. **Document with OpenAPI/Swagger** when possible

© OneWave-AI · MIT · OneWave-AI/claude-skills

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

Все скиллы по теме «Бэкенд и API» →
api-endpoint-generator patricio0312rev Скилл api-endpoint-generator для Claude Code генерирует CRUD REST API с валидацией запросов, типами TypeScript, единым форматом ответов и документацией. Создаёт API-маршруты и backend endpoints. CX Codex +1 294установок hono-api-scaffolder jezweb Скилл hono-api-scaffolder создаёт маршруты Hono для Cloudflare Workers с проверкой Zod, обработкой ошибок и документацией API. Нужен после подготовки каркаса проекта. CX Codex +1 1 600установок rest-api-design curiositech Скилл rest-api-design помогает проектировать REST-маршруты с проверкой данных через Zod и документацией OpenAPI. Пригодится при создании API для Next.js App Router. CX Codex +1 209установок saas-scaffolder Alireza Rezvani Скилл saas-scaffolder для Claude Code, который генерирует рабочий каркас SaaS на Next.js: авторизация, схема базы, биллинг Stripe, API-роуты и дашборд. CX Codex +1 630установок api-security-hardener patricio0312rev Скилл api-security-hardener добавляет в Express API проверку входа по схемам Zod, лимиты запросов на Redis и JWT-аутентификацию с ролями. CX Codex +1 289установок adding-api-docs spencerpauly Скилл adding-api-docs собирает OpenAPI/Swagger-описание вашего API: схемы эндпоинтов, типы запросов и ответов, интерактивную страницу документации. CX Codex +1 455установок

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

Весь набор →
ramping-rep-tracker Скилл ramping-rep-tracker задаёт контрольные точки на 30, 60, 90 и 120 дней для онбординга сейлз-менеджеров. Помогает отслеживать активность по неделям и вовремя замечать риски до выхода на квоту. CX Codex +1 323установок territory-planning-optimizer Скилл territory-planning-optimizer распределяет аккаунты по выручке, географии и связям, рассчитывает TAM/SAM и выравнивает нагрузку между сейлз-менеджерами. CX Codex +1 320установок sports-podcast-outline-generator Скилл sports-podcast-outline-generator собирает структуру выпуска спортивного подкаста: тайминг сегментов, темы для спора, вопросы слушателей и места под рекламу. CX Codex +1 320установок post-game-press-conference-simulator Генерирует правдоподобные ответы тренеров и игроков на послематчевых пресс-конференциях. Создаёт реплики для спортивных медиа, текстов и игровых диалогов после побед, поражений и травм. CX Codex +1 320установок error-boundary-creator Скилл error-boundary-creator создаёт предохранители ошибок, запасные интерфейсы и перехват сбоев для React и Next.js. Помогает изолировать падения сторонних библиотек и настроить логирование. CX Codex +1 316установок docker-debugger Скилл docker-debugger для Claude Code разбирает сбои сборки и запуска контейнеров, проблемы сети и томов, настройки docker-compose. Находит причины ошибок и предлагает исправления конфигурации. CX Codex +1 314установок scout Скилл scout для Claude Code разбирает текущий диалог и рекомендует скилл или субагента для задачи. Помогает выбрать инструмент среди десятков команд. CX Codex +1 314установок test-coverage-improver Скилл test-coverage-improver находит пробелы в покрытии тестами и генерирует недостающие тесты для критичных участков кода. CX Codex +1 312установок

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

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