# drift-testing

> Claude/Codex skill by [@pactflow](https://omgskills.com/library/pactflow/index.md) · 7 stars · Updated 2026-10-22

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.

Tags: agent-skills, agents, claude-code-plugin, codex-plugin, contract-testing, copilot-cli-plugin, drift, pact, pactflow, skills, swagger-contract-testing

## Install

```sh
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-testing
```

## From 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.

## Links

- HTML page: https://omgskills.com/library/pactflow/pactflow-agent-skills/plugins/swagger-contract-testing/skills/drift-testing/
- GitHub: https://github.com/pactflow/pactflow-agent-skills
- Author: [@pactflow](https://omgskills.com/library/pactflow/index.md)

## More from this repo

- [oas-generator](https://omgskills.com/library/pactflow/pactflow-agent-skills/plugins/swagger-contract-testing/skills/oas-generator/index.md) — Generates an OpenAPI 3.x YAML spec from a provider codebase using ripwire when no spec exists.
   - [@pactflow](https://omgskills.com/library/pactflow/index.md) · 7 stars
- [openapi-parser](https://omgskills.com/library/pactflow/pactflow-agent-skills/plugins/swagger-contract-testing/skills/openapi-parser/index.md) — Parses complex OpenAPI specs and generates Drift test cases from them.
   - [@pactflow](https://omgskills.com/library/pactflow/index.md) · 7 stars
- [pact-coverage](https://omgskills.com/library/pactflow/pactflow-agent-skills/plugins/swagger-contract-testing/skills/pact-coverage/index.md) — Runs a coverage check to find which API operations, status codes, request body required fields, and response body...
   - [@pactflow](https://omgskills.com/library/pactflow/index.md) · 7 stars