configure-sdk-options

Configure Speakeasy SDK generation options and runtime behavior via gen.yaml.

Updated Feb 23, 2026
One-click install
npx skills add https://github.com/berea-ch/bereach-sdk-ts --skill configure-sdk-options-berea-ch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: configure-sdk-options
Source: https://github.com/berea-ch/bereach-sdk-ts/tree/main/.agents/skills/configure-sdk-options
Command: npx skills add https://github.com/berea-ch/bereach-sdk-ts --skill configure-sdk-options-berea-ch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers configure existing Speakeasy SDKs by modifying their gen.yaml file and setting runtime overrides for various languages.

Core Features & Use Cases

  • Language-Specific Configuration: Tailor SDK generation for TypeScript, Python, Go, Java, C#, PHP, and Ruby.
  • Runtime Overrides: Adjust server selection, timeouts, and retry strategies directly in application code.
  • Use Case: You have an existing TypeScript SDK and want to enable React Query hooks and configure Pydantic models for Python. This Skill guides you through the necessary gen.yaml changes and provides examples.

Quick Start

Use the configure-sdk-options skill to set the TypeScript module format to 'dual' and enable React Query hooks.

Frequently Asked Questions about configure-sdk-options

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure Speakeasy SDK generation options in gen.yaml?

To configure Speakeasy SDK generation, you modify the gen.yaml file to define language-specific features like validation, async modes, and publishing settings. This Skill guides you through the exact schema changes needed for your target language.

Can I enable React Query hooks when generating a TypeScript SDK?

Yes, you can enable React Query hooks for a TypeScript SDK by adjusting the generation parameters in your gen.yaml file. You can also set the TypeScript module format to 'dual' during this configuration process.

How do I set runtime overrides for server selection and timeouts in my SDK?

You set runtime overrides for server selection, timeouts, and retry strategies directly in your application code. This allows you to manage runtime aspects dynamically without altering the underlying SDK generation configuration.

Does Speakeasy gen.yaml support configuring Pydantic models for Python SDKs?

Yes, gen.yaml supports configuring Python SDKs to use Pydantic models. You can tailor SDK generation across multiple languages including TypeScript, Python, Go, Java, C#, PHP, and Ruby using the configuration schema.

What are the limitations of using gen.yaml for SDK customization?

Customizing SDKs via gen.yaml requires an existing Speakeasy SDK and an understanding of Speakeasy's configuration schema and language-specific patterns. Complex runtime behaviors must be handled through code overrides rather than generation settings.