Agent skill

API Test Suite Builder

by borghei in borghei/Claude-Skills

Generate API test suites from route definitions across frameworks: auth, input validation, contract, k6 load testing, mocking, and OpenAPI-driven generation.

MITAuto-check passedTesting & QA

Install API Test Suite Builder

skills CLI
$ npx skills add borghei/Claude-Skills --skill api-test-suite-builder -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install borghei/Claude-Skills api-test-suite-builder --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/engineering/api-test-suite-builder .claude/skills/api-test-suite-builder && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
api-test-suite-builder
GitHub stars
874
Token cost
~1.6k tokens
SKILL.md length
659 words
Files
7 (incl. scripts, references)
Skills in repo
364
Repo updated
First seen
Licence
MIT

At a glance

Generate API test suites from route definitions across frameworks: auth, input validation, contract, k6 load testing, mocking, and OpenAPI-driven generation.

  • Adding new APIs
  • SKILL.md covers Core Capabilities, When to Use, Clarify First and Tools, plus 3 more sections
  • Runs Python scripts from its folder; calls python
  • Auditing test coverage

What it does

API Test Suite Builder is an agent skill from borghei/Claude-Skills. Generate API test suites from route definitions across frameworks: auth, input validation, contract, k6 load testing, mocking, and OpenAPI-driven generation. Use when adding new APIs, auditing test coverage, or building regression suites.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts and reference files (for example `references/contract-and-load-testing.md`, `references/route-detection-and-matrices.md` and `references/workflow-and-quality.md`).

It sits in Testing & QA, covering Load testing, API testing and OpenAPI specifications. It works with OpenAPI. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.

When your agent uses it

  • Adding new APIs
  • Auditing test coverage
  • Building regression suites

Example prompts

  • “/api-test-suite-builder”

Requirements

  • Python 3
  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit c9a1487. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

API Test Suite Builder loads about 1.6k tokens when it runs, and up to ~6.1k if it reads all its reference files. Until then it costs about 65 tokens; SKILL.md has 659 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~65
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from borghei/Claude-Skills at commit c9a1487, republished under its MIT licence (© borghei). 659 words, ~1,573 tokens.

Download SKILL.mdSave it as .claude/skills/api-test-suite-builder/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
api-test-suite-builder
description
Generate API test suites from route definitions across frameworks: auth, input validation, contract, k6 load testing, mocking, and OpenAPI-driven generation. Use when adding new APIs, auditing test coverage, or building regression suites.
license
MIT + Commons Clause
metadata.version
1.1.0
metadata.author
borghei
metadata.category
engineering
metadata.domain
api-testing
metadata.tier
POWERFUL
metadata.updated
2026-06-17
metadata.frameworks
vitest, pytest, supertest, httpx, k6, pact

API Test Suite Builder

Scan API route definitions across frameworks (Next.js App Router, Express, FastAPI, Django REST, Go net/http), analyze request/response schemas, and generate comprehensive test suites covering authentication, authorization, input validation, error handling, pagination, file uploads, rate limiting, contract testing, and load testing. Outputs ready-to-run test files for Vitest+Supertest (Node), Pytest+httpx (Python), or k6 (load testing).

Core Capabilities

  • Route detection & analysis — scan source files to extract endpoints, parse request/response schemas, detect auth middleware and authorization rules across Node, Python, and Go frameworks.
  • Test matrix generation — auth (valid/invalid/expired tokens, wrong roles), input validation (missing/wrong-type/boundary/injection), error paths (400/401/403/404/409/422/429/500), pagination, file uploads, and rate limiting.
  • Contract testing — OpenAPI-to-test generation, Pact consumer-driven contracts, schema snapshot testing for breaking-change detection.
  • Load testing — k6 scripts with ramp-up patterns and SLA thresholds, latency percentile tracking (P50/P95/P99), concurrent user simulation.

When to Use

  • New API added — generate a test scaffold before implementation (TDD).
  • Legacy API with no tests — scan and generate baseline coverage.
  • Pre-release — ensure all routes have at least smoke tests.
  • API contract change — detect and test breaking changes.
  • Security audit — generate adversarial input tests.
  • Performance validation — create load-test baselines.

Clarify First

Before generating the suite, confirm these inputs. If any is unknown or vague, ASK — do not assume:

  • Target framework — Vitest+Supertest, Pytest+httpx, or k6 (determines the emitted test-file format via --framework)
  • Spec or routes source — an OpenAPI spec or the source files to scan (the input the generator parses)
  • Test scope — auth, input validation, contract, load, or the full matrix (which test categories get generated)

Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.

