drift-testing
Verifies API implementations against OpenAPI specifications using the Drift CLI, catching spec drift and supporting Bi-Directional Contract Testing (BDCT). Use when the user mentions Drift, API contract testing, provider contract testing, provider verification, spec drift, API conformance testing, OpenAPI verification, BDCT, drift expressions, drift datasets, drift lifecycle hooks, or Lua scripting in a testing context. Use when the user asks to write, run, or debug Drift test cases. Use when the user wants to test their API against an OpenAPI spec, generate tests from an OpenAPI spec, or check whether their API has drifted from its spec. Use when the user wants full endpoint coverage, wants all tests to pass, or asks to "keep running until everything passes". Also use when the user mentions AsyncAPI, event-driven API testing, Kafka contract testing, SNS or SQS testing, async message contracts, or wants to verify that a service publishes or consumes messages matching an AsyncAPI spec.
Install
With your agent
Install OMGSkills skill "pactflow/pactflow-agent-skills:plugins/swagger-contract-testing/skills/drift-testing" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
git clone https://github.com/pactflow/pactflow-agent-skills /tmp/pactflow-agent-skills && ln -s /tmp/pactflow-agent-skills/plugins/swagger-contract-testing/skills/drift-testing ~/.claude/skills/drift-testingFrom README
Drift Skill Never modify the openapi spec that you are testing. Reference Files references/test-cases.md — Full test case YAML schema, all patterns, datasets, expressions references/auth.md — Authentication config, dynamic tokens, non-standard schemes, 401/403 testing references/mock-server.md — Local testing with Prism: , Prefer header, spec quality issues references/lua-api.md — Complete Lua API: lifecycle events, http(), dbg(), exported functions references/cli-reference.md — All CLI commands/flags, configuration, parallel execution, exit codes references/pactflow-and-cicd.md — BDCT publishing workflow, GitHub Actions, GitLab CI Scripts scripts/extractendpoints.py — Reads the spec and outputs all operations + response codes. Summary mode flags parameters with no spec example. Scaffold mode (--scaffold) emits a ready-to-fill operations: YAML block with correct auth patterns, nil UUIDs for 404s, ignore.schema for 4xx, and FILLIN markers.
More from this repo
oas-generator
Generates an OpenAPI 3.x YAML spec from a provider codebase using ripwire when no spec exists.
openapi-parser
Parses complex OpenAPI specs and generates Drift test cases from them.
pact-coverage
Runs a coverage check to find which API operations, status codes, request body required fields, and response body...