Api Error Design
samber/developer-platform-skills/skills/api-error-designby samber594cf70d343eMIT3 starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 10 days ago
Design the error surface of a public API so integrators self-serve fixes - a machine-readable error-code taxonomy (flat catalog, code/subcode, Google-style domain/reason), the RFC 9457 problem-details envelope with extension members, actionable error messages, retryability signaling (retryable flag, Retry-After), and per-endpoint error documentation with request-ID tracking. Use whenever the user mentions API error codes, an error taxonomy, RFC 9457, application/problem+json, 4xx/5xx response bodies, or confusing API error messages - even if they never say "error design". Do NOT use for client-side retry mechanics - use samber/developer-platform-skills@api-idempotency-retry - nor for incident and status-page communication - use samber/developer-platform-skills@api-status-communication instead.
Only the file list is public. File contents are available once the skill is installed in a workspace.
| Path | Size | Type |
|---|---|---|
| evals/evals.json | 26.4 KB | application/json |
| references/error-documentation-examples.md | 3.8 KB | text/markdown |
| references/message-rewrite-examples.md | 3.5 KB | text/markdown |
| references/rfc9457-payload-examples.md | 4.7 KB | text/markdown |
| references/taxonomy-catalog-examples.md | 5.4 KB | text/markdown |
| SKILL.md | 18 KB | text/markdown |
Source and attribution
Source:samber/developer-platform-skillsinskills/api-error-designat commit594cf70
License: MIT
Content belongs to its original authors. SourceWeft indexes it from a public repository.
More from samber/developer-platform-skills
Webhook Platform Design
samber
Designs a provider-side outbound webhook platform: event catalog, payload envelope, signing, retries, subscriptions and debugging.
Sql Jdbc Access Design
samber
Designs customer-facing SQL access to a SaaS product's data, covering architecture, isolation, schema contracts, governance and pricing.
Sdk Portfolio Strategy
samber
Guides platform teams in writing a public API SDK portfolio strategy: language order, build model, support tiers, versioning and EOL.
Public Graphql Api Design
samber
Designs public GraphQL API surfaces: schema conventions, Relay pagination, typed errors, guardrails and federation boundaries.
Public Api Design Review
samber
Checklist-driven design review of public REST API surfaces, bucketing findings as Must-change or Improvement against cited rules.
Partner App Onboarding
samber
Designs a B2B SaaS partner-developer onboarding journey from signup to first submitted app, with gates, provisioning, education, support and funnel metrics.
More in Software Development
Playground
anthropics
Builds self-contained interactive HTML playgrounds with controls, live preview, and copyable prompt output.
M5 Onboard
anthropics
Provisions M5Stack ESP32 boards by detecting them on USB, flashing UIFlow 2.0 firmware, and installing a MicroPython app bundle.
Cardputer Buddy
anthropics
Guides iterating on a Cardputer-Adv MicroPython app bundle: adding apps, pushing files over USB-serial, tailing logs, and running REPL commands.
Web Design Guidelines
vercel-labs
Reviews UI code against Web Interface Guidelines fetched from a remote source and reports findings as file:line entries.
Vercel React Native Skills
vercel-labs
React Native and Expo best-practice rules covering list performance, animation, navigation, UI patterns, state, and monorepo setup.
Vercel React Best Practices
vercel-labs
Vercel's React and Next.js performance guidelines, organized as 70 rules for writing, reviewing, and refactoring code.