write-a-postmortem

Writes blameless incident postmortems in markdown following the Google SRE structure.

3.9k|256|Updated Jun 3, 2026
One-click install
npx skills add https://github.com/inkeep/open-knowledge --skill write-a-postmortem
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-a-postmortem
Source: https://github.com/inkeep/open-knowledge/tree/main/packages/server/assets/skills/packs/software-lifecycle/write-a-postmortem
Command: npx skills add https://github.com/inkeep/open-knowledge --skill write-a-postmortem

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

After an outage, teams struggle to produce postmortems that are blameless, evidence-based, and actionable — timelines get reconstructed from memory, triggers get mistaken for root causes, and action items ship without owners or dates. This Skill enforces a disciplined Google SRE-style postmortem process so every incident produces a durable document that actually prevents recurrence.

Core Features & Use Cases

  • Blamelessness enforcement: Names systems and roles instead of individuals, reframes blame-seeking requests, and treats every human action as reasonable given the information available at the time.
  • Evidence-sourced timelines: Requires every timeline entry to cite an artifact (alert ID, deploy log, dashboard, chat timestamp), explicitly labels recollection-based entries, and surfaces the detection gap between onset and first page.
  • Repeat-class detection: Scans prior postmortems in postmortems/ for the same subsystem and elevates recurrences into the Summary, since a repeat means a prior action item failed to land.
  • Verifiable action items: Requires an owner, due date, and checkable done-condition per item, classified as prevention, mitigation, or detection, with runbook stubs auto-created in guides/ for guide-shaped items.
  • Use Case: After a 47-minute checkout outage caused by a config change that halved the connection pool, ask the agent to write the postmortem — it pulls deploy logs and chat transcripts, builds a sourced timeline, separates trigger from root cause, links the two prior pool-exhaustion incidents, and files owned action items including a new runbook stub.

Quick Start

Ask your agent to write a blameless postmortem for the incident that happened on a given date, describing the affected system and what was observed.

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 the person's action, and treat every human action as reasonable given the information available at the time. This Skill enforces those rules mechanically and reframes blame-seeking requests before writing.

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. The Skill pushes past the first plausible cause to find the missing safeguard.

How should action items in a postmortem be written?

Every action item needs an owner (a role or team), a real due date, and a verifiable done-condition. Items are classified as prevention, mitigation, or detection, and guide-shaped items produce runbook stubs in guides/ with symptom and recovery steps pre-filled.

Can a postmortem timeline include events reconstructed from memory?

Yes, but every timeline entry must cite a source such as an alert ID, deploy timestamp, graph, or chat message. Entries reconstructed from recollection without an artifact must be explicitly labeled inline as such.

When should I not use a postmortem format?

Do not use a postmortem to frame a proposal, write a spec, record a decision, or relitigate architecture choices — a postmortem documents an incident that already happened. Design disagreements belong in a proposal or design review linked from the Related section.