API Retries Backoff Resilience

Implement client and service resilience: retry only transient failures, exponential backoff with jitter, honor Retry-After, timeouts, and circuit breakers. Use when designing HTTP clients or outbound API calls.

deangrant c5f3618 4 files · 1.7 KB Updated

File contents

Retries, Backoff, and Resilience

Use this skill when callers retry HTTP dependencies safely.


1. What to retry

Retry transient failures (408, 429, 502, 503, 504, network blips). Do not blindly retry non-idempotent POSTs without Idempotency-Key.


2. Backoff

Exponential backoff + jitter. Honor Retry-After when present — it overrides client-computed delay. Cap attempts.


3. Defense in depth

Explicit timeouts on outbound calls; circuit breakers to shed load; bulkheads between dependency classes.


4. Quick checklist

  • Retry policy matches idempotency.
  • Backoff + jitter; honor Retry-After.
  • Timeouts always set.
  • Circuit breaker on unstable deps.

See reference.md and examples.md.

deangrant/agents/tree/main/.agents/skills/api-retries-backoff-resilience commit c5f3618e89

Frequently asked questions

npx skillmds@latest add deangrant/api-retries-backoff-resilience