Api Contract Validator
Automatically validate OpenAPI specs, detect breaking changes, and sync API implementation with documentation.
Free
Works with the AI tools you already use
Claude Code
Cursor
Codex CLI
GitHub Copilot
Gemini CLI+18 moreClaude CodeCursorCodex CLIGitHub CopilotGemini CLI
VS Code
OpenClaw
Windsurf
Manus+14 agentsapi-contract-validator
Example session with this skill installed
Can you check if my recent changes to openapi.yaml introduced any breaking changes and run the spectral linter?
- Read your context and instructions
- Compiled the api-contract-validator
- Generated the UI component
[oasdiff] 2 breaking changes detected in openapi.yaml:
- Removed property 'user_id' from response body of GET /users/{id}
- Changed type of 'created_at' from 'string' to 'integer' in schema 'User'
[spectral] 1 error: info-contact must be present.
Validation failed. Review the diff before merging.
api-contract-validator.tsx
TSX · React component
Example file from a real run - the skill writes it into your workspace.
Connects securely to your tools. The creator never sees your data.
About this skill
What it does
The API Contract Validator ensures your API implementation stays perfectly in sync with its OpenAPI/Swagger specification. It acts as a guardrail for your API ecosystem, catching schema mismatches, linting errors, and accidental breaking changes before they disrupt your frontend or mobile consumers.
Why use this skill
Manually checking that every endpoint, request body, and status code matches a YAML file is error-prone and tedious. This skill automates that process by:
- Linting: Validating that your spec follows industry standards using Spectral or Redocly.
- Runtime Checks: Verifying real server responses against the spec using Dredd or language-specific middleware.
- Diffing: Analyzing changes between spec versions to flag breaking changes like removed fields or changed types.
- CI/CD Integration: Providing ready-to-use configurations for GitHub Actions and GitLab CI.
Supported Tools & Frameworks
It supports the most popular ecosystems out of the box, including Spectral, Redocly, oasdiff, and Dredd. For implementation-specific validation, it provides guidance for Express (Node.js), FastAPI/Flask (Python), and Go. The skill produces actionable reports, JUnit XML for CI pipelines, and markdown diffs that clearly highlight exactly what changed in your API contract.
How to install
Works the same in every agent - Claude, Cursor, Codex, Copilot and 20+ more.
- 1
Download the ZIP
Free skills download straight away. Paid skills unlock right after purchase.
- 2
Unzip into your skills folder
Every agent reads skills from one folder on your machine. Drop the unzipped folder in there.
- 3
Ask your agent to use it
Restart the agent if it was already running. It picks the skill up automatically - no config needed.
Skills folder by agent
Click the path to copy it. Create the folder if it does not exist yet.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill passes our trust checks below.
Security scanned
Passed our 8-point scan before listing
4 installs
Downloaded by developers to date
Free forever
No account required to browse
Trust & safety
Security scanned
Verified clean 3 months ago
- Free to download with an account