Customer Incident Update
During an outage, silence is the second failure. But the customer update is its own craft: say what's affected without guessing at causes, commit to a next-update time you can keep, and never promise a fix-by you don't control. This writes the post for the stage you're in — the messy middle included — so customers feel informed, not managed.
What This Skill Produces
- The update, in the tense of the current stage (investigating / identified / monitoring / resolved)
- The impact line — who and what is affected, in the customer's terms
- The workaround — if one exists, stated plainly
- The next-update commitment — a specific time, always
- Channel variants — a terse status-page version and a fuller email if needed
Required Inputs
Ask for these if not provided:
- Stage — investigating, identified, monitoring, or resolved
- Impact — which product/region/customers, and what they can't do right now
- What's known — only what you're confident of; unknowns stay unknown in the post
- Workaround — any, or none
- Audience — all customers, affected only, or enterprise accounts (tone shifts)
Framework: Honest Status Comms
- Match the tense to the stage. "We're investigating" ≠ "we've identified" ≠ "we're monitoring the fix." Don't skip ahead.
- Impact before cause. Customers care what's broken for them; causes come in the postmortem, not mid-incident.
- Commit to the next update, not the fix. "Next update by 15:00 UTC" is a promise you can keep; "fixed within the hour" often isn't.
- No speculation. If you don't know the cause, say you're investigating — a wrong guess published is worse than an honest unknown.
- Own it plainly. Brief, human, no corporate throat-clearing; apologise once, then inform.
Output Format
Status-page post
[Investigating/Identified/Monitoring/Resolved] — [title] · [timestamp]
[Impact: who/what]. [What we're doing]. [Workaround, if any]. Next update by [time].
Email (if broader comms needed)
- Subject: [clear, non-alarmist]
- Body: impact → status → workaround → next update → apology
- Sign-off
Update ladder (for the incident's life)
- The follow-on posts you'll publish as the stage changes, pre-drafted
Quality Checks
Anti-Patterns
- "Some users may be experiencing issues" when it's a full outage — minimising erodes trust faster than the outage.
- Promising a resolution time you can't control.
- Publishing a guessed cause that turns out wrong.
- No next-update time — leaves customers refreshing in the dark.
- Skipping stages — jumping to "resolved" before monitoring confirms it.
Example Trigger Phrases
- "Write a status page update — we're investigating an outage."
- "Draft customer comms for the API downtime, identified stage."
- "Post an incident notice for enterprise accounts."
- "We've deployed a fix and are monitoring — write the update."
1---2name: customer-incident-update3description: Write the customer-facing incident update during an outage — status-page post or email — that's honest about impact without over-promising. Use when asked to write a status page update, draft customer comms for an outage, post an incident notice, or tell customers about downtime. Produces the update in the right tense for the incident stage (investigating / identified / monitoring / resolved), with impact scope, any workaround, and a concrete next-update time. Distinct from incident-postmortem (the internal retro).4---5
6# Customer Incident Update
7
8During an outage, silence is the second failure. But the customer update is its own craft: say what's affected without guessing at causes, commit to a next-update time you can keep, and never promise a fix-by you don't control. This writes the post for the stage you're in — the messy middle included — so customers feel informed, not managed.
9
10## What This Skill Produces
11
12- **The update**, in the tense of the current stage (investigating / identified / monitoring / resolved)
13- **The impact line** — who and what is affected, in the customer's terms
14- **The workaround** — if one exists, stated plainly
15- **The next-update commitment** — a specific time, always
16- **Channel variants** — a terse status-page version and a fuller email if needed
17
18## Required Inputs
19
20Ask for these if not provided:
21- **Stage** — investigating, identified, monitoring, or resolved
22- **Impact** — which product/region/customers, and what they can't do right now
23- **What's known** — only what you're confident of; unknowns stay unknown in the post
24- **Workaround** — any, or none
25- **Audience** — all customers, affected only, or enterprise accounts (tone shifts)
26
27## Framework: Honest Status Comms
28
291. **Match the tense to the stage.** "We're investigating" ≠ "we've identified" ≠ "we're monitoring the fix." Don't skip ahead.
302. **Impact before cause.** Customers care what's broken for them; causes come in the postmortem, not mid-incident.
313. **Commit to the next update, not the fix.** "Next update by 15:00 UTC" is a promise you can keep; "fixed within the hour" often isn't.
324. **No speculation.** If you don't know the cause, say you're investigating — a wrong guess published is worse than an honest unknown.
335. **Own it plainly.** Brief, human, no corporate throat-clearing; apologise once, then inform.
34
35## Output Format
36
37### Status-page post
38> **[Investigating/Identified/Monitoring/Resolved] — [title]** · [timestamp]
39> [Impact: who/what]. [What we're doing]. [Workaround, if any]. Next update by [time].
40
41### Email (if broader comms needed)
42- Subject: [clear, non-alarmist]
43- Body: impact → status → workaround → next update → apology
44- Sign-off
45
46### Update ladder (for the incident's life)
47- The follow-on posts you'll publish as the stage changes, pre-drafted
48
49## Quality Checks
50- [ ] The tense matches the actual stage — no claiming a fix that isn't confirmed
51- [ ] Impact is stated in customer terms, up top
52- [ ] A specific next-update time is given
53- [ ] No cause is speculated when it isn't known
54- [ ] No fix-by time is promised that depends on an unknown
55- [ ] Tone is human and brief — one apology, no jargon
56
57## Anti-Patterns
58- **"Some users may be experiencing issues"** when it's a full outage — minimising erodes trust faster than the outage.
59- **Promising a resolution time** you can't control.
60- **Publishing a guessed cause** that turns out wrong.
61- **No next-update time** — leaves customers refreshing in the dark.
62- **Skipping stages** — jumping to "resolved" before monitoring confirms it.
63
64## Example Trigger Phrases
65- "Write a status page update — we're investigating an outage."
66- "Draft customer comms for the API downtime, identified stage."
67- "Post an incident notice for enterprise accounts."
68- "We've deployed a fix and are monitoring — write the update."