speakeasy-api

apply-openapi-overlay

@speakeasy-api/apply-openapi-overlay
speakeasy-api
377
30 forks
Updated 1/18/2026
View on GitHub

Use when applying an overlay file to a spec

Installation

$skills install @speakeasy-api/apply-openapi-overlay
Claude Code
Cursor
Copilot
Codex
Antigravity

Details

Repositoryspeakeasy-api/speakeasy
Pathskills/apply-openapi-overlay/SKILL.md
Branchmain
Scoped Name@speakeasy-api/apply-openapi-overlay

Usage

After installing, this skill will be available to your AI coding assistant.

Verify installation:

skills list

Skill Instructions

name: apply-openapi-overlay description: Use when applying an overlay file to a spec

apply-openapi-overlay

Command

speakeasy overlay apply -s <spec-path> -o <overlay-path> --out <output-path>

Example

# Apply overlay and output merged spec
speakeasy overlay apply -s openapi.yaml -o my-overlay.yaml --out openapi-modified.yaml

Using in Workflow

Better approach - add overlay to workflow.yaml:

sources:
  my-api:
    inputs:
      - location: ./openapi.yaml
    overlays:
      - location: ./naming-overlay.yaml
      - location: ./grouping-overlay.yaml

Overlays are applied in order, so later overlays can override earlier ones.

More by speakeasy-api

View all
get-ai-suggestions
377

Use when SDK method names are ugly, wanting to improve operation IDs, or asking "how can I improve my spec"

merge-openapi-specs
377

Use when combining multiple OpenAPI specs, or have microservices with separate spec files

diagnose-generation-failure
377

name: diagnose-generation-failure

validate-openapi-spec
377

Use when checking if an OpenAPI spec is valid, looking for errors, or running `speakeasy lint`