Agent skill · marketing growth · jeremylongshore
groq-incident-runbook
Execute Groq incident response: triage, mitigation, fallback, and postmortem.
Why this skill is useful
Provides specific commands and workflows for incident response to Groq API failures that the AI wouldn't reliably generate on its own.
What it needs
Requires curl, kubectl 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 Incident Runbook Overview Rapid incident response procedures for Groq API failures. Groq is a third-party inference provider -- when it goes down, your mitigation options are: wait, fall back to a different model, or fall back to a different provider. This SKILL.md is the high-level flow. Deep, copy-paste-ready material lives in references/: triage-and-diagnostics.md — severity table, the Quick Triage script, and the full decision tree. mitigations.md — fallback-model routing (TypeScript), 429 rate-limit actions, 401 key rotation. communication-and-postmortem.md — Slack/status-page templates, evidence collection, postmortem template. Prerequisites GROQAPIKEY exported in the environment you run the triage commands from. curl for API probes; kubectl only if you collect logs from a Kubernetes deployment. Access to console.groq.com to rotate keys or upgrade the plan. A configured fallback provider (e.g. OpenAI) if you need to fail away from Groq entirely. Authentication: every Groq API call in this runbook authenticates with a bearer token — Authorization: Bearer $GROQAPIKEY. Keep the key in a secret manager, never inline; the evidence-collection step in communication-and-postmortem.md redacts gsk tokens from logs before archiving. Instructions Work the incident in five phases. Each phase points to the reference file with the exact commands. 1. Classify severity. Match user impact to the P1–P4 table in triage-and-diagnostics.md — this sets your response-time budget (P1 < 15 min, P4 next business day). 2. Triage. Run the Quick Triage script (status reachability, auth, per-model availability, rate-limit headers). The one-line probe that starts most incidents: 3. Decide. Walk the decision tree in triage-and-diagnostics.md to turn the HTTP code (timeout / 401 / 429 / 5xx / slow) into an action path. 4. Mitigate. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/groq-incident-runbook