api-endpoint-scaffolder — скилл для Claude Code
Скилл api-endpoint-scaffolder собирает REST-эндпоинты по шаблонам для Next.js App Router и Express: схема Zod, коды ответов, обработка ошибок.
MIT 317 установок ★ 440 обновлён 2026-10-20
npx skills add OneWave-AI/claude-skills --skill api-endpoint-scaffolder -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/api-endpoint-scaffolder/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/api-endpoint-scaffolder/
1Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill api-endpoint-scaffolder -a codex2Вручную: положить файлы
.agents/skills/api-endpoint-scaffolder/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill api-endpoint-scaffolder -a cursor2Вручную: положить файлы
.cursor/skills/api-endpoint-scaffolder/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install OneWave-AI/claude-skills api-endpoint-scaffolder2Вручную: положить файлы
.github/skills/api-endpoint-scaffolder/SKILL.md1Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill api-endpoint-scaffolder -a gemini-cli2Командой платформы
gemini skills install https://github.com/OneWave-AI/claude-skills --path api-endpoint-scaffolderВручную: положить файлы
.devin/skills/api-endpoint-scaffolder/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill api-endpoint-scaffolder -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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