CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pact-contract-testing

Use whenever two services (a frontend and an API, or two microservices) keep breaking each other's API: set up Pact consumer-driven contract tests, publish pacts to a broker, verify the provider and gate deploys with can-i-deploy.

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is testland/pact-contract-testing

SKILL.md
Quality
Evals
Security

Quality

Content

86%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable skill: it walks the full Pact lifecycle with executable code and commands at every step, gates deploys explicitly, and offloads CI pipeline detail to a genuine one-level reference file. Minor room for improvement exists in trimming concept explanation Claude already knows and adding an explicit error-recovery path for failed provider verifications.

DimensionReasoningScore

Conciseness

The body is largely lean with concrete commands and code, but the Overview's five-step lifecycle explanation and the "The Broker stores..." bullets re-explain Pact concepts Claude already knows — brief framing, yet trimmable, fitting the efficient-with-minor-over-explanation anchor at 4 rather than the padded anchor at 3.

4 / 5

Actionability

Guidance is fully executable and copy-paste ready throughout: an install command, a complete PactV3 consumer test, the pact-broker publish command with all flags, a full Verifier configuration, state handlers, and can-i-deploy / record-deployment commands with a flags table and exit codes — covering the common cases end to end.

5 / 5

Workflow Clarity

The five-step lifecycle is numbered up front and every section follows that order, with the can-i-deploy gate and its exit codes acting as an explicit checkpoint and troubleshooting notes ("Skipping this step is the most common reason can-i-deploy returns spurious 'no' verdicts") — but there is no explicit fix-and-retry loop when provider verification fails, so it fits anchor 4 rather than 5.

4 / 5

Progressive Disclosure

The SKILL.md body is a clear overview with core quick-start content inline, and the CI detail is appropriately split into a real, clearly signaled, one-level-deep reference — "Full consumer and provider GitHub Actions steps are in [references/ci-pipelines.md](references/ci-pipelines.md)" — which exists in the bundle and contains no nested references, matching the well-signaled anchor at 5.

5 / 5

Total

18

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it pairs an explicit "Use whenever..." trigger describing a vivid, recognizable scenario with four concrete lifecycle actions naming the specific tools involved. The only weakness is slight missed coverage of a few natural synonyms a user might say, such as "API compatibility" or "integration testing between services".

DimensionReasoningScore

Specificity

The description lists four concrete, named actions — "set up Pact consumer-driven contract tests, publish pacts to a broker, verify the provider and gate deploys with can-i-deploy" — covering the full contract-testing lifecycle with no coverage gap, matching the comprehensive-coverage anchor rather than the minor-gaps anchor at 4.

5 / 5

Completeness

It explicitly answers both questions: the "what" is the four concrete actions, and the "when" is the explicit trigger clause "Use whenever two services (a frontend and an API, or two microservices) keep breaking each other's API" — clearly matching the anchor requiring concrete trigger phrases for both.

5 / 5

Trigger Term Quality

It includes natural user phrasings like "two services... keep breaking each other's API", "two microservices", "frontend and an API", plus tool terms "Pact", "contract tests", and "can-i-deploy", but a few natural variations such as "API compatibility" or "integration between services" are missing, which fits the good-but-not-comprehensive anchor at 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Pact consumer-driven contract testing) with a distinctive trigger scenario that a generic testing or API skill would not fire on, matching the minimal-conflict-risk anchor at 5 rather than the minor-overlap anchor at 4.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

testland/qa

Path

plugins/qa-contract-testing/skills/pact-contract-testing/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.