create-openapi-overlay
Use when you need to customize SDK generation without editing the source spec, or can't modify the original OpenAPI file
npx skills add majiayu000/claude-skill-registry --skill create-openapi-overlay --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# create-openapi-overlay Overlays let you customize an OpenAPI spec for SDK generation without modifying the source. ## Create Overlay Template ```bash speakeasy overlay create -s <spec-path> -o <output-path> ``` ## When to Use Overlays **Overlays are great for:** - Renaming operations (x-speakeasy-name-override) - Adding descriptions/summaries - Grouping operations (x-speakeasy-group) - Adding retry configuration - Marking endpoints as deprecated - Adding SDK-specific extensions - Fixing spec issues without modifying the source - Adding new endpoints or schemas - Making portable patches that work across spec versions **Overlays cannot easily handle:** - Deduplication of schemas (requires structural analysis) ## Example Overlay ```yaml overlay: 1.0.0 info: title: SDK Customizations version: 1.0.0 actions: - target: "$.paths['/users'].get" update: x-speakeasy-group: users x-speakeasy-name-override: list - target: "$.paths['/users'].post" update: x-speakeasy-group: users x-speakeasy-name-override: create - target: "$.paths['/users/{id}'].get" update: x-speakeasy-group: users x-speakeasy-name-override: get - target: "$.paths['/users/{id}'].delete" update: x-speakeasy-group: users x-sp
- Create Overlay Template
- When to Use Overlays
- Example Overlay
- JSONPath Targeting
speakeasy overlay create -s <spec-path> -o <output-path>
What does the create-openapi-overlay skill do?
Use when you need to customize SDK generation without editing the source spec, or can't modify the original OpenAPI file
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill create-openapi-overlay --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.