error-handling-strategy Skill

Goal

Errors are inevitable. Handling them must be consistent, predictable, and safe.

Steps

1. Unified API Error Format (RFC 7807)

Never return raw stack traces or ad-hoc JSON strings. Use Problem Details:

{
  "type": "https://example.com/probs/out-of-credit",
  "title": "You do not have enough credit.",
  "status": 403,
  "detail": "Current balance is 30, but cost is 50.",
  "instance": "/account/12345/msgs/abc",
  "traceId": "00-5c14d5-..."
}