validate-openapi-spec
@speakeasy-api/validate-openapi-spec
Use when checking if an OpenAPI spec is valid, looking for errors, or running `speakeasy lint`
Installation
$skills install @speakeasy-api/validate-openapi-spec
Claude Code
Cursor
Copilot
Codex
Antigravity
Details
Repositoryspeakeasy-api/speakeasy
Pathskills/validate-openapi-spec/SKILL.md
Branchmain
Scoped Name@speakeasy-api/validate-openapi-spec
Usage
After installing, this skill will be available to your AI coding assistant.
Verify installation:
skills listSkill Instructions
name: validate-openapi-spec
description: Use when checking if an OpenAPI spec is valid, looking for errors, or running speakeasy lint
validate-openapi-spec
Use speakeasy lint to check for errors and warnings.
Command
speakeasy lint openapi -s <path-to-spec>
Output Categories
| Severity | Meaning | Action |
|---|---|---|
| Error | Blocks SDK generation | Must fix |
| Warning | May cause issues | Should fix |
| Hint | Best practice suggestion | Consider fixing |
Common Validation Issues
| Issue | Solution |
|---|---|
| Missing operationId | Add operationId or use speakeasy suggest operation-ids |
| Invalid $ref | Fix the reference path |
| Missing response schema | Add response schema definitions |
| Duplicate operationId | Make operation IDs unique |
AI-Friendly Output
For commands with large outputs, pipe to grep or tail to reduce context:
speakeasy lint openapi -s ./openapi.yaml 2>&1 | grep -E "(error|warning)"
More by speakeasy-api
View allget-ai-suggestions
377Use when SDK method names are ugly, wanting to improve operation IDs, or asking "how can I improve my spec"
merge-openapi-specs
377Use when combining multiple OpenAPI specs, or have microservices with separate spec files
diagnose-generation-failure
377name: diagnose-generation-failure
apply-openapi-overlay
377Use when applying an overlay file to a spec