contract-testing SKILL.md skillA

contract-testing from petrkindlmann/qa-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add petrkindlmann/qa-skills/contract-testing@v2.0

Pins v2.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
petrkindlmann/qa-skills
Path
skills/contract-testing/SKILL.md
Versions recorded
5
Latest version
v2.0, committed Jun 10, 2026
First version recorded
Mar 30, 2026
Size
16,577 bytes
Repository stars
198
License
MIT

Implement consumer-driven contract testing with Pact-JS (v16). Covers consumer test writing, broker-driven provider verification, Pact Broker setup, can-i-deploy as a deployment gate, webhook-triggered verification, pending pacts, and schema-first vs consumer-first approaches (OpenAPI/Ajv, Schemathesis). Use when: "contract test," "Pact," "consumer-driven," "API contract," "provider verification," "can-i-deploy." Not for: stubbing or mocking a dependency to isolate a test — use…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

<objective>
A provider renames a response field. Both services pass their own unit tests, and the
mismatch only surfaces in production when the consumer's frontend breaks. Contract testing
catches that in CI: the consumer declares exactly what it needs, the provider verifies it
can deliver, and `can-i-deploy` blocks the deploy until the broker confirms both sides are
compatible. This skill produces Pact consumer tests, broker-driven provider verification,
and the deployment gate that ties them together — so services can be deployed independently
without a shared integration environment.
</objective>

## Discovery Questions

Check `.agents/qa-project-context.md` first — if it exists, use it and skip anything already answered there. Then:

1. **Architecture:** Microservices, monolith with separate consumers (mobile/SPA), or BFF pattern? Contract testing matters most when teams deploy independently.
2. **Who owns the contract?** Consumer-driven (consumers define what they need) or provider-driven (provider publishes a spec)? Most teams benefit from consumer-driven.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add petrkindlmann/qa-skills/contract-testing@sha256:fc69dd9b0e7228f2

The line at the top of this page pins the label v2.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_6a4tzcoalvdayn53.svg)](https://markdownregistry.com/a/art_6a4tzcoalvdayn53)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Mar 30, 2026 and Jun 10, 2026, about one every 18 days.

versioncommittedcommitsizeaudit
v2.0 latest2026-06-10 bcd1201 16,577 BA view · diff
v1.02026-05-30 d9b4edd 11,569 BA view · diff
v1.02026-05-10 483c128 19,590 BA view · diff
v1.02026-05-10 57ced11 18,182 BA view · diff
v1.02026-03-30 59713a4 17,929 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (16577 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

petrkindlmann/qa-skills · 198 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_6a4tzcoalvdayn53
GET https://markdownregistry.com/api/v1/resolve?ref=petrkindlmann/qa-skills/contract-testing
GET https://markdownregistry.com/api/v1/blob/fc69dd9b0e7228f20dc65afdf7e5107ba6b10d02e1417c53c91ebbf9e997b418

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from petrkindlmann/qa-skills

AGENTS.md AGENTS.md file
petrkindlmann/qa-skills · AGENTS.md
git:20261021.03fbcb2 · audit A · 198 stars
CLAUDE.md CLAUDE.md file
petrkindlmann/qa-skills · CLAUDE.md
git:20260323.b54e23c · audit B · 198 stars
accessibility-testing SKILL.md skill
petrkindlmann/qa-skills · skills/accessibility-testing/SKILL.md · Test for WCAG 2.2 AA compliance with axe-core + Playwright, keyboard navigation audits, screen reader testing, ARIA…
v2.0 · audit A · 198 stars
agentic-browser-testing SKILL.md skill
petrkindlmann/qa-skills · skills/agentic-browser-testing/SKILL.md · Goal-driven E2E testing where a browser agent (Playwright MCP / computer-use) reads a natural-language goal and…
v1.0 · audit A · 198 stars
ai-bug-triage SKILL.md skill
petrkindlmann/qa-skills · skills/ai-bug-triage/SKILL.md · Hybrid fingerprint + LLM pipeline for bug classification, deduplication, and ticket generation. Normalizes CI logs…
v2.0 · audit A · 198 stars
ai-qa-review SKILL.md skill
petrkindlmann/qa-skills · skills/ai-qa-review/SKILL.md · Review EXISTING test code for quality, smells, and testability issues. Detects test smells across six dimensions —…
v2.0 · audit A · 198 stars
ai-system-testing SKILL.md skill
petrkindlmann/qa-skills · skills/ai-system-testing/SKILL.md · Test AI/LLM features that ship in your product. Covers prompt regression testing, response quality evaluation…
v2.2 · audit F · 198 stars
ai-test-generation SKILL.md skill
petrkindlmann/qa-skills · skills/ai-test-generation/SKILL.md · Use AI to write NEW test code from specs, PRDs, user stories, code diffs, bug reports, or OpenAPI specs. Staged…
v2.0 · audit A · 198 stars
analytics-tracking-testing SKILL.md skill
petrkindlmann/qa-skills · skills/analytics-tracking-testing/SKILL.md · Validate that analytics and marketing tracking fire CORRECTLY: GA4/GTM dataLayer events, Meta/TikTok/LinkedIn pixels…
v1.1 · audit A · 198 stars
api-testing SKILL.md skill
petrkindlmann/qa-skills · skills/api-testing/SKILL.md · Test REST and GraphQL APIs with Playwright APIRequestContext, Supertest, or standalone HTTP clients. Covers schema…
v2.1 · audit A · 198 stars
bug-reproduction SKILL.md skill
petrkindlmann/qa-skills · skills/bug-reproduction/SKILL.md · Turn a vague bug report into a VERIFIED minimal reproduction and then a failing regression test, agent-driven end to…
v1.0 · audit A · 198 stars
chaos-engineering SKILL.md skill
petrkindlmann/qa-skills · skills/chaos-engineering/SKILL.md · Validate system resilience through controlled fault injection. Covers hypothesis-driven chaos experiments, failure…
v2.0 · audit A · 198 stars

Every file in petrkindlmann/qa-skills

Other files named contract-testing

contract-testing SKILL.md skill
thedaviddias/front-end-checklist · skills/contract-testing/SKILL.md · Use when setting up integration testing for a frontend-backend API boundary, evaluating whether two services are safe…
git:20261004.4b0ddb9 · audit A · 74,516 stars
contract-testing SKILL.md skill
sebastiendegodez/skraft-plugin · plugins/skraft-framework/skills/contract-testing/SKILL.md · Use when authoring OpenAPI/AsyncAPI contracts, generating Microcks samples, setting up Testcontainers mocks, verifying…
git:20261011.2406fc7 · audit A · 12 stars

Browse by kind, by grade A, or by owner.