CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/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

Overview
Quality
Evals
Security
Files

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: executable code for every lifecycle stage, a clearly sequenced workflow with a deployment gate, and proper use of a single reference file. Minor room to tighten explanatory prose and to add an explicit recovery step when can-i-deploy fails.

DimensionReasoningScore

Conciseness

The body is mostly lean code-and-commands with genuinely non-obvious details ("`publishVerificationResult: true` is what updates the matrix", the record-deployment pitfall), but the five-step overview and a few explanatory sentences partially restate widely documented Pact behavior and could be trimmed. Better than anchor 3 (which implies more pervasive unnecessary explanation), short of anchor 5.

4 / 5

Actionability

Fully executable throughout: install command, a complete PactV3 consumer test, the publish CLI with git SHA/branch, full Verifier configuration with consumerVersionSelectors, state handlers, can-i-deploy with a flag table and exit codes, and record-deployment. Code is copy-paste ready and covers the common cases.

5 / 5

Workflow Clarity

The lifecycle is clearly sequenced (numbered five steps, then sections in the same order) with an explicit validation gate (can-i-deploy exit codes 0/1) and failure-cause guidance ("Skipping this step is the most common reason can-i-deploy returns spurious 'no' verdicts"). Falls short of anchor 5 because there is no explicit recovery step when the gate returns 1 (e.g., verify the missing consumer pair and re-run).

4 / 5

Progressive Disclosure

Clear overview in SKILL.md with a single, clearly signaled, one-level-deep reference ("Full consumer and provider GitHub Actions steps are in references/ci-pipelines.md", verified to exist) that appropriately offloads CI detail; core patterns stay inline and the References section aids navigation.

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 with an explicit trigger clause, four concrete lifecycle actions, and highly distinctive domain terms. The only weakness is slightly incomplete synonym coverage for trigger phrases.

DimensionReasoningScore

Specificity

Lists four concrete, distinct actions covering the entire skill lifecycle: "set up Pact consumer-driven contract tests, publish pacts to a broker, verify the provider and gate deploys with can-i-deploy". This matches the comprehensive multiple-concrete-actions anchor; the 4 anchor (minor coverage gaps) does not apply since consumer test, publish, verify, and deploy gating are all named.

5 / 5

Completeness

Explicitly answers both questions: an explicit "Use whenever two services... keep breaking each other's API" trigger clause with a concrete scenario, and a clear multi-action statement of what the skill does. This is a direct match for the anchor-5 example pattern.

5 / 5

Trigger Term Quality

Includes natural phrases users would say ("services keep breaking each other's API", "two microservices", "frontend and an API", "contract tests", "gate deploys") plus the distinctive "can-i-deploy". Falls short of anchor 5 because common synonyms like "integration tests between services" or "API breaking changes" are absent.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (consumer-driven contract testing between owned services) with distinctive triggers ("Pact", "broker", "can-i-deploy") that no generic testing skill would match; conflict risk is minimal.

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.

Reviewed

On this page