JPeetz/agent-skills / skills/qa-testing/contract-testing
contract-testing
VerifiedUse this skill when implementing or maintaining consumer-driven contract tests — Pact contract testing, provider verification, API drift detection, consumer-driven contracts, Pact Broker integration, can-i-deploy gates, bi-directional contract testing (BDCT), OpenAPI spec conformance testing, and webhook/event contract testing.
| File | Kind | Size |
|---|---|---|
| CHANGELOG.md | markdown | 2.3 KB |
| LICENSE | other | 1.0 KB |
| SKILL.md | skill md | 23.3 KB |
| evals/evals.json | config | 2.2 KB |
| references/sources.md | markdown | 5.1 KB |
| scripts/pact_ci_gate.shexecutable | script | 2.5 KB |
CHANGELOG.md
View on GitHub# Changelog — Contract Testing Agent Skill
All notable changes to this skill package will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
---
## v1.0.0 — 2026-11-13
### Added
- Initial release by Skill Foundry.
- Consumer-driven contract testing principles: consumer defines the contract, pairwise scoping, assert-only-what-you-consume.
- Pact consumer test patterns in JavaScript/TypeScript (`PactV3` + `MatchersV3`), JVM (JUnit 5 `PactDslWithProvider`), and Python.
- Provider verification patterns: JS `Verifier` with `stateHandlers`, JVM `@Provider` / `PactBroker` / `PactVerificationContext`, plus a verification checklist.
- Pact Broker operations: docker setup, `pact-broker publish`, branch support, retention policy, webhook triggers, pacticipant naming rules.
- `can-i-deploy` deployment gates with pipeline ordering, `record-deployment` / `record-release`, environment vs legacy tag usage.
- API drift detection and OpenAPI conformance testing with the Drift CLI (`drift.yaml`, `drift verify --generate-result`).
- Bi-directional contract testing (BDCT): drift self-verification, `pactflow publish-provider-contract`, cross-contract `can-i-deploy`, and decision criteria for when BDCT fits.
- Event-driven contract testing: `MessageConsumerPact` / `asynchronousBodyHandler` for async messaging, `@PactVerifyProvider` on the provider side.
- Webhook contract testing: modeling outbound calls as pacts, signature-header regex matching, idempotency and retry semantics.
- CI/CD integration patterns: split consumer/provider/deploy pipelines, webhook-triggered verification, pending and WIP pacts, fail-loud config checks.
- Common pitfalls table (12 entries) covering exact-value assertions, shared mutable test data, `{ all: true }` selectors, tag-based environments, and slow suites.
- Verification checklist for auditing an existing contract-testing setup.
- `scripts/pact_ci_gate.sh` — config-validated `can-i-deploy` gate with actionable failure output.
- `references/sources.md` — Pact, Pact Broker, can-i-deploy, Drift, BDCT, and messaging documentation links.
- 3 eval scenarios covering gate diagnosis, matcher fragility, and BDCT adoption.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |