Klaviyo Incident Runbook

What it does

When your agent uses it

• Responding to Klaviyo-related outages
• Investigating API errors (401/403/429/5xx)
• Running post-incident reviews for Klaviyo integration failures on an on-call rotation
• With phrases like klaviyo incident

Example prompts

• “klaviyo incident”
• “klaviyo outage”
• “klaviyo down”
• “/klaviyo-incident-runbook”

Requirements

• Python 3
• A credential in KLAVIYO_PRIVATE_KEY
• Compatibility (from SKILL.md): Designed for Claude Code
• Pre-approved tools (allowed-tools): Read, Bash(curl:*), Bash(kubectl:*), Bash(npm:*)

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

1. 1Triage immediately. Run the quick-triage script to answer the four
2. 2Classify the failure. Walk the decision tree in
3. 3Assign a severity from the table above and set the response-time clock.
4. 4Apply the remediation for the observed error type — auth failure (401),
5. 5Communicate and write the postmortem. Post the internal + external

What it can do on your machine

Read from SKILL.md and the folder at commit cfae287. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Read
  • Bash(curl:*)
  • Bash(kubectl:*)
  • Bash(npm:*)

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • curl
  • python3

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • status.klaviyo.com
  • a.klaviyo.com

  Also links to:

  • klaviyo.com
  • developers.klaviyo.com

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • KLAVIYO_PRIVATE_KEY

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

• Compatibility

  Designed for Claude Code

  From compatibility in the SKILL.md frontmatter.

Context cost

Klaviyo Incident Runbook loads about 1.5k tokens when it runs, and up to ~3.3k if it reads all its reference files. Until then it costs about 108 tokens; SKILL.md has 561 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~108

When it runs · the whole SKILL.md, loaded when a task matches

~1.5k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~3.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 561 words, ~1,480 tokens.

name

klaviyo-incident-runbook

description

Execute Klaviyo incident response procedures with triage, mitigation, and postmortem. Use when responding to Klaviyo-related outages, investigating API errors (401/403/429/5xx), or running post-incident reviews for Klaviyo integration failures on an on-call rotation. Trigger with phrases like "klaviyo incident", "klaviyo outage", "klaviyo down", "klaviyo on-call", "klaviyo emergency", "klaviyo broken".

allowed-tools

Read, Bash(curl:*), Bash(kubectl:*), Bash(npm:*)

compatibility

Designed for Claude Code

version

1.7.0

license

MIT

author

Jeremy Longshore <jeremy@intentsolutions.io>

tags

saas, klaviyo, email-marketing, cdp

# Is Klaviyo itself down, or is it us?
curl -s "https://status.klaviyo.com/api/v2/status.json" \
  | python3 -c "import sys,json; d=json.load(sys.stdin); print(d['status']['description'])"

curl -s -w "\nHTTP %{http_code}\n" -o /dev/null \
  -H "Authorization: Klaviyo-API-Key $KLAVIYO_PRIVATE_KEY" \
  -H "revision: 2024-10-15" \
  "https://a.klaviyo.com/api/accounts/"
# 401 → key problem  ·  429 → rate limited  ·  5xx → Klaviyo server error

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/.curated/klaviyo-incident-runbook of jeremylongshore/tons-of-skills-marketplace.

• SKILL.md
• references/communication-and-postmortem.md
• references/remediation.md
• references/triage.md

Open the folder on GitHubat commit cfae287