manage-openapi-overlays

SKILL.md

Overlays let you customize an OpenAPI spec for SDK generation without modifying the source. This skill covers creating overlay files, applying them to specs, and using them to fix validation errors.

| Target spec | Yes | OpenAPI spec to customize or fix | | Customizations | Depends | Changes to apply (groups, names, retries, descriptions) | | Overlay file | Depends | Existing overlay to apply (for apply workflow) | | Lint output | Helpful | Validation errors to fix (for fix workflow) |

| Overlay file | YAML file with JSONPath-targeted changes | | Modified spec | Transformed OpenAPI spec (when applying) |

Verwenden Sie diese Option beim Erstellen, Anwenden oder Verwenden von Overlays, um die SDK-Generierung anzupassen, ohne die Quellspezifikation zu bearbeiten. Löst aus bei „Overlay erstellen“, „Overlay anwenden“, „Overlay-Datei“, „SDK anpassen“, „Spezifikation kann nicht geändert werden“, „X-Speakeasy-Erweiterungen“, „Mit Overlay reparieren“, „Overlay-Fix“, „Overlay anwenden“ Quelle: speakeasy-api/agent-skills.

Original anzeigen