api-test-suite-builder · borghei — Claude Code skill for API tests and setup
api-test-suite-builder is a Claude Code skill that creates API test scaffolds from OpenAPI and checks endpoint coverage. Use it to add tests, audit assertions, or spot contract drift.
LicenseRef-MIT-Commons-Clause 111 installs ★ 1,183 updated 2026-11-08
npx skills add borghei/Claude-Skills --skill api-test-suite-builder -a claude-codeWhat api-test-suite-builder does
The skill scans API routes and inspects request and response schemas. From a specification or source files, it creates test files for authentication, validation, error cases, and contracts. It can also produce k6 load-test scripts.
Three scripts handle the work: test_generator.py creates scaffolds, coverage_analyzer.py counts called endpoints and those with body or header assertions, and contract_validator.py compares saved responses with the schema. Specs must be JSON; supported formats are OpenAPI 3.x and Swagger 2.0. The scripts run with Python.
A generated scaffold does not establish that a response is correct: body checks contain TODOs, and the coverage analyzer counts only body or header assertions. Contract checks need response samples. The scripts return an error when a spec or JSON file cannot be read.
What it helps with
- generate test scaffolds from an OpenAPI spec
- find endpoints whose tests lack response assertions
- compare saved API responses with their schemas
- create authentication and validation error tests
Example prompts for the agent
- Generate a
vitestscaffold fromopenapi.json. - Measure endpoint coverage using
openapi.jsonandtests/api. - Check the responses in
responses/againstopenapi.json.
How to install api-test-suite-builder
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill api-test-suite-builder -a claude-code2Manually: put the files in place
~/.claude/skills/api-test-suite-builder/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/api-test-suite-builder/
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill api-test-suite-builder -a codex2Manually: put the files in place
.agents/skills/api-test-suite-builder/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill api-test-suite-builder -a cursor2Manually: put the files in place
.cursor/skills/api-test-suite-builder/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install borghei/Claude-Skills engineering/api-test-suite-builder/SKILL.md2Manually: put the files in place
.github/skills/api-test-suite-builder/SKILL.md1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill api-test-suite-builder -a gemini-cli2Platform CLI
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/api-test-suite-builderManually: put the files in place
.devin/skills/api-test-suite-builder/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill api-test-suite-builder -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about api-test-suite-builder
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. The skill file is at ~/.claude/skills/api-test-suite-builder/SKILL.md.
What does api-test-suite-builder do?
It builds API test scaffolds from OpenAPI specs or route source files, measures endpoint coverage, and checks response samples against the spec.
Which specification formats does api-test-suite-builder accept?
Its scripts read JSON specs in OpenAPI 3.x or Swagger 2.0 format. They run with Python.
Similar skills
All skills for Testing and QA →api-test-suite-builder by other authors comes first.