validating-api-contracts

## Overview This skill enables Claude to generate and validate API contracts, ensuring compatibility between API providers and consumers. It uses Pact for consumer-driven contract testing and OpenAPI validation for specification compliance. ## How It Works 1. **Generating Contract Tests**: Claude creates Pact consumer tests based on API usage, generating provider verification tests and building OpenAPI contract validators. 2. **Validating Contracts**: The skill verifies if API responses match the defined contracts. 3. **Checking Compatibility**: It checks for backward compatibility to identify breaking changes in the API. ## When to Use This Skill This skill activates when you need to: - Generate contract tests for an API. - Validate API responses against existing contracts. - Identify breaking changes in an API. ## Examples ### Example 1: Generating Pact Contracts User request: "Generate contract tests for my API using Pact." The skill will: 1. Analyze the API and generate Pact consumer contracts. 2. Create provider verification tests based on the contracts. ### Example 2: Validating an OpenAPI Specification User request: "Validate my API against the OpenAPI specification." The skill will: 1. Validate the API against the provided OpenAPI specification. 2. Report any discrepancies or violations of the specification. ## Best Practices - **Clarity**: Be specific when requesting contract generation or validation, providing relevant API details. - **Completeness**: ...