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
Best use case
fix-validation-errors-with-overlays is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Use when you have lint errors but can't modify the source spec, or need to add missing descriptions/tags via overlay
Teams using fix-validation-errors-with-overlays should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/fix-validation-errors-with-overlays/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How fix-validation-errors-with-overlays Compares
| Feature / Agent | fix-validation-errors-with-overlays | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Use when you have lint errors but can't modify the source spec, or need to add missing descriptions/tags via overlay
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# 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 ```
Related Skills
fp-ts-errors
Handle errors as values using fp-ts Either and TaskEither for cleaner, more predictable TypeScript code. Use when implementing error handling patterns with fp-ts.
architecture-validation
Dynamically validate codebase compliance with architectural decisions and constraints
Empirical Validation
Requires proof before marking work complete — no "trust me, it works"
assumption-validation
Test whether assumptions are true before making commitments. Use when assumptions have low certainty and high risk.
type-inference-validation
Static type inference and validation for navigation paths
bio-alignment-validation
Validate alignment quality with insert size distribution, proper pairing rates, GC bias, strand balance, and other post-alignment metrics. Use when verifying alignment data quality before variant calling or quantification.
date-validation
Use when editing Planning Hubs, timelines, calendars, or any file with day-name + date combinations (Wed Nov 12), relative dates (tomorrow), or countdowns (18 days until) - validates day-of-week accuracy, relative date calculations, and countdown math with two-source ground truth verification before allowing edits
spring-validation
Bean Validation (Jakarta Validation) with Spring Boot. Custom validators, validation groups, cross-field validation, and internationalized error messages.
fullstack-validation
Comprehensive validation methodology for multi-component applications including backend, frontend, database, and infrastructure
api-validation
Apply when validating API request inputs: body, query params, path params, and headers. This skill covers Zod v4 patterns.
api-request-validation
A skill for implementing robust API request validation in Python web frameworks like FastAPI using Pydantic. Covers Pydantic models, custom validators (email, password), field-level and cross-field validation, query/file validation, and structured error responses. Use when you need to validate incoming API requests.
api-contracts-and-zod-validation
Generate Zod schemas and TypeScript types for forms, API routes, and Server Actions with runtime validation. Use this skill when creating API contracts, validating request/response payloads, generating form schemas, adding input validation to Server Actions or route handlers, or ensuring type safety across client-server boundaries. Trigger terms include zod, schema, validation, API contract, form validation, type inference, runtime validation, parse, safeParse, input validation, request validation, Server Action validation.