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

53

Quality

43%

Does it follow best practices?

Impact

Pending

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 'Use when' and 'Trigger with' clauses, which is a strength. However, the core capability description is somewhat thin—it names one main action (validate) without elaborating on specific sub-capabilities. The trigger terms are reasonable but could be expanded to cover more natural user phrasings.

Suggestions

Add more specific concrete actions beyond 'validate', such as 'check response status codes, verify JSON schema compliance, detect missing required fields, compare response structure against OpenAPI specs'.

Expand trigger terms to include common variations like 'JSON schema', 'API contract testing', 'response body validation', 'OpenAPI', or 'schema compliance'.

DimensionReasoningScore

Specificity

Names the domain (API responses, schemas) and a core action (validate against schemas), but doesn't list multiple concrete actions beyond validation. 'Ensure contract compliance and data integrity' is somewhat abstract rather than listing specific capabilities like 'check status codes, validate JSON schema fields, compare response headers'.

2 / 3

Completeness

Clearly answers both 'what' (validate API responses against schemas for contract compliance and data integrity) and 'when' (explicit 'Use when' clause and 'Trigger with phrases' providing concrete trigger guidance).

3 / 3

Trigger Term Quality

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

2 / 3

Distinctiveness Conflict Risk

Fairly specific to API response validation against schemas, but could overlap with general API testing skills, schema validation skills, or contract testing skills. The scope of 'API responses' is somewhat broad and could conflict with skills focused on API testing more generally.

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 at a conceptual level but provides no executable code, concrete commands, or specific implementation patterns. The content is verbose with explanations of concepts Claude already understands while deferring all actual implementation details to reference files.

Suggestions

Replace the abstract instruction steps with concrete, executable code examples - e.g., show actual middleware code for Express/Fastify, actual Ajv validator setup, and a sample contract test

Remove the error handling table's 'Cause' column which explains obvious concepts, and instead show code snippets for handling each error type

Cut the prerequisites section significantly - Claude knows what JSON Schema validators and OpenAPI specs are; just specify the chosen library and version

Add a validation checkpoint after step 3 (e.g., 'Test the middleware with a known-invalid response to confirm violations are caught') to create a feedback loop

DimensionReasoningScore

Conciseness

The content is verbose and explains many concepts Claude already knows (what JSON Schema is, what OpenAPI specs are, what response codes mean). The error handling table explains basic concepts like type mismatches and null values. Much of this is general API knowledge that doesn't need to be spelled out.

1 / 3

Actionability

Despite being lengthy, the skill contains zero executable code, no concrete commands, and no copy-paste ready examples. Instructions are high-level descriptions ('Implement response validation middleware', 'Build a contract test suite') rather than concrete implementations. The actual implementation is deferred to a reference file.

1 / 3

Workflow Clarity

Steps are numbered and sequenced logically, but there are no explicit validation checkpoints or feedback loops. For a skill involving middleware integration and CI pipeline changes, there should be verification steps (e.g., 'run validation against a known-good response to confirm setup'). The workflow reads more like a project plan than actionable steps.

2 / 3

Progressive Disclosure

References to external files (implementation.md, errors.md, examples.md) are present and one-level deep, which is good. However, the main file itself contains too much inline content that could be trimmed (the verbose error table, the lengthy prerequisites list), while the actual actionable content (code examples, concrete implementations) is entirely deferred to reference files.

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.