write-a-postmortem

Write blameless incident postmortems following the Google SRE structure with sourced timelines and verifiable action items.

Updated Sep 7, 2026
One-click install
npx skills add https://github.com/jcafeitosa/anxionOS --skill write-a-postmortem-jcafeitosa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: write-a-postmortem
Source: https://github.com/jcafeitosa/anxionOS/tree/main/.cursor/skills/write-a-postmortem
Command: npx skills add https://github.com/jcafeitosa/anxionOS --skill write-a-postmortem-jcafeitosa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Incident write-ups often devolve into blame, vague timelines, and action items nobody verifies. This Skill produces a disciplined, blameless postmortem grounded in evidence, so the document actually prevents recurrence instead of gathering dust. ## Core Features & Use Cases - Evidence-based timeline reconstruction: Every timeline entry cites an alert, deploy log, dashboard, or chat timestamp, with memory-based entries explicitly labeled. - Trigger vs root cause vs symptom separation: Pushes past the first plausible cause to the missing safeguard that made the trigger sufficient. - Repeat-class detection: Scans prior postmortems for the same subsystem and surfaces recurrences prominently in the Summary. - Owned, dated, verifiable action items: Classifies items as prevention, mitigation, or detection, and stubs runbooks in guides/ for guide-shaped items. - Use Case: After a 47-minute checkout outage caused by a config change, ask the agent to write the postmortem — it gathers evidence, builds a sourced timeline, identifies the 16-minute detection gap, links prior pool-exhaustion incidents, and files the document at postmortems/2024-03-02-payments-pool-exhaustion.md. ## Quick Start Ask the agent to write a blameless postmortem for yesterday's checkout outage using the write-a-postmortem skill, including the timeline, root cause, and action items.

Frequently Asked Questions about write-a-postmortem

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a blameless incident postmortem?▼

Name systems and roles instead of individuals, write the system's affordance rather than a person's action, and treat every human decision as reasonable given the information available. This Skill enforces those rules mechanically and refuses blame-seeking framing.

What is the difference between trigger, root cause, and symptom in a postmortem?▼

The symptom is what was observed, the trigger is the specific event that set off the incident, and the root cause is the condition that made the trigger sufficient to cause the outage. Root causes are usually missing safeguards, not the triggering action itself.

How should postmortem action items be written?▼

Every action item needs an owner (a role or team), a real due date, and a verifiable done-condition. Items should be classified as prevention, mitigation, or detection, and guide-shaped items should produce runbook stubs in the guides/ folder.

Does this skill work without the OpenKnowledge MCP server?▼

No. The skill requires an agent host with the OpenKnowledge MCP server configured, since all knowledge-base markdown operations go through its exec, search, write, edit, links, and audit tools. It is installed project-local via ok seed --pack software-lifecycle.

When should I not use a postmortem?▼

Do not use a postmortem to propose future work, write a spec, record a decision, or relitigate a design — those belong to proposal, spec, decision, or design-review documents. A postmortem only documents an incident that already happened.