API Schema Validator Skill for OpenAPI Reference Checks
Lint an OpenAPI definition in CI and report unresolved references with their exact locations.
中文Install in Claude Code
Use your OpenAPI file and the project's lint tool. The example uses a synthetic catalog object.
- Get the complete `plugins/api-development/api-schema-validator/skills/validating-api-schemas` directory from the pinned GitHub commit.
- Copy it into the target project's `.claude/skills/`. Check `.claude/skills/validating-api-schemas/SKILL.md`, start Claude Code at the project root, and call `/validating-api-schemas`.
Example task
Reference #/components/schemas/CatalogItem from a 200 response while defining only Item. Run lint, inspect the location, and correct the reference.What to check
The initial lint identifies the missing CatalogItem, and the same check passes after correction.
Original SKILL.md on GitHub · Updated
Frequently asked question
Does a valid definition prove that the running API follows it?
Add response integration tests for the runtime. Definition lint checks the document itself.