CtrlK
BlogDocsLog inGet started
Tessl Logo

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".

42

Quality

43%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/api-development/api-response-validator/skills/validating-api-responses/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

67%

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

The description is structurally sound with explicit 'what' and 'when' clauses, which is its main strength. However, it lacks specificity in the concrete actions it performs and could benefit from more varied trigger terms. The domain is reasonably distinct but the actions described are somewhat generic.

Suggestions

Add more specific concrete actions, e.g., 'Compares response fields against schema types, flags missing required fields, detects extra properties, and validates nested object structures.'

Expand trigger terms to include common variations like 'JSON schema', 'API contract testing', 'response structure', 'schema compliance', '.json schema validation'.

DimensionReasoningScore

Specificity

It names the domain (API responses, schemas) and a general action (validate against schemas), but doesn't list multiple concrete actions. 'Ensure contract compliance and data integrity' is somewhat vague and doesn't describe specific operations like 'compare response fields to schema types, flag missing required fields, report extra properties.'

2 / 3

Completeness

It explicitly answers both 'what' (validate API responses against schemas for contract compliance and data integrity) and 'when' (with a 'Use when' clause and explicit trigger phrases). Both components are present and clearly stated.

3 / 3

Trigger Term Quality

Includes some relevant trigger terms like 'validate responses', 'check API responses', 'verify response format', and 'schema'. However, it misses common variations users might say such as 'JSON schema', 'response validation', 'API contract testing', 'schema compliance', or 'response structure'.

2 / 3

Distinctiveness Conflict Risk

The focus on API response validation against schemas is fairly specific, but could overlap with general API testing skills, schema validation skills, or contract testing skills. The triggers like 'check API responses' are somewhat broad and could conflict with skills that analyze or debug API responses rather than validate them against schemas.

2 / 3

Total

9

/

12

Passed

Implementation

20%

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

This skill reads like a high-level architecture document rather than an actionable skill for Claude. It describes what to build conceptually but provides no executable code, concrete commands, or real examples. The verbose prose explains concepts Claude already understands while failing to provide the specific implementation details that would make the skill useful.

Suggestions

Replace abstract instructions ('Implement response validation middleware') with concrete, executable code examples showing actual middleware implementation with a JSON Schema validator like Ajv.

Remove the prerequisites section and conceptual explanations — Claude knows what OpenAPI specs and JSON Schema validators are. Use that space for working code instead.

Add a concrete, minimal working example early in the skill (e.g., a 10-line Node.js snippet that validates a response against a schema) before describing the full architecture.

Either provide the referenced bundle files (implementation.md, errors.md, examples.md) with actual implementation code, or inline the critical implementation details directly in the SKILL.md.

DimensionReasoningScore

Conciseness

The content is verbose and explains many concepts Claude already knows (what OpenAPI is, what JSON Schema validators are, what response codes mean). The prerequisites section lists obvious tooling, and the instructions read like a tutorial rather than actionable directives. The examples section describes scenarios conceptually rather than providing executable code.

1 / 3

Actionability

Despite being 8 steps long, the instructions contain zero executable code, no concrete commands, and no copy-paste-ready examples. Everything is described abstractly ('Implement response validation middleware', 'Build a contract test suite') without showing how. The referenced implementation.md is not provided in the bundle.

1 / 3

Workflow Clarity

Steps are listed in a logical sequence and the error handling table provides useful troubleshooting guidance. However, there are no explicit validation checkpoints or feedback loops — step 7 mentions drift detection but doesn't integrate it as a checkpoint within the workflow. For a process involving middleware and CI integration, the lack of verification steps between stages is a gap.

2 / 3

Progressive Disclosure

The skill references three external files (implementation.md, errors.md, examples.md) which is good structure, but none of these files exist in the bundle. The main SKILL.md itself contains too much inline content that is abstract rather than actionable, while the detailed content that should be in the referenced files is missing entirely.

2 / 3

Total

6

/

12

Passed

Validation

81%

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

Validation9 / 11 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

9

/

11

Passed

Repository
jeremylongshore/claude-code-plugins-plus-skills
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.