validating-api-responses

Quick Review

The skill has good structural organization with separated reference files, but suffers from significant content misalignment. The description promises API response validation against schemas (a testing/verification task), but the instructions describe building entire APIs from scratch (development task). The Prerequisites and Output sections reference full API development (routes, controllers, models, middleware), not validation tooling. The allowed-tools mention 'api:validate-*' bash commands suggesting validation functionality exists elsewhere, but the main instructions don't explain how to use them for the stated purpose. For descriptionCoverage (2/10): a CLI agent would be confused about whether to validate existing responses or build new APIs. For taskKnowledge (4/10): while implementation details are referenced in other files, the core validation workflow is unclear. For structure (5/10): good separation of concerns with references folder, though SKILL.md itself is somewhat cluttered. For novelty (3/10): response schema validation could be moderately useful but isn't clearly differentiated from standard testing tools. The skill needs realignment between its stated validation purpose and its implementation-focused content.