CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

validating-api-responses

Validate API responses against schemas to ensure contract compliance and data integrity. Use when ensuring API response correctness. Trigger with phrases like "validate responses", "check API responses", or "verify response format".

Quality

77%

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 ./plugins/api-development/api-response-validator/skills/validating-api-responses/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a well-structured, token-efficient overview with a clear sequenced workflow and real, clearly linked reference files. Its main weakness is actionability: no executable code or commands appear in the body, and the referenced implementation guide covers a different topic (API design) rather than the response-validation implementation it promises.

Suggestions

Include a minimal executable snippet in SKILL.md (e.g., Ajv compile of a response schema plus middleware validation call) so the core task is actionable without depending on the references.

Replace or rewrite references/implementation.md to cover response-validation implementation (validator compilation, middleware wiring, per-environment strictness config) instead of general API design, which does not match what the body promises.

Add an explicit validate-then-fix feedback loop to the Instructions (e.g., 'if violations are reported, fix the serializer or schema and re-run the contract suite') to upgrade workflow clarity.

DimensionReasoningScore

Conciseness

The body is dense and instructional with no re-teaching of concepts Claude already knows; the error table and examples are compact. Minor trimming opportunities exist — environment strictness is described both in instruction 4 and the production-sampling example, the prerequisites list is slightly padded, and one Resources entry ('OpenAPI response validation best practices') has no URL — matching anchor 4 (efficient, minor instances that could be trimmed) rather than the fully lean anchor 5.

4 / 5

Actionability

Guidance is concrete at the configuration level — named validators (Ajv, jsonschema), 'strict mode (`additionalProperties: false`)', specific headers and format constraints — but the body contains no executable code or commands, and the deferred 'full implementation guide' (references/implementation.md) actually covers API design rather than response-validation implementation. This matches anchor 3 (some concrete guidance but incomplete, key details missing) rather than anchor 4, which expects concrete code or commands with only minor gaps.

3 / 5

Workflow Clarity

The eight instructions form a coherent build order (extract schemas → compile validators → middleware → environment config → headers → contract tests → drift detection → coverage report) with checkpoint elements in drift alerting, the coverage report, and the error-recovery table. It falls short of anchor 5 because the steps lack an explicit validate-and-fix retry loop; validation recovery is only implicit in the error table.

4 / 5

Progressive Disclosure

The body is a well-organized overview with three clearly signaled, one-level-deep references that all exist as real files in the bundle. This matches anchor 4 (good structure, references mostly clear, minor organization gaps) but not anchor 5, because references/implementation.md does not contain the promised validation implementation — it is an API design guide — so content is not entirely appropriately split.

4 / 5

Total

15

/

20

Passed

Description

78%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, third-person description that clearly states what the skill does and when to use it, with explicit natural trigger phrases. Its main weaknesses are limited breadth in the capability list and slightly generic phrasing around correctness that leaves minor overlap risk with adjacent testing skills.

DimensionReasoningScore

Specificity

The description names the domain and one concrete action — 'Validate API responses against schemas' — with purpose framing ('ensure contract compliance and data integrity'), but does not list several distinct capabilities (e.g., drift detection, contract testing, middleware) the body actually covers. It matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive), not anchor 4, which requires a list of several specific actions.

3 / 5

Completeness

It explicitly answers both questions: what ('Validate API responses against schemas to ensure contract compliance and data integrity') and when ('Use when ensuring API response correctness') with concrete trigger phrases, exactly matching the anchor 5 pattern of clear what + explicit when + concrete triggers. Anchor 4 would apply only if the 'when' were vague or implied, which it is not.

5 / 5

Trigger Term Quality

It gives three natural trigger phrases users would plausibly say — 'validate responses', 'check API responses', 'verify response format' — providing good keyword coverage, but misses common synonyms such as 'schema validation', 'contract testing', or 'response schema', so it falls short of the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

API response validation against schemas is a mostly distinct niche with specific triggers, but phrases like 'validate responses' have minor overlap risk with general schema-validation or API-testing skills, matching anchor 4 rather than the minimal-conflict anchor 5.

4 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

jeremylongshore/tons-of-skills-marketplace

Path

plugins/api-development/api-response-validator/skills/validating-api-responses/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.