{"id":49240220,"url":"https://github.com/pactflow/pactflow-agent-skills","last_synced_at":"2026-04-24T19:05:15.322Z","repository":{"id":350094947,"uuid":"1156068584","full_name":"pactflow/pactflow-agent-skills","owner":"pactflow","description":"Plugins \u0026 Agent Skills for Pactflow \u0026 Drift","archived":false,"fork":false,"pushed_at":"2026-04-17T05:22:47.000Z","size":194,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-17T06:21:39.566Z","etag":null,"topics":["claude-code-plugin","contract-testing","copilot-cli-plugin","drift","pact","pactflow","skills","swagger-contract-testing"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pactflow.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-12T08:16:39.000Z","updated_at":"2026-04-17T05:22:50.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/pactflow/pactflow-agent-skills","commit_stats":null,"previous_names":["pactflow/pactflow-agent-skills"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/pactflow/pactflow-agent-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pactflow%2Fpactflow-agent-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pactflow%2Fpactflow-agent-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pactflow%2Fpactflow-agent-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pactflow%2Fpactflow-agent-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pactflow","download_url":"https://codeload.github.com/pactflow/pactflow-agent-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pactflow%2Fpactflow-agent-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32236772,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T13:21:15.438Z","status":"ssl_error","status_checked_at":"2026-04-24T13:21:15.005Z","response_time":64,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code-plugin","contract-testing","copilot-cli-plugin","drift","pact","pactflow","skills","swagger-contract-testing"],"created_at":"2026-04-24T19:05:11.723Z","updated_at":"2026-04-24T19:05:15.316Z","avatar_url":"https://github.com/pactflow.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PactFlow Agent Skills\n\nAgent skills teach your AI coding assistant — Claude Code, GitHub Copilot, Cursor, Windsurf, and others — how to work with Pact, PactFlow, and Drift. Instead of explaining contract testing concepts every time you start a conversation, the skills give your AI persistent, deep knowledge of consumer test patterns, provider verification, can-i-deploy diagnostics, Drift test authoring, and workspace management.\n\nThe plugin goes further: it bundles the [SmartBear MCP server](docs/ai-tools/smartbear-mcp.md) alongside the skills, so your assistant can connect directly to your PactFlow workspace or Pact Broker. It can fetch live provider states before generating tests, query the contract matrix to diagnose a failing can-i-deploy, publish pacts and provider contracts, record deployments, and manage environments — all without leaving your editor.\n\nThere are two types of components in this repo. **Skills** are context files that activate when the task matches — the assistant reads them and applies the knowledge. **Agents** are autonomous sub-tasks the PactFlow skill delegates to: generating tests, reviewing them for best-practice violations, running a full BDCT flow end-to-end, or auditing workspace health.\n\n| Plugin name                | Skills / Agents        | What it does                                                                                                                                                                                                                                                                                                                                   |\n| -------------------------- | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `swagger-contract-testing` | **Drift**              | Expert assistant for Drift — PactFlow's OpenAPI contract testing CLI. Helps write test cases, configure lifecycle hooks, debug failures, and publish results to PactFlow.                                                                                                                                                                      |\n|                            | **OpenAPI Parser**     | Parses complex OpenAPI specs (anyOf/oneOf/allOf, discriminators, polymorphism, $ref chains, enums, regex) and generates Drift test cases covering every viable schema combination.                                                                                                                                                             |\n|                            | **PactFlow**           | Expert assistant for PactFlow and Pact contract testing. Uses the SmartBear MCP `contract-testing_*` tools to generate and review Pact tests with AI, publish contracts, verify providers, run can-i-deploy checks, record deployments, and manage the full PactFlow workspace (environments, pacticipants, BDCT, webhooks, secrets, metrics). |\n|                            | **pact-generator**     | Agent: generates new Pact consumer tests and provider state handlers from existing code, OpenAPI specs, or example request/response pairs.                                                                                                                                                                                                     |\n|                            | **pact-reviewer**      | Agent: reviews Pact consumer tests and provider verification code for best-practice violations, false positives, and provider state naming issues.                                                                                                                                                                                             |\n|                            | **pact-implementor**   | Agent: builds a new Pact client library from scratch in any language by wrapping the Pact FFI.                                                                                                                                                                                                                                                 |\n|                            | **pact-maintainer**    | Agent: audits PactFlow workspace health, fixes failing verifications, and cleans up stale pacticipants, branches, and environments.                                                                                                                                                                                                            |\n|                            | **bdct-tester**        | Agent: drives a full Bi-Directional Contract Testing flow end-to-end — consumer tests, provider contract verification, publishing, and can-i-deploy.                                                                                                                                                                                          |\n\nThe three skills work together: **OpenAPI Parser** analyses a spec and generates Drift test scaffolding; **Drift** runs, iterates, and publishes those tests; **PactFlow** manages the full contract testing lifecycle — from generating Pact tests with AI to safely deploying services. The agents handle specialised sub-tasks autonomously within the PactFlow skill.\n\n**Further reading:** [PactFlow Skill](docs/ai-tools/pactflow-skill.md) · [SmartBear MCP](docs/ai-tools/smartbear-mcp.md) · [Kiro Power](docs/ai-tools/kiro-power.md)\n\n---\n\n## Installation guide for Agentic IDEs/Coding agents\n\n- [Quick install with `npx skills`](#quick-install-with-npx-skills)\n- [Claude Code](#installing-in-claude-code)\n- [OpenCode](#installing-in-opencode)\n- [GitHub Copilot (VS Code)](#installing-in-github-copilot-vs-code)\n- [GitHub Copilot CLI](#installing-in-github-copilot-cli)\n- [Cursor](#installing-in-cursor)\n- [Windsurf](#installing-in-windsurf)\n- [Codex](#installing-in-codex)\n- [Kiro](#installing-in-kiro)\n- [Antigravity](#installing-in-antigravity)\n\n## Quick install with `npx skills`\n\nThe [`skills` CLI](https://skills.sh) installs agent skills from GitHub directly into your project. It auto-detects which agentic coding tools you use and places the skill files in the correct location for each one.\n\n```bash\nnpx skills add pactflow/pactflow-agent-skills\n```\n\nThis installs the `swagger-contract-testing` skills for all detected agents in your project (Claude Code, Copilot, Cursor, Windsurf, Kiro, Codex, OpenCode, Antigravity, and more).\n\n---\n\n### Windows users\n\nThe install commands throughout this guide use Unix shell syntax. In PowerShell, replace:\n\n| Unix                                                                  | PowerShell                                                                           |\n| --------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |\n| `mkdir -p path/to/dir`                                                | `New-Item -ItemType Directory -Force -Path path\\to\\dir`                              |\n| `cp -r plugins/swagger-contract-testing/skills/drift-testing path/to/dir` | `Copy-Item -Recurse plugins\\swagger-contract-testing\\skills\\drift-testing path\\to\\dir` |\n\n`~` (home directory) works in PowerShell 3+. In older environments use `$HOME` instead.\n\n---\n\n## Installing in Claude Code\n\nClaude Code supports [Skills](https://code.claude.com/docs/en/skills) via a plugin marketplace system. Requires Claude Code v1.0.33+.\n\n### From Anthropic's community marketplace (recommended)\n\nThe plugin is listed in Anthropic's official community plugins marketplace. Add the marketplace and install in two commands:\n\n**1. Add the Anthropic community marketplace:**\n\n```bash\nclaude plugin marketplace add anthropics/claude-plugins-community\n```\n\n**2. Install the plugin:**\n\n```bash\nclaude plugin install swagger-contract-testing@claude-community\n```\n\nAlternatively, open the **`/plugin`** panel in Claude Code, navigate to **Discover**, search for `swagger-contract-testing`, and click **Install**.\n\n**3. Configure your PactFlow credentials:**\n\nAdd a `pluginConfigs` block to `~/.claude/settings.json` with your PactFlow base URL and API token:\n\n```json\n{\n  \"pluginConfigs\": {\n    \"swagger-contract-testing@claude-community\": {\n      \"options\": {\n        \"pact_broker_base_url\": \"https://yourorg.pactflow.io\",\n        \"pact_broker_token\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\nGet your API token from `https://yourorg.pactflow.io/settings/api-tokens`. For an open-source Pact Broker, use `pact_broker_username` and `pact_broker_password` instead of `pact_broker_token`.\n\nThen reload the plugin to start the MCP server:\n\n```claude\n/reload-plugins\n```\n\n### From the PactFlow repo (for teams who want to pin a version)\n\n**1. Add the marketplace** inside a Claude Code session:\n\n```claude\n/plugin marketplace add pactflow/pactflow-agent-skills\n```\n\nOr add it to `.claude/settings.json` so teammates are prompted to install it automatically when they open the project:\n\n```json\n{\n  \"extraKnownMarketplaces\": {\n    \"pactflow-agent-skills\": {\n      \"source\": {\n        \"source\": \"github\",\n        \"repo\": \"pactflow/pactflow-agent-skills\"\n      }\n    }\n  }\n}\n```\n\n**2. Install the plugin:**\n\n```claude\n/plugin install swagger-contract-testing@pactflow-agent-skills\n```\n\n**Scope options:**\n\n| Scope            | Stored in                     | Who it applies to                       |\n| ---------------- | ----------------------------- | --------------------------------------- |\n| `user` (default) | `~/.claude/settings.json`     | You, across all projects                |\n| `project`        | `.claude/settings.json`       | Everyone on the team (commit this file) |\n| `local`          | `.claude/settings.local.json` | You, in this project only (gitignored)  |\n\n**3. Configure your PactFlow credentials:**\n\nAdd a `pluginConfigs` block to `~/.claude/settings.json` with your PactFlow base URL and API token:\n\n```json\n{\n  \"pluginConfigs\": {\n    \"swagger-contract-testing@pactflow-agent-skills\": {\n      \"options\": {\n        \"pact_broker_base_url\": \"https://yourorg.pactflow.io\",\n        \"pact_broker_token\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\nGet your API token from `https://yourorg.pactflow.io/settings/api-tokens`. For an open-source Pact Broker, use `pact_broker_username` and `pact_broker_password` instead of `pact_broker_token`.\n\nThen reload the plugin to start the MCP server:\n\n```claude\n/reload-plugins\n```\n\n### From a local clone\n\n```claude\n/plugin marketplace add ./path/to/pactflow-agent-skills/.claude-plugin/marketplace.json\n/plugin install swagger-contract-testing@pactflow-agent-skills\n```\n\n### For local development (no marketplace needed)\n\n```bash\nclaude --plugin-dir ./plugins/swagger-contract-testing\n```\n\n### Managing plugins\n\n```claude\n/plugin                          # open plugin manager (Discover / Installed / Marketplaces / Errors)\n/reload-plugins                  # reload without restarting\n/plugin disable swagger-contract-testing@pactflow-agent-skills\n/plugin uninstall swagger-contract-testing@pactflow-agent-skills\n```\n\n---\n\n## Installing in OpenCode\n\nOpenCode supports [Agent Skills](https://opencode.ai/docs/skills) loaded from `SKILL.md` files in named subdirectories. The agent\nautomatically selects relevant skills based on task context.\n\n### Global install (available in all projects)\n\n```bash\ncp -r plugins/swagger-contract-testing/skills/drift-testing ~/.config/opencode/skills/drift-testing\ncp -r plugins/swagger-contract-testing/skills/openapi-parser ~/.config/opencode/skills/openapi-parser\ncp -r plugins/swagger-contract-testing/skills/pactflow ~/.config/opencode/skills/pactflow\n```\n\n### Project-level install (this project only)\n\n```bash\nmkdir -p .opencode/skills\ncp -r plugins/swagger-contract-testing/skills/drift-testing .opencode/skills/drift-testing\ncp -r plugins/swagger-contract-testing/skills/openapi-parser .opencode/skills/openapi-parser\ncp -r plugins/swagger-contract-testing/skills/pactflow .opencode/skills/pactflow\n```\n\nOpenCode will pick up the skills automatically — no restart required.\n\n---\n\n## Installing in GitHub Copilot (VS Code)\n\nVS Code Copilot supports [Agent Skills](https://code.visualstudio.com/docs/copilot/customization/agent-skills)\nnatively. Skills are loaded from `SKILL.md` files in named subdirectories and invoked as slash commands\nin Copilot Chat (`/drift-testing`, `/openapi-parser`). Copilot also auto-loads relevant skills based on context.\n\n### Project-level install (recommended for teams)\n\nCopy the skill folders into any of the standard discovery locations — Copilot checks all of them:\n\n```bash\n# .github/skills  (most common for GitHub projects)\nmkdir -p .github/skills\ncp -r plugins/swagger-contract-testing/skills/drift-testing .github/skills/drift-testing\ncp -r plugins/swagger-contract-testing/skills/openapi-parser .github/skills/openapi-parser\ncp -r plugins/swagger-contract-testing/skills/pactflow .github/skills/pactflow\n\n# or .agents/skills\nmkdir -p .agents/skills\ncp -r plugins/swagger-contract-testing/skills/drift-testing .agents/skills/drift-testing\ncp -r plugins/swagger-contract-testing/skills/openapi-parser .agents/skills/openapi-parser\ncp -r plugins/swagger-contract-testing/skills/pactflow .agents/skills/pactflow\n\n# or .claude/skills (already used by Claude Code)\nmkdir -p .claude/skills\ncp -r plugins/swagger-contract-testing/skills/drift-testing .claude/skills/drift-testing\ncp -r plugins/swagger-contract-testing/skills/openapi-parser .claude/skills/openapi-parser\ncp -r plugins/swagger-contract-testing/skills/pactflow .claude/skills/pactflow\n```\n\nCommit the chosen directory to share the skills with your team. No VS Code configuration required.\n\n### Personal install (all your projects)\n\nCopy to a personal skills directory so the skills are available in every repo you open:\n\n```bash\nmkdir -p ~/.copilot/skills\ncp -r plugins/swagger-contract-testing/skills/drift-testing ~/.copilot/skills/drift-testing\ncp -r plugins/swagger-contract-testing/skills/openapi-parser ~/.copilot/skills/openapi-parser\ncp -r plugins/swagger-contract-testing/skills/pactflow ~/.copilot/skills/pactflow\n```\n\n### Custom location\n\nPoint Copilot at any directory via VS Code settings:\n\n```json\n{\n  \"chat.agentSkillsLocations\": [\"/path/to/your/skills\"]\n}\n```\n\n### Using the skills in Copilot Chat\n\nOnce installed, open Copilot Chat and invoke a skill by name:\n\n```claude\n/drift-testing write a test case for POST /orders returning 201\n/openapi-parser generate Drift tests for the payments spec\n```\n\nYou can also type `/skills` in chat to browse and configure installed skills. Copilot will\nauto-load a skill when it detects a relevant task even without an explicit slash command.\n\n---\n\n### Fallback: custom instructions (older Copilot versions)\n\nIf your version of Copilot doesn't support Agent Skills yet, use custom instructions instead.\n\n**Repo-wide** — applies to every conversation in the repository:\n\n```bash\ncat plugins/swagger-contract-testing/skills/drift-testing/SKILL.md plugins/swagger-contract-testing/skills/drift-testing/references/*.md \u003e\u003e .github/copilot-instructions.md\ncat plugins/swagger-contract-testing/skills/openapi-parser/SKILL.md plugins/swagger-contract-testing/skills/openapi-parser/references/*.md \u003e\u003e .github/copilot-instructions.md\ncat plugins/swagger-contract-testing/skills/pactflow/SKILL.md plugins/swagger-contract-testing/skills/pactflow/references/*.md \u003e\u003e .github/copilot-instructions.md\n```\n\n**Path-scoped** — loads only when relevant files are open:\n\n```bash\n# Drift — scoped to Drift config files\necho '---\\napplyTo: \"**/drift.yaml,**/*.tests.yaml,**/*.dataset.yaml\"\\n---\\n' \u003e .github/instructions/drift.instructions.md\ncat plugins/swagger-contract-testing/skills/drift-testing/SKILL.md plugins/swagger-contract-testing/skills/drift-testing/references/*.md \u003e\u003e .github/instructions/drift.instructions.md\n\n# OpenAPI Parser — scoped to OpenAPI spec files\necho '---\\napplyTo: \"**/openapi.yaml,**/openapi.json,**/*.oas.yaml\"\\n---\\n' \u003e .github/instructions/openapi-parser.instructions.md\ncat plugins/swagger-contract-testing/skills/openapi-parser/SKILL.md plugins/swagger-contract-testing/skills/openapi-parser/references/*.md \u003e\u003e .github/instructions/openapi-parser.instructions.md\n\n# PactFlow — scoped to Pact test files and pact config\necho '---\\napplyTo: \"**/*.pact.test.*,**/pacts/**,**/.pactrc*\"\\n---\\n' \u003e .github/instructions/pactflow.instructions.md\ncat plugins/swagger-contract-testing/skills/pactflow/SKILL.md plugins/swagger-contract-testing/skills/pactflow/references/*.md \u003e\u003e .github/instructions/pactflow.instructions.md\n```\n\n**Reusable prompts** — attach on demand in chat:\n\n1. Enable prompt files in VS Code settings: `{ \"chat.promptFiles\": true }`\n2. Create prompt files:\n   ```bash\n   cat plugins/swagger-contract-testing/skills/drift-testing/SKILL.md plugins/swagger-contract-testing/skills/drift-testing/references/*.md \u003e .github/prompts/drift.prompt.md\n   cat plugins/swagger-contract-testing/skills/openapi-parser/SKILL.md plugins/swagger-contract-testing/skills/openapi-parser/references/*.md \u003e .github/prompts/openapi-parser.prompt.md\n   cat plugins/swagger-contract-testing/skills/pactflow/SKILL.md plugins/swagger-contract-testing/skills/pactflow/references/*.md \u003e .github/prompts/pactflow.prompt.md\n   ```\n3. In Copilot Chat, click **Attach context → Prompt...** and select the skill.\n\n---\n\n## Installing in GitHub Copilot CLI\n\nGitHub Copilot CLI supports plugins via the `/plugin` command (requires `gh copilot` v1+).\n\n**1. Add the marketplace:**\n\n```shell\ncopilot plugin marketplace add pactflow/pactflow-agent-skills\n```\n\n**2. Install the plugin:**\n\n```shell\ncopilot plugin install swagger-contract-testing@pactflow-agent-skills\n```\n\nOr install directly from the repo without adding a marketplace first:\n\n```shell\ncopilot plugin install pactflow/pactflow-agent-skills\n```\n\n**3. Configure your PactFlow credentials** in `~/.copilot/settings.json` (or the equivalent config file for your environment):\n\n```json\n{\n  \"pluginConfigs\": {\n    \"swagger-contract-testing@pactflow-agent-skills\": {\n      \"options\": {\n        \"pact_broker_base_url\": \"https://yourorg.pactflow.io\",\n        \"pact_broker_token\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n---\n\n## Installing in Cursor\n\nCursor supports [Agent Skills](https://cursor.com/docs/skills) loaded from `SKILL.md` files in named subdirectories. Skills can be project-scoped or global.\n\n### Remote install from GitHub\n\n1. Open **Cursor Settings → Rules**\n2. Click **Add Rule** in Project Rules\n3. Select **Remote Rule (GitHub)**\n4. Enter the URL to each skill folder:\n   - `https://github.com/pactflow/pactflow-agent-skills/tree/main/plugins/swagger-contract-testing/skills/drift-testing`\n   - `https://github.com/pactflow/pactflow-agent-skills/tree/main/plugins/swagger-contract-testing/skills/openapi-parser`\n\n### Project-level install (manual)\n\n```bash\nmkdir -p .cursor/skills\ncp -r plugins/swagger-contract-testing/skills/drift-testing .cursor/skills/drift-testing\ncp -r plugins/swagger-contract-testing/skills/openapi-parser .cursor/skills/openapi-parser\ncp -r plugins/swagger-contract-testing/skills/pactflow .cursor/skills/pactflow\n```\n\nCommit `.cursor/skills/` to share the skills with your team. Cursor also discovers skills from `.agents/skills/`.\n\n### Global install (all your projects)\n\n```bash\nmkdir -p ~/.cursor/skills\ncp -r plugins/swagger-contract-testing/skills/drift-testing ~/.cursor/skills/drift-testing\ncp -r plugins/swagger-contract-testing/skills/openapi-parser ~/.cursor/skills/openapi-parser\ncp -r plugins/swagger-contract-testing/skills/pactflow ~/.cursor/skills/pactflow\n```\n\n---\n\n## Installing in Windsurf\n\nWindsurf supports [Skills](https://docs.windsurf.com/windsurf/cascade/skills) loaded from `SKILL.md` files in named subdirectories. Skills can be workspace-scoped or global.\n\n### From the UI\n\n1. Open the **Cascade** panel\n2. Click the **⋯** menu → **Skills**\n3. Choose **+ Workspace** (project) or **+ Global**\n4. Copy the contents of each `SKILL.md` into the new skill\n\n### Project-level install (manual)\n\n```bash\nmkdir -p .windsurf/skills\ncp -r plugins/swagger-contract-testing/skills/drift-testing .windsurf/skills/drift-testing\ncp -r plugins/swagger-contract-testing/skills/openapi-parser .windsurf/skills/openapi-parser\ncp -r plugins/swagger-contract-testing/skills/pactflow .windsurf/skills/pactflow\n```\n\nCommit `.windsurf/skills/` to share the skills with your team.\n\n### Global install (all your projects)\n\n```bash\nmkdir -p ~/.codeium/windsurf/skills\ncp -r plugins/swagger-contract-testing/skills/drift-testing ~/.codeium/windsurf/skills/drift-testing\ncp -r plugins/swagger-contract-testing/skills/openapi-parser ~/.codeium/windsurf/skills/openapi-parser\ncp -r plugins/swagger-contract-testing/skills/pactflow ~/.codeium/windsurf/skills/pactflow\n```\n\n---\n\n## Installing in Codex\n\nCodex supports [Skills](https://developers.openai.com/codex/skills/) loaded from `SKILL.md` files in named subdirectories, and a [Plugin system](https://developers.openai.com/codex/plugins/build) with a `.codex-plugin/plugin.json` manifest for bundled installs.\n\n### Plugin install (recommended)\n\nThe plugin manifest bundles all three skills together and wires up the SmartBear MCP server automatically.\n\n**1. Add the marketplace** (repo-scoped, shared with your team):\n\nThe repo already ships a marketplace file at `.agents/plugins/marketplace.json`. Codex discovers it automatically when you open the project — no extra configuration needed.\n\n**2. Install the plugin** using the built-in `$plugin-creator` skill or manually via the Codex plugin manager:\n\n```codex\n$plugin install swagger-contract-testing@pactflow-agent-skills\n```\n\nOr install directly from the repo:\n\n```codex\n$plugin install pactflow/pactflow-agent-skills\n```\n\n**3. Configure your PactFlow credentials** in `~/.codex/settings.json`:\n\n```json\n{\n  \"pluginConfigs\": {\n    \"swagger-contract-testing@pactflow-agent-skills\": {\n      \"options\": {\n        \"pact_broker_base_url\": \"https://yourorg.pactflow.io\",\n        \"pact_broker_token\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\nGet your API token from `https://yourorg.pactflow.io/settings/api-tokens`. For an open-source Pact Broker, use `pact_broker_username` and `pact_broker_password` instead of `pact_broker_token`.\n\n### Using the skill installer\n\n```bash\n$skill-installer pactflow/pactflow-agent-skills/plugins/swagger-contract-testing/skills/drift-testing\n$skill-installer pactflow/pactflow-agent-skills/plugins/swagger-contract-testing/skills/openapi-parser\n$skill-installer pactflow/pactflow-agent-skills/plugins/swagger-contract-testing/skills/pactflow\n```\n\n### Project-level install (manual)\n\n```bash\nmkdir -p .agents/skills\ncp -r plugins/swagger-contract-testing/skills/drift-testing .agents/skills/drift-testing\ncp -r plugins/swagger-contract-testing/skills/openapi-parser .agents/skills/openapi-parser\ncp -r plugins/swagger-contract-testing/skills/pactflow .agents/skills/pactflow\n```\n\nCommit `.agents/skills/` to share the skills with your team.\n\n### Global install (all your projects)\n\n```bash\nmkdir -p ~/.agents/skills\ncp -r plugins/swagger-contract-testing/skills/drift-testing ~/.agents/skills/drift-testing\ncp -r plugins/swagger-contract-testing/skills/openapi-parser ~/.agents/skills/openapi-parser\ncp -r plugins/swagger-contract-testing/skills/pactflow ~/.agents/skills/pactflow\n```\n\n---\n\n## Installing in Kiro\n\n### Kiro Power (recommended)\n\nThe `swagger-contract-testing` Power bundles the skills and SmartBear MCP server into a single install with automatic onboarding, credential validation, and smart task routing. See the [Kiro Power](docs/ai-tools/kiro-power.md) page for full details.\n\nOpen the **Agent Steering \u0026 Skills** panel in Kiro, click **+**, choose **Import a Power**, select **GitHub**, and paste:\n\n```\nhttps://github.com/pactflow/pactflow-agent-skills/tree/main/powers/swagger-contract-testing\n```\n\nSet `PACT_BROKER_BASE_URL` and `PACT_BROKER_TOKEN` in your shell profile or Kiro's environment configuration before activating.\n\n### Import skills from GitHub\n\n1. Open the **Agent Steering \u0026 Skills** panel in Kiro\n2. Click **+** → **Import a skill**\n3. Select **GitHub** and paste the URL to each skill folder:\n   - `https://github.com/pactflow/pactflow-agent-skills/tree/main/plugins/swagger-contract-testing/skills/drift-testing`\n   - `https://github.com/pactflow/pactflow-agent-skills/tree/main/plugins/swagger-contract-testing/skills/openapi-parser`\n   - `https://github.com/pactflow/pactflow-agent-skills/tree/main/plugins/swagger-contract-testing/skills/pactflow`\n\nImported skills are copied to your skills directory and work immediately.\n\n### Project-level install (manual)\n\n```bash\nmkdir -p .kiro/skills\ncp -r plugins/swagger-contract-testing/skills/drift-testing .kiro/skills/drift-testing\ncp -r plugins/swagger-contract-testing/skills/openapi-parser .kiro/skills/openapi-parser\ncp -r plugins/swagger-contract-testing/skills/pactflow .kiro/skills/pactflow\n```\n\nCommit `.kiro/skills/` to share the skills with your team.\n\n### Global install (all your projects)\n\n```bash\nmkdir -p ~/.kiro/skills\ncp -r plugins/swagger-contract-testing/skills/drift-testing ~/.kiro/skills/drift-testing\ncp -r plugins/swagger-contract-testing/skills/openapi-parser ~/.kiro/skills/openapi-parser\ncp -r plugins/swagger-contract-testing/skills/pactflow ~/.kiro/skills/pactflow\n```\n\n\u003e When both locations contain a skill with the same name, the workspace skill takes priority.\n\n---\n\n## Installing in Antigravity\n\nAntigravity supports [Agent Skills](https://antigravity.google/docs/skills) loaded from `SKILL.md` files in named subdirectories. Skills can be workspace-scoped or global.\n\n### Project-level install (recommended for teams)\n\n```bash\nmkdir -p .agents/skills\ncp -r plugins/swagger-contract-testing/skills/drift-testing .agents/skills/drift-testing\ncp -r plugins/swagger-contract-testing/skills/openapi-parser .agents/skills/openapi-parser\ncp -r plugins/swagger-contract-testing/skills/pactflow .agents/skills/pactflow\n```\n\nCommit `.agents/skills/` to share the skills with your team.\n\n### Global install (all your projects)\n\n```bash\nmkdir -p ~/.gemini/antigravity/skills\ncp -r plugins/swagger-contract-testing/skills/drift-testing ~/.gemini/antigravity/skills/drift-testing\ncp -r plugins/swagger-contract-testing/skills/openapi-parser ~/.gemini/antigravity/skills/openapi-parser\ncp -r plugins/swagger-contract-testing/skills/pactflow ~/.gemini/antigravity/skills/pactflow\n```\n\n\u003e Antigravity also supports `.agent/skills/` (singular) for backward compatibility.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpactflow%2Fpactflow-agent-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpactflow%2Fpactflow-agent-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpactflow%2Fpactflow-agent-skills/lists"}