contracts

Generate and validate OpenAPI and JSON Schema API contracts.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/nist0/CoDev --skill contracts-nist0
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: contracts
Source: https://github.com/nist0/CoDev/tree/main/.github/skills/contracts
Command: npx skills add https://github.com/nist0/CoDev --skill contracts-nist0

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openapi, jsonschema, pact, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Ensures consistent communication between backend and frontend systems through robust API contracts, facilitating easier maintenance and upgrades over time.

Core Features & Use Cases

  • Contract Ownership & Versioning: Defines ownership, compatibility, and schema standards for API contracts.
  • Schema Generation: Automates client code generation based on OpenAPI/JSON Schema specifications.
  • Validation & Testing: Provides guidelines for validation, testing, and maintenance of API contracts.

Quick Start

Generate a contract for the 'User Management' API using the 'contracts' skill and follow the guidelines outlined in the SKILL.md file.

Frequently Asked Questions about contracts

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

FAQPage Schema
How do I maintain stable API contracts for full-stack integration?

Stable API contracts are maintained by defining schema standards, ownership, and compatibility rules between backend and frontend systems. This Skill automates schema generation and contract validation using OpenAPI and JSON Schema to ensure consistent communication.

How do I automate client code generation from OpenAPI specifications?

Automating client code generation from OpenAPI specifications requires defining robust schema standards first. This Skill provides scripts and references to generate client-side code directly from your API contracts, facilitating easier full-stack integration.

What is API contract validation and how does it work with JSON Schema?

API contract validation verifies that backend and frontend systems communicate consistently according to predefined schemas. Using JSON Schema and Pact, this Skill provides testing and maintenance guidelines to validate API contracts during full-stack development.

Do I need experience with OpenAPI and JSON Schema to use API contract versioning?

Yes, using API contract versioning effectively requires knowledge of OpenAPI and JSON Schema formats, along with client-side development practices. This Skill targets advanced implementation depth for full-stack API development.

What is the best way to handle API versioning and compatibility for full-stack applications?

Handling API versioning effectively requires defining contract ownership, compatibility rules, and schema standards upfront. This Skill provides guidelines for validation and maintenance, ensuring easier upgrades and consistent full-stack integration over time.