Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

API Test Suite Builder · borghei | DecimalAI

testingby borghei

API Test Suite Builder

borghei/api-test-suite-builder

Source borghei/claude-skills ↗License NOASSERTION

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

SkillScore77Maintained

Automatic

QA & Test Engineering pack

Last verified 8/20/2026

What it changes

Passed 17 of 22 test cases with the skill, and 11 of 22 without it.

Without skill50%

With skill77%

Checks it passed that the model alone missed

Generates test scripts using Pytest with httpx.
Declines to generate end-to-end browser UI tests.
Lists explicit assumptions at the top of the generated artifact.

and 3 more in the full report

6 fixed11 passed either way5 still failing0 broke

Pass-rate lift: +27 pp
Tokens: +29%
Agent turns: 0%
Response time: -27%

Model gemini-3.6-flashMeasured 8/20/2026v117 of 22 cases passed with skill

Tokens, turns and time describe resource use, not a dollar price.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/borghei-api-test-suite-builder/SKILL.md https://app.decimal.ai/s/borghei-api-test-suite-builder/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add borghei-api-test-suite-builder, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/borghei-api-test-suite-builder/ and pins it in .decimal/skills.lock

decimalai skills add borghei-api-test-suite-builder

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/borghei-api-test-suite-builder/SKILL.md https://app.decimal.ai/s/borghei-api-test-suite-builder/SKILL.md

Raw file: /s/borghei-api-test-suite-builder/SKILL.md ↗ · machine-readable summary at /s/borghei-api-test-suite-builder.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

One of 6 test cases the skill fixed. Same model, same prompt, with and without the skill.

1 of 6

Prompt

We captured HTTP response payloads in `samples/` from our staging server. What CLI command and flag should we run to strictly validate those response JSON samples against `spec.json`?

What was checked, without and with the skill
Checked	Without skill	With skill
Outputs `python scripts/contract_validator.py spec.json samples/ --strict`.	Missed	Passed

case-09 · gemini-3.6-flash · 8/20/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md70 lines7 filesincludes scripts

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

Tool	Purpose	Command
`test_generator.py`	Generate API test skeletons from an OpenAPI/Swagger spec	`python scripts/test_generator.py spec.json --framework vitest --output tests/`
`coverage_analyzer.py`	Compare spec endpoints vs existing test files to find gaps	`python scripts/coverage_analyzer.py spec.json tests/ --threshold 95`
`contract_validator.py`	Validate response samples against OpenAPI schema contracts	`python scripts/contract_validator.py spec.json samples/ --strict`

References

Track record

Benchmark

17 / 22

test cases passed, vs 11 / 22 without

Adoption

Users: 0
Times used: 0

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan14 of 15 checks clean

0 critical · 0 warning · 2 info — scanner v4 — 8/3/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

No issues (informational notes only).

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

borghei / claude-skills

engineering/api-test-suite-builder/SKILL.md

View on GitHub ↗

License MIT + Commons ClauseImported 8/3/2026Version v1Bundled 6 files · scripts

Other skills for the same job

Published skills whose descriptions closely match this one, with their headline benchmark lift.

api-test-suite-builderAPI Test Suite BuilderClose match+5 pp pass-rate lift

More skills from the same source and nearby in the registry, with their headline benchmark lift.

Ready to supercharge your AI agents?

See it in action

What's inside

API Test Suite Builder

Core Capabilities

When to Use

Clarify First

Tools

References

Track record

Benchmark

Adoption

SkillSafety

Source

Other skills for the same job

Related skills