Tools

ToolPurposeCommand
test_generator.pyGenerate API test skeletons from an OpenAPI/Swagger specpython scripts/test_generator.py spec.json --framework vitest --output tests/
coverage_analyzer.pyCompare spec endpoints vs existing test files to find gapspython scripts/coverage_analyzer.py spec.json tests/ --threshold 95
contract_validator.pyValidate response samples against OpenAPI schema contractspython scripts/contract_validator.py spec.json samples/ --strict

References

Load the reference that matches the task — keep this file lean and pull detail on demand:

  • references/route-detection-and-matrices.md — per-framework route-detection shell commands and the full auth / input-validation / pagination test matrices with worked TypeScript examples. Read when scanning a codebase or writing the core test cases.
  • references/contract-and-load-testing.md — complete Pact consumer-driven contract test and k6 load-test scripts, plus the commands to run load tests locally, against staging, and in the cloud. Read when adding contract or performance tests.
  • references/workflow-and-quality.md — the 9-step generation workflow, reusable test-helper patterns (auth, authed request, factories), common pitfalls, best practices, a troubleshooting table, and the success-criteria bar. Read before generating a suite and before shipping it.
Show full SKILL.md (222 more words)Show less

Scope & Limitations

This skill covers:

  • Generating test suites from route definitions for REST APIs across Node.js, Python, and Go frameworks
  • Authentication, authorization, input validation, pagination, and error-path test generation
  • Consumer-driven contract testing with Pact and schema snapshot validation
  • Load and performance testing script generation with k6 and Artillery

This skill does NOT cover:

  • GraphQL API testing (see engineering/api-design-reviewer for schema review patterns)
  • End-to-end browser testing or UI interaction testing (see engineering/playwright-pro)
  • Database migration testing or schema validation (see engineering/database-schema-designer)
  • Security penetration testing beyond input sanitization checks (see engineering/skill-security-auditor)

Integration Points

SkillIntegrationData Flow
engineering/api-design-reviewerValidate API design before generating testsDesign review output defines the endpoint contracts that this skill generates tests for
engineering/ci-cd-pipeline-builderEmbed generated tests into CI/CD pipelinesGenerated test files and k6 scripts are added as pipeline stages with pass/fail gates
engineering/playwright-proComplement API tests with E2E browser testsAPI test suite validates backend behavior; Playwright tests validate the frontend consuming those APIs
engineering/database-schema-designerAlign test fixtures with database schemaSchema definitions inform factory functions and seed data used in generated test helpers
engineering/observability-designerMonitor test-covered endpoints in productionLoad test thresholds (P95, P99) feed into alerting rules for the same endpoints in production dashboards
engineering/performance-profilerInvestigate endpoints that fail load test thresholdsk6 results identify slow endpoints; the profiler skill traces root causes at the code level

© borghei, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (scripts, references) in engineering/api-test-suite-builder of borghei/Claude-Skills.

  • SKILL.md
  • references/contract-and-load-testing.md
  • references/route-detection-and-matrices.md
  • references/workflow-and-quality.md
  • scripts/contract_validator.py
  • scripts/coverage_analyzer.py
  • scripts/test_generator.py

Open the folder on GitHubat commit c9a1487

Compare with similar skills

API Test Suite Builder next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

API Test Suite Builder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
API Test Suite Builder this skillborghei/Claude-Skills874—~1.6kAutomated safety check: PassMIT
703 Technologies Fuzzing Testingjabrena/plinth445—~874Automated safety check: PassApache-2.0
Type Safetyidavidov13/agentic-playwright223—~3.5kAutomated safety check: PassMIT
API Testingidavidov13/agentic-playwright223—~5.7kAutomated safety check: PassMIT
Contextcounterfact/api-simulator170—~384Automated safety check: PassMIT
Test Automationrevfactory/harness-1001.3k—~1.7kAutomated safety check: PassApache-2.0

