API Test Suite Builder
Scans API route definitions across frameworks (Next.js App Router, Express, FastAPI, Django REST) and auto-generates comprehensive test suites covering auth, input validation, error codes, pagination, file uploads, and rate limiting. Outputs ready-to-run test files for Vitest+Supertest (Node) or Pytest+httpx (Python).
✨ What it does
- Route detection across multiple frameworks
- Auth coverage (valid/invalid/expired tokens, missing header)
- Input validation (missing fields, wrong types, boundaries, injection attempts)
- Error code matrix (400/401/403/404/422/500)
- Pagination and file upload tests
- Rate limiting tests
🎯 When to use it
- New API added — generate test scaffold before writing implementation (TDD)
- Legacy API with no tests — scan and generate baseline coverage
- API contract review — verify existing tests match current route definitions
- Pre-release regression check — ensure all routes have at least smoke tests
- Security audit prep — generate adversarial input tests
🚀 How to use
Trigger by asking to generate API tests, create integration test suites, test REST endpoints, or build contract tests. Provide a codebase path or route definitions. The skill scans source files, extracts routes, and generates test files. Example prompts:
Generate API tests for the Express app in ./src
Create a test suite for the Next.js API routes in ./app/api
📄 Output: Ready-to-run test files (e.g., .test.ts or .test.py) covering auth, validation, errors, pagination, uploads, and rate limiting.
📦 Add this skill to Claude Code
# 1. Get the skills repo
git clone --depth 1 https://github.com/alirezarezvani/claude-skills /tmp/claude-skills
# 2. Copy this skill into your project (or ~/.claude/skills for all projects)
mkdir -p .claude/skills
cp -r /tmp/claude-skills/engineering/skills/api-test-suite-builder .claude/skills/api-test-suite-builderSkill source: engineering/skills/api-test-suite-builder/SKILL.md
⚠️ Good to know
Requires access to the source code of the API to scan routes; assumes standard framework patterns.
❓ FAQ
What frameworks are supported?
Next.js App Router, Express, FastAPI, and Django REST Framework.
What test frameworks are used?
Vitest+Supertest for Node and Pytest+httpx for Python.
Does it test authentication?
Yes, it generates tests for missing, invalid, expired tokens and role-based access.
🤖 Overview, features, install steps and FAQ were generated from the project's SKILL.md on Sep 4, 2026. Always check the original source before running commands.