Agent skill
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
Stars
163
Forks
31
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/testing/fix-validation-errors-with-overlays-majiayu000-claude-skill-registr
SKILL.md
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
bash
# 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
Didn't find tool you were looking for?