Skill v1.0.1

currentAutomated scan100/100

majiayu000/claude-skill-registry/fix-validation-errors-with-overlays

3 files

──Details

PublishedMay 14, 2026 at 10:21 PM

Content Hashsha256:216df6e440f6e5e7...

Git SHA63c042456db3

Bump Typepatch

Compare with v1.0.0

──Files

Files (1 file, 1.0 KB)

SKILL.md1.0 KBactive

SKILL.md · 40 lines · 1.0 KB

version: "1.0.1" 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

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

← v1.0.0 All versions