Agent skill · data analytics · jeremylongshore
clade-common-errors
Diagnose and fix Anthropic API errors \u2014 authentication, rate limits,\n\
Why this skill is useful
Provides specific error handling patterns and API usage examples for the Anthropic API that the AI wouldn't reliably generate on its own.
What it needs
Requires curl installed locally. Requires anthropic account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Anthropic Common Errors Overview Every Anthropic API error includes a type field and HTTP status code. Here are the real errors you'll hit and how to fix them. Error Reference Instructions Step 1: authenticationerror (401) Cause: API key is missing, malformed, or revoked. Fix: --- Step 2: ratelimiterror (429) Cause: Exceeded requests per minute (RPM) or tokens per minute (TPM). Fix: Rate limit tiers (as of 2025): Tier RPM TPM (input) TPM (output) ------ ----- ------------- -------------- Tier 1 (free) 50 40,000 8,000 Tier 2 ($40+) 1,000 80,000 16,000 Tier 3 ($200+) 2,000 160,000 32,000 Tier 4 ($400+) 4,000 400,000 80,000 --- Step 3: overloadederror (529) Cause: Anthropic API is temporarily at capacity. This is NOT a rate limit — it's server load. Fix: --- Step 4: invalidrequesterror (400) Common causes: Messages don't alternate user/assistant maxtokens missing or exceeds model limit Image too large (>5MB) or wrong format Invalid model ID Fix: Validate messages before sending: --- Step 5: notfounderror (404) Cause: Invalid model ID or model not available on your plan. Fix: Use exact model IDs: claude-opus-4-20250514 claude-sonnet-4-20250514 claude-haiku-4-5-20251001 --- Step 6: Content too long (context window) Fix: Quick Diagnostic Output Identified error type and HTTP status code Root cause determined from error message Applied fix (key rotation, backoff, input validation, model ID correction) Verified resolution with successful API call Error Handling Error Cause Solution ------- ------- ---------- API Error Check error type and status code See clade-common-errors Examples Each error section above includes the exact JSON error response, cause analysis, and fix code. See Quick Diagnostic section for curl commands to test connectivity. Resources Error Types Reference Rate Limits Anthropic Status Next Steps For deeper debugging, see clade-debug-bundle. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/clade-common-errors--4ab358