aws-contract-testing

Generate offline contract tests for AWS services from OpenAPI, SAM, and CloudFormation specs.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/whitewhiteqq/claude-aws-test-plugin --skill aws-contract-testing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aws-contract-testing
Source: https://github.com/whitewhiteqq/claude-aws-test-plugin/tree/main/skills/aws-contract-testing
Command: npx skills add https://github.com/whitewhiteqq/claude-aws-test-plugin --skill aws-contract-testing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the validation of API schemas and Step Function contracts, ensuring your AWS services adhere to their defined specifications without requiring live deployments.

Core Features & Use Cases

  • Schema Validation: Verifies request and response shapes against OpenAPI/Swagger specs, SAM, and CloudFormation definitions.
  • Contract Enforcement: Checks for required fields, enum constraints, and security definitions.
  • Step Function Validation: Generates tests for Step Function input and output contracts.
  • Use Case: Before deploying a new API Gateway endpoint, use this Skill to run contract tests against its OpenAPI specification to catch schema mismatches and ensure all required fields are present.

Quick Start

Use the aws-contract-testing skill to generate contract tests for the swagger.yml file.

Frequently Asked Questions about aws-contract-testing

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

FAQPage Schema
How do I validate an OpenAPI schema for AWS API Gateway without deploying?

You can validate OpenAPI schemas offline by generating contract tests that check request and response shapes, required fields, and security definitions against your specification without requiring live AWS deployments.

What is contract testing for AWS Step Functions and how does it work?

Step Function contract testing validates input and output contracts using jsonschema and pydantic, ensuring your state machine data adheres to defined schemas and required field constraints before deployment.

Can I test SAM and CloudFormation definitions for schema mismatches offline?

Yes, you can analyze SAM and CloudFormation definitions to verify request and response shapes, enforce enum constraints, and validate security definitions entirely offline.

Do I need a live AWS environment to run API contract tests?

No, you do not need a live AWS environment because this offline validation approach analyzes API specifications directly to catch schema mismatches and ensure required fields are present.

How do I generate contract tests for my swagger.yml file?

You generate contract tests for swagger.yml by analyzing the OpenAPI specification to validate schemas, request and response shapes, required fields, and security definitions using jsonschema and pydantic.