Agent skill · data analytics · jeremylongshore
groq-common-errors
Diagnose and fix Groq API errors with real error codes and solutions.
Why this skill is useful
Provides specific commands and structured error handling for diagnosing Groq API errors that the AI wouldn't reliably generate on its own.
What it needs
Requires curl, jq installed locally. Requires groq account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Groq Common Errors Overview Comprehensive reference for Groq API error codes, their root causes, and proven fixes. Groq returns standard HTTP status codes with structured error bodies and rate-limit headers. This skill walks the diagnosis from raw error string to fix, then hands off to the full per-status reference for depth. Every Groq error body follows one shape — read the code and type first: Prerequisites GROQAPIKEY exported in the environment (keys start with gsk). curl and jq available for the diagnostic probes below. For SDK-level handling: groq-sdk (TypeScript) or groq (Python) installed. Instructions 1. Capture the failing status and body. Read the raw error response — the HTTP status plus the code/type fields determine the whole diagnosis path. 2. Confirm the key works before assuming anything deeper: 3. Confirm the model still exists. Many 400s are deprecated model IDs — list the live models and Grep your codebase for any stale ID: 4. Map the status to a fix using the table below, then drill into references/error-reference.md for the exact error string, causes, and copy-paste fix. 5. For SDK integrations, branch on the typed exception classes — see references/sdk-error-handling.md. Output A diagnosis that names the error class, the root cause, and the concrete fix — for example: "429 on TPM: token budget exhausted; add the single-retry handleRateLimit wrapper and honor retry-after," or "400: mixtral-8x7b-32768 is deprecated; switch to llama-3.3-70b-versatile." When run against real code, the output is the edited call site plus a verification curl that returns 200. Error Handling Map the HTTP status to its cause; full error strings, rate-limit headers, and fixes live in references/error-reference.md. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/groq-common-errors