API Test Suite Builder
Use when the user asks to generate API tests, create integration test suites, test REST endpoints, or build contract tests.
Before & after
Same prompt, same agent — the only difference is the skill.
I can help you build an integration test suite for your REST API. A good suite typically covers: - **Happy path** — each endpoint returns expected results with valid input - **Validation** — invalid input returns appropriate error codes - **Authentication** — protected endpoints reject unauthorized requests - **Edge cases** — empty results, pagination, boundaries - **Error handling** — server errors are handled gracefully You'd want to test status codes, response bodies, and headers. Using a framework like Jest with supertest (Node) or pytest with requests (Python) works well. Can you share your API endpoints or an OpenAPI spec?
Integration test suite — generated per endpoint, and crucially including
the tests people skip because they're tedious, which are the ones that
catch real bugs.
STRUCTURE — per endpoint, not per "feature"
POST /users
✓ 201 + body matches schema on valid input (happy path)
✓ 400 on missing required field (validation)
✓ 400 on wrong type (string where int expected)
✓ 401 without auth token (auth)
✓ 403 with valid token, wrong permissions ← usually skipped
✓ 409 on duplicate email (conflict)
✓ 422 on malformed but well-typed input
GET /users?page=2
✓ pagination returns correct slice + total count
✓ empty result set returns [] not null ← the null bug
✓ out-of-range page returns empty, not error
THE TESTS THAT ACTUALLY FIND BUGS
Happy-path tests pass on day one and rarely fail again. The value is in:
• the 403 case (valid token, wrong role) — the most common real auth
hole, and the most commonly untested
• empty-result shape ("[]" vs "null") — breaks clients silently
• the boundary between 400 and 422 — malformed vs. invalid
These are what I generate by default, because a suite that only tests
happy paths gives false confidence.
CONTRACT TESTS
If you have an OpenAPI spec, I generate tests that assert every response
matches the declared schema — so a backend change that drifts from the
contract fails CI instead of breaking a client in prod.
WHAT I NEED
The endpoints or an OpenAPI spec. With a spec I can generate the full
suite including contract tests; without one I generate from the endpoint
list and you fill in the auth model. Which do you have?About this skill
name: api-test-suite-builder description: Use when Use when the user asks to generate API tests, create integration test suites, test REST endpoints, or build contract tests.
Api Test Suite Builder
Use when the user asks to generate API tests, create integration test suites, test REST endpoints, or build contract tests.
What you get
- Public GitHub repo (alirezarezvani/claude-skills)
- the api-test-suite-builder skill folder with SKILL.md. Part of a 337-skill / 30-agent / 70-command install.
Customize your output
- Fork the repo and adapt the skill's instructions and references to your workflow.
Example output
Activates automatically when your request matches Api Test Suite Builder; chains with the other skills, agents, and commands in the collection.
Best for
Creators, builders, and teams using Claude Code.
SKILL.md preview
---
name: api-test-suite-builder
description: Use this skill when the user asks to generate API tests, create integration test suites, test REST endpoints, or build contract tests.
version: 1.0.0
category: Development / Engineering
author: AgentVolt
license: proprietary
tags:
- development
- engineering
---
# Api Test Suite Builder
Generates integration and contract test suites for REST APIs, covering happy paths, edge cases, and schema validation.
## When to use
… (sign up to view the full skill)More development skills
View all Development skills →Generate
Scaffold code, tests, and boilerplate from a short spec.
Performance Profiler
Systematic performance profiling for Node.js, Python, and Go applications.
Threat Detection
Use when hunting for threats in an environment, analyzing IOCs, or detecting behavioral anomalies in telemetry.
Agent Harness
Turns a domain folder of skills into a bounded agentic loop: compile a goal into a task plan, execute with the domain's tools, verify every task, retry within a budget.