sdk-tf-generation-best-practices

SKILL.md

Comprehensive best-practices reference for generating SDKs and Terraform providers with Speakeasy. Covers the full lifecycle: OpenAPI spec preparation, code-first extraction, generation workflows, language-specific guides, customization, and testing.

This skill contains detailed guides in the content/ subdirectory relative to this file. Read the specific guide for the user's task rather than trying to answer from this index alone.

To find the right guide, use the routing table below or the decision tree.

Use when generating SDKs, Terraform providers, or MCP servers with Speakeasy, or when needing best practices for SDK/Terraform generation, customization, testing, or OpenAPI spec management. Triggers on "generate SDK", "regenerate SDK", "update SDK", "create terraform provider", "generate MCP server", "SDK best practices", "speakeasy generation", "SDK customization", "fix generation", "SDK hooks", "SDK testing", "test my SDK", "openapi overlay", "upgrade speakeasy", "bump version", "SDK readme", "SDK documentation", "add examples to spec". Source: speakeasy-api/agent-skills.

View raw