validating-api-schemas

Quick Review

The skill has good structural organization with separated reference files, but suffers from significant misalignment between its stated purpose (validating API schemas) and its actual content (building/developing APIs). The description promises schema validation against OpenAPI, JSON Schema, and GraphQL specs, but the instructions focus on API development tasks like implementing endpoints, controllers, and middleware. The Prerequisites and Instructions sections read like generic API development rather than schema validation. While taskKnowledge scores moderately due to referenced implementation files, descriptionCoverage is low because a CLI agent would be confused about whether to validate existing schemas or build new APIs. Novelty is limited as schema validation tools are readily available and well-documented. To improve: align all content with the core validation mission, provide specific validation commands/tools, clarify input/output for validation tasks, and demonstrate clear value over standard validation libraries.