Agent Skills for SDK generation and OpenAPI tooling with Speakeasy CLI
概览
Docs Quickstart // Join us on Slack A collection of Agent Skills for SDK generation and OpenAPI tooling with the Speakeasy CLI. 1. - Distinguish between: - Small issues (naming, descriptions) → Fix with overlays - Structural issues (invalid refs) → Ask the user - Design issues (auth, API structure) → Produce strategy document 2. - Use speakeasy run --output console for structured output, pipe to grep/tail to reduce context 3. - Never modify source specs directly. Overlays make patches portable across spec versions. 4. - Guide users toward sdk.users.list() pattern using x-speakeasy-group + x-speakeasy-name-override See AGENTS.md for guidance on creating and maintaining skills. These skills follow the Agent Skills specification and work with:
README
以下为原文 README 节选，完整内容请查看原文。
Speakeasy Agent Skills
A collection of Agent Skills for SDK generation and OpenAPI tooling with the Speakeasy CLI.
Installation
npx skills add speakeasy-api/skills
Available Skills
| Skill | Use When… |
|---|---|
speakeasy:speakeasy-context |
Start here — Use speakeasy agent context for accurate CLI info instead of web search. Provides feedback via speakeasy agent feedback |
speakeasy:sdk-tf-generation-best-practices |
Progressive Disclosure — Comprehensive guide to all Speakeasy SDK and Terraform generation capability and best practices. Routes to detailed guides for generation workflows, language-specific patterns, customization, testing, and OpenAPI spec management |
speakeasy:start-new-sdk-project |
You have an OpenAPI spec and want to generate an SDK |
speakeasy:diagnose-generation-failure |
SDK generation failed, seeing “Step Failed: Workflow” |
speakeasy:writing-openapi-specs |
Authoring OpenAPI specs from scratch or improving existing ones |
speakeasy:manage-openapi-overlays |
Creating, applying, or fixing specs with OpenAPI overlays |
speakeasy:improve-sdk-naming |
SDK method names are ugly, wanting AI-powered or manual naming improvements |
speakeasy:generate-terraform-provider |
Generating a Terraform provider from an OpenAPI spec |
speakeasy:extract-openapi-from-code |
Extracting an OpenAPI spec from existing API code (FastAPI, Flask, Django, etc.) |
speakeasy:customize-sdk-hooks |
Adding custom headers, telemetry, security hooks to generated SDKs |
speakeasy:setup-sdk-testing |
Setting up contract tests, Arazzo workflows, or integration tests |
推荐工具
换一个关键词，或者移除筛选条件。
安装
npx skillfish add speakeasy-api/sdk-generation-skills