Agent skill · writing content · sickn33
postmortem-writing
Comprehensive guide to writing effective, blameless postmortems that drive organizational learning and prevent incident recurrence.
Why this skill is useful
Provides a structured approach and templates for writing postmortems that the AI wouldn't reliably generate on its own.
What it needs
About 8k tokens when loaded. Last updated 2026-08-07. 44,571 stars on the source repository.
What this skill does
Postmortem Writing Comprehensive guide to writing effective, blameless postmortems that drive organizational learning and prevent incident recurrence. Do not use this skill when The task is unrelated to postmortem writing You need a different domain or tool outside this scope Instructions Clarify goals, constraints, and required inputs. Apply relevant best practices and validate outcomes. Provide actionable steps and verification. If detailed examples are required, open resources/implementation-playbook.md. Use this skill when Conducting post-incident reviews Writing postmortem documents Facilitating blameless postmortem meetings Identifying root causes and contributing factors Creating actionable follow-up items Building organizational learning culture Core Concepts 1. Blameless Culture Blame-Focused Blameless --------------- ----------- "Who caused this?" "What conditions allowed this?" "Someone made a mistake" "The system allowed this mistake" Punish individuals Improve systems Hide information Share learnings Fear of speaking up Psychological safety 2. Postmortem Triggers SEV1 or SEV2 incidents Customer-facing outages > 15 minutes Data loss or security incidents Near-misses that could have been severe Novel failure modes Incidents requiring unusual intervention Quick Start Postmortem Timeline Templates Template 1: Standard Postmortem [Client] → [Load Balancer] → [Payment Service] → [Database] ↓ Connection Pool (broken) ↓ Direct connections (cause) Template 2: 5 Whys Analysis Template 3: Quick Postmortem (Minor Incidents) Facilitation Guide Running a Postmortem Meeting Anti-Patterns to Avoid Anti-Pattern Problem Better Approach -------------- --------- ----------------- Blame game Shuts down learning Focus on systems Shallow analysis Doesn't prevent recurrence Ask "why" 5 times No action items Waste of time Always have concrete next steps Unrealistic actions Never completed Scope to achievable tasks No follow-up Actions forgotten Track in ticketing system Best Pr …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sickn33/postmortem-writing--1f28e8