# api-test-suite-generator

Скилл сканирует определения маршрутов и генерирует тесты API на Jest, Vitest или Supertest. Пригодится, когда эндпоинты уже есть, а тестов к ним нет.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 303 установки · ★ 63
- Автор: patricio0312rev
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/patricio0312rev/skills/tree/HEAD/testing/api-test-suite-generator/SKILL.md
- Обновлён: 2026-01-12
- HTML: https://affpapa.org/nevibecode/skills/api-test-suite-generator

## Что делает

Скилл проходит по проекту и находит определения API-маршрутов: Express, Next.js, Fastify и другие. Дальше он вытаскивает схемы запросов и ответов и раскладывает их в тестовые файлы по ресурсам. На каждый маршрут получается набор проверок: успешный сценарий, коды статусов, структура ответа, заголовки. Отдельно добавляются пограничные случаи — невалидное тело, отсутствие токена, несуществующий ресурс.

Структура предсказуемая: `tests/setup.ts` поднимает сервер на случайном порту и чистит базу перед каждым тестом, в `tests/fixtures/` лежат тестовые данные, в `tests/helpers/api-client.ts` — обёртка над Supertest с авторизацией через `Authorization: Bearer`. Есть и скрипт-генератор `scripts/generate-api-tests.ts`: он собирает файлы из описаний маршрутов. Примеры в скилле завязаны на Prisma — если у вас другая ORM, куски с `prisma.$executeRaw` и `$disconnect` придётся переписать под себя.

Скилл ставится в Claude, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Для GitHub Copilot команда установки другая — через `gh skill install`. Тесты он пишет на TypeScript, так что проект без TS потребует правок в сгенерированных файлах.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add patricio0312rev/skills --skill api-test-suite-generator -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/api-test-suite-generator/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/api-test-suite-generator/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add patricio0312rev/skills --skill api-test-suite-generator -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/api-test-suite-generator/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add patricio0312rev/skills --skill api-test-suite-generator -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/api-test-suite-generator/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install patricio0312rev/skills api-test-suite-generator
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/api-test-suite-generator/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add patricio0312rev/skills --skill api-test-suite-generator -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/patricio0312rev/skills --path testing/api-test-suite-generator
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/api-test-suite-generator/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add patricio0312rev/skills --skill api-test-suite-generator -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/patricio0312rev/skills/tree/HEAD/testing/api-test-suite-generator/SKILL.md

## Когда брать
- написать интеграционные тесты на все эндпоинты Express
- покрыть проверками коды 401, 404 и 400
- собрать фикстуры и сидинг базы для тестов
- поднять тестовый сервер на случайном порту
- добавить авторизацию в запросы Supertest

## Примеры запросов агенту
- сгенерируй тесты API для маршрутов users
- создай интеграционные тесты для эндпоинтов /api/products
- сделай тестовый набор для API с проверкой авторизации

## Похожие
- [test-automator](https://affpapa.org/nevibecode/skills/test-automator.md) — скилл · 812 установок
- [api-testing](https://affpapa.org/nevibecode/skills/secondsky-api-testing.md) — скилл · 890 установок
- [test-coverage](https://affpapa.org/nevibecode/skills/test-coverage.md) — скилл · 1900 установок
- [parallel-test-fixing](https://affpapa.org/nevibecode/skills/parallel-test-fixing.md) — скилл · 412 установок
- [test-guard](https://affpapa.org/nevibecode/skills/test-guard.md) — скилл · 4100 установок
- [dx-devops-test-suite-assignments-configure](https://affpapa.org/nevibecode/skills/dx-devops-test-suite-assignments-configure.md) — скилл · 5000 установок

Из того же набора: [patricio0312rev/skills](https://affpapa.org/nevibecode/by/patricio0312rev/skills.md) — 26 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md