Awesome-omni-skill fix-validation-errors-with-overlays

Name: fix-validation-errors-with-overlays
Author: diegosouzapw

Use when you have lint errors but can't modify the source spec, or need to add missing descriptions/tags via overlay

install

source · Clone the upstream repo

git clone https://github.com/diegosouzapw/awesome-omni-skill

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/development/fix-validation-errors-with-overlays" ~/.claude/skills/diegosouzapw-awesome-omni-skill-fix-validation-errors-with-overlays && rm -rf "$T"

manifest: skills/development/fix-validation-errors-with-overlays/SKILL.md

source content

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