CtrlK
BlogDocsLog inGet started
Tessl Logo

contract-testing

Use when setting up integration testing for a frontend-backend API boundary, evaluating whether two services are safe to deploy independently, or replacing slow end-to-end tests with contract tests.

57

Quality

66%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/contract-testing/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%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 clean, well-disciplined overview body that delegates implementation detail to a single clearly-signaled reference — exemplary progressive disclosure. The weaknesses are the missing explicit validation checkpoints in the body itself and an opening rationale paragraph that restates known concepts and duplicates the reference file.

Suggestions

Add a short verification checkpoint sequence to the body (e.g., '1. Run pnpm test:pact — a .json pact file must appear in pacts/; 2. Run provider verification against the local backend; 3. Confirm CI fails when a provider field is renamed') or explicitly point to the Verification section of references/rule.md.

Trim or cut the opening 'why integration tests are slow and brittle' paragraph — it explains a concept Claude already knows and is duplicated verbatim in references/rule.md.

Include one minimal copy-paste consumer test snippet (or the install command 'pnpm add -D @pact-foundation/pact') in the body so the first action is executable without opening the reference.

DimensionReasoningScore

Conciseness

The body is lean and well-sectioned with no padding, but the opening paragraph ("Integration tests that require both services running at the same time are slow, brittle, and hard to maintain...") explains a concept Claude already knows and is duplicated verbatim in references/rule.md's 'Why It Matters' section — a minor instance of over-explanation that could be trimmed, placing it just below anchor 5.

4 / 5

Actionability

The Fix section names the exact tools and targets ("Pact consumer tests for the frontend API client", "publish the contracts to a broker", "provider verification to the backend CI pipeline") and Code Review gives concrete flags ("any-type matchers on fields the consumer actually uses", "missing status code assertions"), with fully executable code one clearly-signaled reference away. The body itself contains no commands or code, which is the minor gap keeping it below anchor 5.

4 / 5

Workflow Clarity

The Quick Reference lays out the lifecycle sequence (consumer writes tests → publish to broker → verify against provider → CI fails before deploy) and Fix sequences the three implementation steps, but validation checkpoints are only implicit in the body — there is no 'run this, confirm that, then proceed' guidance. The explicit verification steps exist only in references/rule.md's Verification section, matching anchor 3 (sequence present, checkpoints missing or implicit).

3 / 5

Progressive Disclosure

The bundle structure matches the ideal: SKILL.md is a concise overview (Check/Fix/Explain/Code Review), all implementation detail lives in exactly one reference (references/rule.md, verified to exist), and it is clearly signaled at the end with an accurate framing ('For full implementation details, code examples, and framework-specific guidance'). One level deep, easy to navigate, nothing inlined that belongs in the reference.

5 / 5

Total

16

/

20

Passed

Description

61%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 well-constructed trigger-only description with specific, natural 'when' clauses and a distinct niche. Its main weakness is the missing 'what' — the skill's actual capabilities (writing Pact consumer tests, publishing contracts, provider verification) are never stated, only implied by the triggers.

Suggestions

Lead with an explicit capability statement before the triggers, e.g., 'Implements consumer-driven contract testing with Pact: write consumer tests, publish pacts to a broker, and add provider verification and can-i-deploy gates to CI.'

Add high-value trigger terms users actually say: 'Pact', 'consumer-driven contracts', 'API contract', and 'Pact Broker'.

Sharpen the boundary with adjacent skills, e.g., 'contract tests (not general integration or end-to-end tests)' to reduce overlap with integration/e2e testing skills.

DimensionReasoningScore

Specificity

The description names the domain clearly ("contract tests", "frontend-backend API boundary") and lists three concrete usage scenarios ("setting up integration testing", "evaluating whether two services are safe to deploy independently", "replacing slow end-to-end tests"), but never states what the skill actually does (e.g., write Pact consumer tests, publish to a broker, verify the provider). It sits between anchor 2 (domain named, generic actions) and anchor 4 (several specific skill actions) — the scenarios are concrete but they are triggers, not capability actions.

3 / 5

Completeness

The 'when' is fully explicit and specific (three well-formed 'Use when/or' clauses), but the 'what' is only implied through those triggers — no statement of the skill's capabilities. This is noticeably above anchor 2's vague 'Use when working with documents' (only 'when', no 'what') but lacks the explicit 'what' that anchor 4 requires.

3 / 5

Trigger Term Quality

Good natural keyword coverage: "integration testing", "end-to-end tests", "contract tests", "safe to deploy independently" — phrases users would plausibly say. A few common terms are missing, notably "Pact", "consumer-driven contracts", "API contract", and "broker", so it does not reach the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

Contract testing at a frontend-backend API boundary is a clear niche with distinct triggers. Minor overlap risk remains: 'setting up integration testing' and 'replacing slow end-to-end tests' could also match a general integration-testing or e2e-testing skill, keeping it just below anchor 5's minimal-conflict bar.

4 / 5

Total

14

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
thedaviddias/Front-End-Checklist
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.