fix-validation-errors-with-overlays
@speakeasy-api/fix-validation-errors-with-overlays
Use when you have lint errors but can't modify the source spec, or need to add missing descriptions/tags via overlay
Installation
$skills install @speakeasy-api/fix-validation-errors-with-overlays
Claude Code
Cursor
Copilot
Codex
Antigravity
Details
Repositoryspeakeasy-api/speakeasy
Pathskills/fix-validation-errors-with-overlays/SKILL.md
Branchmain
Scoped Name@speakeasy-api/fix-validation-errors-with-overlays
Usage
After installing, this skill will be available to your AI coding assistant.
Verify installation:
skills listSkill Instructions
name: fix-validation-errors-with-overlays description: Use when you have lint errors but can't modify the source spec, or need to add missing descriptions/tags via overlay
fix-validation-errors-with-overlays
Overlay-Appropriate Fixes
| Issue | Overlay Solution |
|---|---|
| Poor operation names | x-speakeasy-name-override |
| Missing descriptions | Add summary or description |
| Missing tags | Add tags array |
| Need operation grouping | x-speakeasy-group |
| Need retry config | x-speakeasy-retries |
NOT Overlay-Appropriate
| Issue | Why |
|---|---|
| Invalid JSON/YAML | Syntax error in source |
| Missing required fields | Schema incomplete |
| Broken $ref | Source needs fixing |
| Wrong data types | API design issue |
Quick Fix Workflow
# 1. Generate suggestions
speakeasy suggest operation-ids -s openapi.yaml -o fixes.yaml
# 2. Add to workflow
# Edit .speakeasy/workflow.yaml to include overlay
# 3. Regenerate
speakeasy run
More by speakeasy-api
View allapply-openapi-overlay
377Use when applying an overlay file to a spec
get-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
validate-openapi-spec
377Use when checking if an OpenAPI spec is valid, looking for errors, or running `speakeasy lint`