Similar skills

  • A skill your agent uses when you need to add or review fuzz testing for Java APIs with CATS — including contract-driven negative testing, malformed payload validation, boundary input exploration, CI…

    445 GitHub stars~874 tokensUpdated today
    Testing & QAAuto-check passed
  • Type Safety

    idavidov13/agentic-playwright

    TypeScript type safety conventions for the Playwright scaffold — the "no any" rule, Zod 4 schema patterns (z.strictObject, top-level validators like z.uuid / z.email / z.url / z.int / z.enum)…

    223 GitHub stars~3.5k tokensUpdated 6 days ago
    Testing & QAAuto-check passed
  • API Testing

    idavidov13/agentic-playwright

    API testing patterns for Playwright -- apiRequest fixture usage, Zod response schema creation and validation, test.step wrapping for multi-call tests, per-field negative/validation testing, path…

    223 GitHub stars~5.7k tokensUpdated 6 days ago
    Testing & QAAuto-check passed
  • Context

    counterfact/api-simulator

    Add and evolve Counterfact context classes in .context.ts files, including required unit test coverage for context behavior.

    170 GitHub stars~384 tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Test Automation

    revfactory/harness-100

    A full test automation pipeline. An agent skill from revfactory/harness-100.

    1.3k GitHub stars~1.7k tokensUpdated 6 mo ago
    Testing & QAAuto-check passed
  • Use Yaak

    mountain-loop/yaak

    A skill your agent uses when the user mentions Yaak, a Yaak workspace, or the yaak command, or asks to call, hit, or smoke test HTTP/REST endpoints, save or organize API requests for reuse or manual…

    19k GitHub stars~1.9k tokensUpdated today
    Backend & APIsAuto-check passed

More from borghei/Claude-Skills

All 364 skills in this repo
  • Agents In The Team

    borghei/Claude-Skills

    Run delivery when AI coding and ops agents take tickets. An agent skill from borghei/Claude-Skills.

    874 GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • AI Content Disclosure

    borghei/Claude-Skills

    Check AI-generated marketing content and reviews for required disclosures under the EU AI Act, FTC rules and platform AI-label policies.

    874 GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • AI Prototyping

    borghei/Claude-Skills

    Idea to AI-generated prototype to customer validation to engineering handoff.

    874 GitHub stars~3.6k tokensUpdated today
    Auto-check passed
  • Analytics Engineer

    borghei/Claude-Skills

    Analytics engineering across data modeling, dbt, transformation, and semantic layers.

    874 GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Ansoff Matrix

    borghei/Claude-Skills

    Ansoff Matrix — 4-quadrant framework for growth options: market penetration, market/product development, and diversification.

    874 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Brainstorm Okrs

    borghei/Claude-Skills

    OKR brainstorming and validation using the Radical Focus framework — outcome objectives, measurable key results, counter-metrics.

    874 GitHub stars~1.4k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about API Test Suite Builder

What does API Test Suite Builder do?

Generate API test suites from route definitions across frameworks: auth, input validation, contract, k6 load testing, mocking, and OpenAPI-driven generation. API Test Suite Builder is an agent skill from borghei/Claude-Skills. Generate API test suites from route definitions across frameworks: auth, input validation, contract, k6 load testing, mocking, and OpenAPI-driven generation.

When should I use API Test Suite Builder?

API Test Suite Builder fits situations like: adding new APIs; auditing test coverage; building regression suites.

How do I install API Test Suite Builder in Claude Code?

Run `npx skills add borghei/Claude-Skills --skill api-test-suite-builder -a claude-code`. Or copy the skill folder (engineering/api-test-suite-builder in borghei/Claude-Skills) into .claude/skills/api-test-suite-builder in your project. Claude Code loads it when a task matches its description.

How do I install API Test Suite Builder in Codex?

Run `npx skills add borghei/Claude-Skills --skill api-test-suite-builder -a codex`. Or copy the skill folder (engineering/api-test-suite-builder in borghei/Claude-Skills) into .agents/skills/api-test-suite-builder in your project. Codex loads it when a task matches its description.

Can I use API Test Suite Builder in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add borghei/Claude-Skills --skill api-test-suite-builder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/api-test-suite-builder, .gemini/skills/api-test-suite-builder, .github/skills/api-test-suite-builder and .opencode/skills/api-test-suite-builder in your project.

What does API Test Suite Builder need to run?

Going by SKILL.md and its folder, API Test Suite Builder needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3; Node.js.

Does API Test Suite Builder access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is API Test Suite Builder safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does API Test Suite Builder use?

API Test Suite Builder is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does API Test Suite Builder use?

About 1.6k tokens (SKILL.md is roughly 6.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.6k tokens, read only when the agent opens those files.

What are the alternatives to API Test Suite Builder?

Skills that share tags, products or a category with API Test Suite Builder: 703 Technologies Fuzzing Testing (jabrena/plinth, 445 stars), Type Safety (idavidov13/agentic-playwright, 223 stars), API Testing (idavidov13/agentic-playwright, 223 stars) and Context (counterfact/api-simulator, 170 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains API Test Suite Builder?

borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 874 GitHub stars. The repository holds 364 skills in this directory. The repository was last updated on October 7, 2026.

Source: borghei/Claude-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.