skills.rest
monobaselabs
monobaselabsOFFICIAL
Explore all skills by this author →
GitHub

test-contract

Run the Monobase contract suite against an HTTP server to validate OpenAPI conformance.

Updated Apr 6, 2026
Search Tags:#api#bun#contract-testing#hurl#schemathesis#wire-shape
One-click install
npx skills add https://github.com/monobaselabs/monobase-js --skill test-contract-monobaselabs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: test-contract
Source: https://github.com/monobaselabs/monobase-js/tree/main/.claude/skills/test-contract
Command: npx skills add https://github.com/monobaselabs/monobase-js --skill test-contract-monobaselabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Black-box wire-shape tests that any implementation of the Monobase API must pass — the source of truth for API behavior. The suite is implementation-agnostic: it runs against whatever HTTP server is on $API_URL.

Core Features & Use Cases

  • Verify wire-shape conformance across server implementations (Rust, Go, Python, etc.)
  • Detect regressions in the auto-expand contract, error envelope, and pagination shape
  • Simplify onboarding of new API servers by reusing existing .hurl scenarios

Quick Start

Boot the API server and run the contract test suite against the running instance

Frequently Asked Questions about test-contract

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate API wire-shape conformance across different server implementations?▼

Contract testing detects API regressions by running implementation-agnostic scenarios against a live server, verifying that error envelopes, pagination shapes, and auto-expand behaviors remain stable across changes.

Can I use Schemathesis and Bun to run contract tests on any HTTP server?▼

Yes, you can use Schemathesis and Bun to run contract tests against any HTTP server exposing the OpenAPI-defined endpoints, provided the server is running at the designated API_URL.

What is wire-shape contract testing and when do I need it for my API?▼

Wire-shape contract testing is a black-box testing method that validates API behavior conformance without knowing the internal implementation. You need it to guarantee API compatibility across multiple server implementations like Rust, Go, or Python.

How do I run .hurl scenarios to test API error envelopes and pagination?▼

You run .hurl scenarios by booting your API server and executing the contract test suite locally, which applies pre-defined Hurl scenarios to validate error envelopes and pagination shapes against the target server.

Do I need a running server to execute OpenAPI endpoint contract tests?▼

Yes, you need a running server at the designated API_URL to execute OpenAPI endpoint contract tests, because the suite performs black-box validation by sending HTTP requests to the live target server.

What are the limitations of black-box API wire-shape validation?▼

Black-box API wire-shape validation focuses solely on external HTTP behavior like wire-shape and error envelopes, meaning it does not test internal server logic, state management, or performance under load.

Related Skills

Explore More Software Engineering Skills→
MadAppGangMadAppGang
7

bunjs

Develop TypeScript backend services with Bun, Hono, Prisma, and Zod.

Official
Advanced
cosmicstack-labscosmicstack-labs
364

api-testing

Validate REST and GraphQL APIs against OpenAPI schemas and contracts.

Official
Intermediate
vibbsvibbs
6

api-tester-playbook

Generate API testing playbooks for contract, authentication, pagination, and error handling.

Community
Advanced
eng-vmessiaheng-vmessiah
2

ai-regression-testing

Automate regression tests validating API response shapes and state integrity.

Community
Intermediate