# Testing Contract

> Verify provider-consumer API contract compatibility and versioning; not ad-hoc endpoint behavior checks Use when this capability is needed.

- Skill: `tomevault-io/testing-contract` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/testing-contract`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/testing-contract/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/testing-contract

---


<input_requirements>
  <required>Providers and consumers (consumer/provider)</required>
  <required>Contract source (OpenAPI/Pact) and version</required>
  <required>Environments for provider and consumer verification</required>
  <optional>Versioning and compatibility rules</optional>
  <optional>List of critical contracts and endpoints</optional>
</input_requirements>

<design_rules>
  <rule importance="critical">The contract specifies required and optional fields</rule>
  <rule importance="high">The contract includes success and error responses</rule>
  <rule importance="high">Contract changes are versioned</rule>
  <rule importance="medium">The contract contains no secrets or real data</rule>
</design_rules>

<execution_rules>
  <rule importance="critical">The provider passes contract verification</rule>
  <rule importance="high">Consumer expectations are verified automatically</rule>
  <rule importance="high">Backward compatibility is verified on changes</rule>
  <rule importance="high">Contract and service versions are recorded</rule>
  <rule importance="medium">Failures are classified as breaking/non-breaking</rule>
</execution_rules>

<coverage>
  <focus>
    <item>Required fields and data types</item>
    <item>Optional fields and default values</item>
    <item>Error codes and error format</item>
    <item>Pagination/sorting/filtering</item>
    <item>Authorization and access control</item>
  </focus>
</coverage>

<quality_rules>
  <rule importance="critical">All checks are reproducible and documented</rule>
  <rule importance="high">There is a link between the contract and the test/check</rule>
  <rule importance="high">Results include contract versions and identifiers</rule>
  <rule importance="medium">Artifacts are recorded (reports/logs)</rule>
</quality_rules>

<do_not>
  <item importance="critical">Do not publish contracts without passing verification</item>
  <item importance="high">Do not mix consumer and provider environments</item>
  <item importance="high">Do not accept breaking changes without bumping the version</item>
</do_not>

<example_checks>
  <check>Verify that the provider returns required fields per contract</check>
  <check>Verify error format and response codes</check>
</example_checks>

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/ozerohax) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->