api-test-suite-builder

npx skills add alirezarezvani/claude-skills --skill api-test-suite-builder --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# API Test Suite Builder **Tier:** POWERFUL **Category:** Engineering **Domain:** Testing / API Quality --- ## Overview 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). --- ## Core Capabilities - **Route detection** — scan source files to extract all API endpoints - **Auth coverage** — valid/invalid/expired tokens, missing auth header - **Input validation** — missing fields, wrong types, boundary values, injection attempts - **Error code matrix** — 400/401/403/404/422/500 for each route - **Pagination** — first/last/empty/oversized pages - **File uploads** — valid, oversized, wrong MIME type, empty - **Rate limiting** — burst detection, per-user vs global limits --- ## When to Use - 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 regre

Find all route handlers
find ./app/api -name "route.ts" -o -name "route.js" | sort
Extract HTTP methods from each route file
grep -rn "export async function\|export function" app/api/**/route.ts | \
grep -oE "(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)" | sort -u
Full route map
find ./app/api -name "route.ts" | while read f; do
grep -oE "(GET|POST|PUT|PATCH|DELETE)")
echo "$methods $route"
done