speakeasy-api/agent-skills

1

writing-openapi-specs Reference guide for OpenAPI specification best practices, naming conventions, and expressing complex REST API pattern…

speakeasy-api/agent-skills

19

2

start-new-sdk-project >- Use when generating a new SDK from an OpenAPI spec. This is the PRIMARY skill for SDK generation. Triggers on "cre…

speakeasy-api/agent-skills

18

3

diagnose-generation-failure Use when SDK generation failed or seeing errors. Triggers on "generation failed", "speakeasy run failed", "SDK build …

speakeasy-api/agent-skills

17

4

manage-openapi-overlays Use when creating, applying, or validating overlay files including x-speakeasy extensions.

speakeasy-api/agent-skills

17

5

extract-openapi-from-code Use when extracting or generating an OpenAPI spec from existing API code.

speakeasy-api/agent-skills

13

6

speakeasy-context Speakeasy workflow: run 'agent context' FIRST, do task, run 'agent feedback' LAST. Triggers on speakeasy, SDK, OpenAP…

speakeasy-api/agent-skills

13

7

improve-sdk-naming Use when you want AI-powered suggestions for SDK naming improvements via the `speakeasy suggest` command (not manual …

speakeasy-api/agent-skills

12

8

configure-sdk-options >- Use when CONFIGURING an existing SDK - NOT for initial generation. Covers gen.yaml configuration for all languages…

speakeasy-api/agent-skills

11

9

customize-sdk-hooks Use when implementing SDK code hooks for custom logic (not spec configuration or runtime overrides). Covers SDK lifec…

speakeasy-api/agent-skills

11

10

generate-mcp-server Use when generating an MCP server from an OpenAPI spec with Speakeasy. Triggers on "generate MCP server", "MCP server…

speakeasy-api/agent-skills

11

11

generate-terraform-provider >- Use when generating a Terraform provider from an OpenAPI spec with Speakeasy. Covers entity annotations, CRUD mapp…

speakeasy-api/agent-skills

10

12

orchestrate-multi-target-sdks >- Use when generating SDKs for multiple languages from a single OpenAPI spec, or multiple SDK variants from differen…

speakeasy-api/agent-skills

10

13

setup-sdk-testing Use when setting up SDK testing, configuring contract tests, writing Arazzo test workflows, or running integration te…

speakeasy-api/agent-skills

10

14

orchestrate-multi-repo-sdks >- Use when each language SDK lives in a separate repository. Covers cross-repo workflow dispatch, PR status reportin…

speakeasy-api/agent-skills

9

15

validate-openapi-spec Use when checking if an OpenAPI spec is valid or has errors. Triggers on "validate spec", "lint spec", "check OpenAPI…

speakeasy-api/agent-skills

9

16

apply-openapi-overlay Use when applying an overlay file to a spec. Triggers on "apply overlay", "overlay apply", "merge overlay", "speakeas…

speakeasy-api/agent-skills

7

17

check-workspace-status Use when checking current Speakeasy setup or workspace info. Triggers on "workspace status", "speakeasy status", "wha…

speakeasy-api/agent-skills

7

18

configure-authentication Use when setting up Speakeasy auth or troubleshooting auth errors. Triggers on "set up API key", "configure auth", "s…

speakeasy-api/agent-skills

7

19

create-openapi-overlay Use when customizing SDK generation without editing the source spec. Triggers on "create overlay", "overlay file", "c…

speakeasy-api/agent-skills

7

20

fix-validation-errors-with-overlays Use when you have lint errors but can't modify the source spec. Triggers on "fix with overlay", "can't edit spec", "a…

speakeasy-api/agent-skills

7

21

get-ai-suggestions Use when wanting AI-powered improvements for your spec. Triggers on "suggest improvements", "improve my spec", "speak…

speakeasy-api/agent-skills

7

22

improve-operation-ids Use when SDK methods have ugly auto-generated names. Triggers on "ugly method names", "GetApiV1Users", "improve opera…

speakeasy-api/agent-skills

7

23

merge-openapi-specs Use when combining multiple OpenAPI specs into one. Triggers on "merge specs", "combine specs", "multiple OpenAPI fil…

speakeasy-api/agent-skills

7

24

regenerate-sdk Use when spec changed and SDK needs regenerating. Triggers on "regenerate SDK", "run speakeasy", "speakeasy run", "re…

speakeasy-api/agent-skills

7

25

customize-sdk-runtime Use when configuring SDK runtime behavior such as retries, timeouts, pagination, server selection, custom code hooks,…

speakeasy-api/agent-skills

1

26

sdk-tf-generation-best-practices Use when generating SDKs, Terraform providers, or MCP servers with Speakeasy, or when needing best practices for SDK/…

speakeasy-api/agent-skills

1