pact

Guidance for Pact contract testing framework in .NET. USE FOR: consumer-driven contract testing, verifying API compatibility between microservices, preventing breaking API changes, generating and verifying Pact files, provider state management, CI/CD integration with Pact Broker. DO NOT USE FOR: end-to-end testing (use Playwright), unit testing (use xUnit with Moq), load testing, or testing internal implementation details.

Jump to install

Repository: Tyler-R-Kendrick/agent-skills
Last source activity: February 11, 2026 at 05:14
Detected SKILL.md language: English
Stars: 10
Forks: 4

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/Tyler-R-Kendrick/agent-skills --skill pact

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

21 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

name	pact
description	Guidance for Pact contract testing framework in .NET. USE FOR: consumer-driven contract testing, verifying API compatibility between microservices, preventing breaking API changes, generating and verifying Pact files, provider state management, CI/CD integration with Pact Broker. DO NOT USE FOR: end-to-end testing (use Playwright), unit testing (use xUnit with Moq), load testing, or testing internal implementation details.
license	MIT
metadata	{"displayName":"Pact","author":"Tyler-R-Kendrick","version":"1.0.0"}
compatibility	["claude","copilot","cursor"]
references	[{"title":"Pact Documentation","url":"https://docs.pact.io/"},{"title":"PactNet GitHub Repository","url":"https://github.com/pact-foundation/pact-net"},{"title":"PactNet NuGet Package","url":"https://www.nuget.org/packages/PactNet"}]

Pact

Overview

Pact is a consumer-driven contract testing framework that ensures API compatibility between services without requiring both services to run simultaneously. In a Pact workflow, the consumer (API client) defines expectations about the provider's API in a Pact file, and the provider independently verifies that it satisfies those expectations. This catches breaking changes early, before they reach integration or staging environments. The .NET implementation uses to write consumer tests that generate Pact files and provider tests that verify them. Pact Broker provides a central repository for sharing Pact files between teams.

using PactNet; using System.Net.Http.Json; using Xunit; using Xunit.Abstractions; public class UserApiConsumerTests { private readonly IPactBuilderV4 _pactBuilder; public UserApiConsumerTests(ITestOutputHelper output) { var pact = Pact.V4( consumer: "UserWebApp", provider: "UserService", new PactConfig { PactDir = Path.Combine("..", "..", "..", "pacts"), LogLevel = PactLogLevel.Information }); _pactBuilder = pact.WithHttpInteractions(); } [Fact] public async Task GetUser_Returns_User_When_Exists() { // Arrange: define the expected interaction _pactBuilder .UponReceiving("a request to get user 1") .Given("user 1 exists") .WithRequest(HttpMethod.Get, "/api/users/1") .WithHeader("Accept", "application/json") .WillRespond() .WithStatus(System.Net.HttpStatusCode.OK) .WithHeader("Content-Type", "application/json; charset=utf-8") .WithJsonBody(new { id = 1, name = "Alice Smith", email = "alice@example.com", role = "admin" }); await _pactBuilder.VerifyAsync(async ctx => { // Act: use the real HTTP client against the Pact mock server var client = new HttpClient { BaseAddress = ctx.MockServerUri }; var user = await client.GetFromJsonAsync<UserDto>( "/api/users/1"); // Assert Assert.NotNull(user); Assert.Equal("Alice Smith", user.Name); Assert.Equal("alice@example.com", user.Email); }); } [Fact] public async Task GetUser_Returns_404_When_Not_Found() { _pactBuilder .UponReceiving("a request to get a non-existent user") .Given("user 999 does not exist") .WithRequest(HttpMethod.Get, "/api/users/999") .WillRespond() .WithStatus(System.Net.HttpStatusCode.NotFound); await _pactBuilder.VerifyAsync(async ctx => { var client = new HttpClient { BaseAddress = ctx.MockServerUri }; var response = await client.GetAsync("/api/users/999"); Assert.Equal(System.Net.HttpStatusCode.NotFound, response.StatusCode); }); } [Fact] public async Task CreateUser_Returns_Created() { _pactBuilder .UponReceiving("a request to create a new user") .Given("the users endpoint is available") .WithRequest(HttpMethod.Post, "/api/users") .WithHeader("Content-Type", "application/json; charset=utf-8") .WithJsonBody(new { name = "Bob Jones", email = "bob@example.com" }) .WillRespond() .WithStatus(System.Net.HttpStatusCode.Created) .WithHeader("Content-Type", "application/json; charset=utf-8") .WithJsonBody(new { id = 2, name = "Bob Jones", email = "bob@example.com" }); await _pactBuilder.VerifyAsync(async ctx => { var client = new HttpClient { BaseAddress = ctx.MockServerUri }; var response = await client.PostAsJsonAsync("/api/users", new { name = "Bob Jones", email = "bob@example.com" }); Assert.Equal(System.Net.HttpStatusCode.Created, response.StatusCode); }); } }

Stage	Action	Owner	Tool
1. Consumer test	Define expectations, generate Pact file	Consumer team	PactNet consumer
2. Publish Pact	Upload Pact file to Pact Broker	Consumer CI	Pact Broker CLI
3. Provider verify	Run provider tests against Pact	Provider team	PactNet verifier
4. Publish results	Report verification status to Broker	Provider CI	PactNet verifier
5. Can-I-Deploy	Check compatibility before deployment	Both teams	Pact CLI

pact

Install options

Review the source files

Pact

Overview

Pact

Overview

Consumer Test Setup

Provider Verification

Provider States

Pact with Message-Based Contracts

Contract Testing Workflow

Best Practices

pact

Source facts

Install options

Review the source files

More from this repository

More from this repository

Pact

Overview

Pact

Overview

Consumer Test Setup

Provider Verification

Provider States

Pact with Message-Based Contracts

Contract Testing Workflow

Best Practices