Skip to main content
prompt GP ChatGPT

API Client SDK taste — ChatGPT prompt: what it does, how to install

API Client SDK taste — a prompt for ChatGPT that defines developer-experience standards for building API client SDKs. It runs during API architecture design, OpenAPI code generation, and error-handling setup.

CC0-1.0 ★ 178,201 updated 2026-10-24

Open on GitHub

What API Client SDK taste does

This prompt sets guidelines for building developer-friendly API client SDKs by generating low-level clients from an OpenAPI spec and writing a thin idiomatic layer on top. It establishes rules for three-line client initialization, environment variable API key handling, and fully typed request and response models.

The prompt outlines structured error returns, automatic retries with exponential backoff for timeouts and 429 or 5xx responses, auto-paginating iterators, and streaming responses via async generators. It also details versioning policies, minimal runtime dependencies, test suites against recorded HTTP fixtures, and secure package publishing from CI.

To use it in Claude Code, place the file .claude/commands/prompts.csv.md. The prompt can also be loaded directly into ChatGPT and Claude.ai sessions as system instructions or initial context.

What it helps with

  • generate client from OpenAPI spec
  • configure retries and backoff
  • implement auto-pagination and streaming
  • return typed SDK errors
  • run tests against HTTP fixtures

Example prompts for the agent

  • Apply the API Client SDK taste prompt to design our API client
  • Use API Client SDK taste to define SDK standards
  • Review the SDK architecture using API Client SDK taste

How to install API Client SDK taste

How to use

Paste the text at the start of a chat or into project instructions

Questions about API Client SDK taste

How to install API Client SDK taste in Claude Code?

To use it in Claude Code, place the file .claude/commands/prompts.csv.md.

What does API Client SDK taste do?

The prompt defines requirements for API client SDK design, covering OpenAPI generation, typing, error handling, retries, and versioning.

Which platforms support API Client SDK taste?

The prompt runs in ChatGPT, Claude.ai, and Claude Code.

Source text

prompts.csv · CC0-1.0
# API Client SDK taste of a developer-experience focused SDK maintainer
- Generate the low-level client from an OpenAPI spec, and hand-write only a thin, idiomatic layer on top. Confidence: 0.85
- Treat the API spec as the source of truth and fail CI when the generated code is out of date. Confidence: 0.85
- Make the first call possible in three lines: install, create a client with an API key, call one method. Confidence: 0.90
- Read the API key from a well-known environment variable by default, and never log it or include it in error messages. Confidence: 0.95
- Expose fully typed request and response models, with TypeScript types or Python type hints shipped in the package. Confidence: 0.90
- Return typed errors with the HTTP status, error code, message and request ID, instead of a generic exception. Confidence: 0.90
- Retry idempotent requests on timeouts, 429 and 5xx responses with exponential backoff and jitter, and respect Retry-After headers. Confidence: 0.90
- Send an idempotency key automatically on retried POST requests when the API supports it. Confidence: 0.80
- Set sensible default timeouts and let callers override timeout and retry settings per client and per request. Confidence: 0.85
- Provide auto-paginating iterators so users can loop over all results without handling cursors themselves. Confidence: 0.85
- Support streaming responses with native async iterators or generators instead of callbacks. Confidence: 0.80
- Offer both sync and async clients in languages where both are common, sharing the same models. Confidence: 0.75
- Keep runtime dependencies minimal and avoid pinning users to a specific HTTP library version. Confidence: 0.85
- Send a User-Agent header with the SDK name, version and runtime so API owners can see adoption and debug issues. Confidence: 0.80
- Follow semantic versioning strictly and document breaking changes with migration examples in the changelog. Confidence: 0.90
- Never remove a method in a minor release; deprecate it with a warning first. Confidence: 0.85
- Test against recorded HTTP fixtures for speed and run a smaller suite against a real sandbox environment nightly. Confidence: 0.80
- Run the test suite on every supported runtime version in CI, such as each active Node.js LTS or Python release. Confidence: 0.85
- Put runnable code examples in the README and docs, and test those examples in CI so they never go stale. Confidence: 0.80
- Expose hooks or middleware for logging, tracing and custom headers instead of adding one-off options for each need. Confidence: 0.75
- Allow a custom base URL and HTTP client so users can point the SDK at proxies, mocks or regional endpoints. Confidence: 0.80
- Publish packages from CI with provenance and signed releases, never from a maintainer's laptop. Confidence: 0.75

© f · CC0-1.0 · f/prompts.chat

Similar prompts

All prompts for Backend and APIs →

From the same set218

The whole set →
Next.js App taste Next.js App taste — a prompt for ChatGPT and Claude.ai that enforces pragmatic Next.js App Router conventions. It steers code generation toward Server Components, safe caching, and strict data validation. GP ChatGPT ★ 178,201repo stars Data Visualization taste The Data Visualization taste ChatGPT prompt guides clear data visualization. It helps choose a chart type, format its elements, and check accessibility. GP ChatGPT ★ 178,201repo stars Load Testing taste The Load Testing taste prompt for ChatGPT sets performance testing standards and reliability engineering principles. It is applied when designing load test scenarios and analyzing backend capacity. GP ChatGPT ★ 178,201repo stars Neovim Config taste The Neovim Config taste ChatGPT prompt sets out a terminal-first style for building a Neovim configuration in Lua. It covers plugin loading, language tools, formatting, and key bindings. GP ChatGPT ★ 178,201repo stars dbt Analytics Project taste dbt Analytics Project taste — a prompt for ChatGPT sets conventions for dbt models, tests, documentation, and CI. Use it while shaping an analytics project or revising its model structure. GP ChatGPT ★ 178,201repo stars Design System taste Design System taste — a prompt for ChatGPT that enforces pragmatic design system standards, tokens, accessibility, and component architecture. GP ChatGPT ★ 178,201repo stars Unity Game Project taste Unity Game Project taste — a prompt for ChatGPT that sets engineering guidelines for Unity game projects. It covers code structure, assets, testing, and builds. GP ChatGPT ★ 178,201repo stars Ansible Playbook taste Ansible Playbook taste — a prompt for ChatGPT, Claude.ai, and Claude Code setting standards for infrastructure code. It aligns Ansible roles with best practices and ensures task idempotency. GP ChatGPT ★ 178,201repo stars

Project sponsors

Companies that keep this analytics open