Skip to content
edge
371 installs on skills.sh

API Error Design

Design the error surface of a public API so integrators self-serve fixes - a machine-readable...

samber/developer-platform-skills
Security state: reviewed

3 static scans, 0 counted findings.

Edge checks it again each time your agent loads it.

SKILL.mdSkill file

From the samber public repository. Edge did not write or edit this skill.

What it does

  • 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.
SB

Why Samuel Berthe

Go open source author. Each fact links its public source.

  • Created samber/lo, 21k+ stars

    His Lodash-style Go generics library lo has 21k+ GitHub stars.

    GitHub
  • Packaged in Ubuntu

    lo ships as an Ubuntu source package, golang-github-samber-lo.

    Ubuntu packages
  • 3k+ stars on his Go skills

    His Golang agent skills collection has 3k+ GitHub stars.

    GitHub

Public sources, checked Oct 26, 2026.

How it works

  1. 1
    Copy

    Try for free gives you one prompt.

  2. 2
    Paste

    Paste it into Claude Code, Codex or Cursor.

  3. 3
    Ask

    Ask for the outcome. Your agent loads API Error Design.

Questions about API Error Design

What does API Error Design do?

Design the error surface of a public API so integrators self-serve fixes - a machine-readable... Published by Samuel Berthe (samber/developer-platform-skills).

Is API Error Design safe to use?

Edge security state: Reviewed (3 Edge-run static scans, scanned Sep 30, 2026). The Evidence tab shows the scan.

How do I use API Error Design in Claude Code, Codex or Cursor?

Click Try for free, pick your agent and follow its one step. Edge is free, with no Edge account.

Similar skills

Give your agent API Error Design.

Free. No Edge account.

Use API Error Design in your agent

Claude app

Add to Claude

Opens claude.ai in your browser. Add it once, and Edge is in the Claude desktop and phone apps too.
Then click Continue Add Connect and open a new chat.

Already added? Open a new chat in Claude.

ChatGPT

Add to ChatGPT

Opens the Edge plugin in ChatGPT. Click Install plugin, then start a new chat.

Claude Code or Codex

Free · No Edge accountOther agents