Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add borghei/Claude-Skills --skill api-test-suite-builder -a claude-code
Open on GitHub

What 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 vitest scaffold from openapi.json.
  • Measure endpoint coverage using openapi.json and tests/api.
  • Check the responses in responses/ against openapi.json.

How to install api-test-suite-builder

1Skills CLI (Vercel)

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

2Manually: put the files in place

~/.claude/skills/api-test-suite-builder/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/api-test-suite-builder/

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.

api-test-suite-builder Alireza Rezvani api-test-suite-builder is a Claude Code skill that scans API routes and creates tests for them. Ask it to build REST endpoint checks, an integration suite, or contract tests. CX Codex +1 660installs api-test-suite-generator patricio0312rev api-test-suite-generator scans your route definitions and generates API test suites with Jest, Vitest or Supertest. Useful when the endpoints exist but the tests do not. CX Codex +1 319installs k6-docs takuan-osho k6-docs helps assistants write and debug Grafana k6 load tests using current documentation, API syntax, and stage configurations. CX Codex +1 1installs qe-contract-testing proffesor-for-testing qe-contract-testing — a skill for verifying REST, GraphQL, and event-driven API contracts with schema validation. Detects incompatible changes and ensures APIs won't break downstream clients. CX Codex +1 115installs api-reference-quality Samuel Berthe api-reference-quality audits published API references against machine-readable specs and sets up automated CI gates to prevent documentation drift. CX Codex +1 10,500installs api-contract-testing secondsky api-contract-testing verifies API contracts between microservices with consumer-driven tests and OpenAPI schemas, skipping full end-to-end setups. CX Codex +1 498installs k6-perf-test-website grafana k6-perf-test-website scaffolds an end-to-end k6 performance testing suite for public websites with browser checks, protocol load, and generator monitoring. CX Codex +1 3,800installs

From the same set120

The whole set →
executive-mentor executive-mentor challenges strategic plans, exposes blind spots, and prepares founders for tough board inquiries. CX Codex +1 113installs copy-editing copy-editing — a skill for Claude Code, Codex, Cursor and other agents that runs text through seven sequential editorial passes: clarity, voice, benefit framing, proof, specificity, emotional pull, and CTA friction removal. CX Codex +1 113installs context-engine context-engine — a skill for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI that decides what goes into the context window, what gets written to persistent memory, and what is retrieved on demand. CX Codex +1 112installs competitive-teardown The competitive-teardown skill structures competitor research, product scoring, and side-by-side comparisons. Use it to inform a roadmap discussion or prepare sales material. CX Codex +1 112installs brainstorm-okrs brainstorm-okrs — a skill for AI-powered code editors that drafts and validates quarterly OKRs using the Radical Focus method: one objective, three measurable key results, and counter-metrics. CX Codex +1 111installs browser-automation browser-automation is a Claude Code and Codex skill that scaffolds rate-limited Python requests scrapers and form scripts, then audits automation code for server overload and blocking risks. CX Codex +1 111installs social-content social-content is a Claude Code skill that drafts platform-specific social posts and content calendars. Set the platform, goal, and format to shape the result. CX Codex +1 110installs ci-cd-pipeline-builder The ci-cd-pipeline-builder Claude Code skill builds and checks CI/CD pipelines from a project's stack. It helps configure tests, dependency caches, and deployment stages. CX Codex +1 108installs

Project sponsors

Companies that keep this analytics open