Skip to content

JPeetz/agent-skills / skills/qa-testing/contract-testing

contract-testing

Verified

Use 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.

FileKindSize
CHANGELOG.mdmarkdown2.3 KB
LICENSEother1.0 KB
SKILL.mdskill md23.3 KB
evals/evals.jsonconfig2.2 KB
references/sources.mdmarkdown5.1 KB
scripts/pact_ci_gate.shexecutablescript2.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.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall