CtrlK
BlogDocsLog inGet started
Tessl Logo

contract-first

Coordinate frontend/backend or service-to-service work through one authoritative machine-checkable contract (OpenAPI, AsyncAPI, Protocol Buffers, or JSON Schema), with generated consumer types and contract-verified integration. Use when parallel consumer and provider work must evolve an API or event schema without field drift, mock/production shape mismatch, or one side silently redefining the interface.

70

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%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.

Excellent content: concrete executable examples, a clearly sequenced workflow with explicit verification gates and a completion checklist, and lean prose with no concept over-explanation. The only structural refinement available is splitting some example/anti-pattern material into one-level-deep reference files.

DimensionReasoningScore

Conciseness

The body is efficient and dense with earning tokens — activation criteria, artifact selection, workflow steps, anti-patterns, and a checklist, with no padding explaining concepts Claude already knows. It is not a 5 because passages like the tool-safety paragraph ('Run pinned generators with least privilege: no network or secret access by default...') and some anti-pattern prose could be tightened slightly without losing clarity.

4 / 5

Actionability

Fully executable, copy-paste-ready guidance covering the common cases: a complete OpenAPI 3.1 schema example, a `satisfies`-typed mock, a provider mapping function, `npm run generate:api-types`, and concrete FAIL anti-patterns ('return databaseRow as unknown as OrderSummary'). Even the repo-specific generator command is anchored by an explicit instruction to back it with the repository's pinned generator.

5 / 5

Workflow Clarity

The six-step Consumer-First Workflow and seven-step Contract Change Protocol are clearly sequenced with explicit validation checkpoints: 'generate consumer types successfully / validate consumer fixtures against the contract / validate provider responses / run at least one end-to-end happy path', a 'Merge only when all affected sides agree' gate, and a Completion Checklist. This exceeds the level-4 anchor, which allows only 'most' checkpoints.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and the single-file body is well organized with clear sections and no buried or nested references. It is a 4 rather than 5 because at ~280 lines some material (e.g., the extended code examples and anti-pattern catalog) could arguably live in one-level-deep reference files, a minor organization gap rather than the ideal split of the top anchor.

4 / 5

Total

18

/

20

Passed

Description

83%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 names concrete mechanisms and formats, provides an explicit and specific 'Use when' trigger clause, and defines a distinct niche around parallel consumer/provider coordination. Minor room to improve trigger-term synonyms and distinctiveness from adjacent API-design skills.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'Coordinate frontend/backend or service-to-service work through one authoritative machine-checkable contract (OpenAPI, AsyncAPI, Protocol Buffers, or JSON Schema), with generated consumer types and contract-verified integration' — naming the artifact formats and three specific mechanisms. It is not a 5 because 'coordinate work' is more abstract than the fully concrete action verbs in the top anchor, leaving minor gaps in coverage.

4 / 5

Completeness

Both what and when are answered explicitly and concretely: the 'what' is the contract-coordination workflow with generated types and contract-verified integration, and the 'when' is spelled out in the trigger clause 'Use when parallel consumer and provider work must evolve an API or event schema without field drift, mock/production shape mismatch, or one side silently redefining the interface.'

5 / 5

Trigger Term Quality

Good keyword coverage of natural terms users would say: 'frontend/backend', 'parallel', 'API or event schema', 'field drift', 'mock/production shape mismatch', plus format names (OpenAPI, Protocol Buffers). A few natural synonyms are missing (e.g., 'breaking change', 'interface', 'schema-first'), so it does not reach the comprehensive-synonym coverage of the top anchor.

4 / 5

Distinctiveness Conflict Risk

The trigger scenario (parallel consumer/provider work, field drift, mock/production mismatch) carves a clear niche unlikely to fire for the wrong skill. It is a 4 rather than 5 because adjacent skills like API design or general schema work overlap slightly — a user asking for generic API design could plausibly match this description.

4 / 5

Total

17

/

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
affaan-m/ECC
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.