qa-contract-validate

Validate OpenAPI API contracts with Spectral, oasdiff, Prism, and Schemathesis.

25|1|Updated Jan 29, 2026

Search Tags:#api #validation #contract #spectral #prism #schemathesis #oasdiff

Ready to run

npx skills add https://github.com/parhumm/jaan-to --skill qa-contract-validate

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: qa-contract-validate
Source: https://github.com/parhumm/jaan-to/tree/main/adapters/codex/skillpack/skills/qa-contract-validate
Command: npx skills add https://github.com/parhumm/jaan-to --skill qa-contract-validate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate and enforce OpenAPI contract compliance by running a multi-tool validation pipeline across standards and diff checks, reducing manual review effort.

Core Features & Use Cases

Orchestrates a multi-tool contract validation pipeline (Spectral, oasdiff, Prism, Schemathesis) to lint, diff, conformance check, and fuzz OpenAPI specs.
Supports optional baseline diffs and live API URL validation to detect breaking changes and runtime issues.
Outputs standardized results to the JAAN_OUTPUTS_DIR for easy ingestion, reporting, and indexing.

Quick Start

Provide an OpenAPI spec path and optional baseline and URL to start the contract validation workflow.

Frequently Asked Questions about qa-contract-validate

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

FAQPage Schema

How do I validate an OpenAPI contract against its specification?▼

To validate an OpenAPI contract, provide the specification path to run a multi-tool pipeline. This orchestrates Spectral, oasdiff, Prism, and Schemathesis to lint, diff, conformance check, and fuzz the API spec.

Can I detect breaking changes in my OpenAPI spec using a baseline diff?▼

Yes, you can detect breaking changes by providing an optional baseline OpenAPI specification. The pipeline uses oasdiff to compare the current spec against the baseline and outputs the detected breaking changes.

How do I run conformance and fuzz tests on a live API URL?▼

You can run conformance and fuzz tests on a live API URL by providing it alongside your OpenAPI specification. The pipeline orchestrates Prism and Schemathesis to validate runtime behavior against the contract.

Do I need Spectral, oasdiff, Prism, and Schemathesis installed to use this pipeline?▼

The pipeline orchestrates Spectral, oasdiff, Prism, and Schemathesis when available and enforces tool-availability checks. You receive validation results for any supported tools installed in your environment.

Where are the API contract validation results written?▼

The API contract validation results are written to the JAAN_OUTPUTS_DIR. This standardized output directory allows for easy ingestion, reporting, and indexing of the linting, diff, and conformance findings.

What is the best way to orchestrate multiple API contract validation tools?▼

The best way to orchestrate multiple API contract validation tools is using a phased pipeline with user-approval gating. This coordinates Spectral, oasdiff, Prism, and Schemathesis to enforce OpenAPI compliance with standardized outputs.