Agent skill · writing content · aiskillstore
postmortem-writing
Write effective blameless postmortems with root cause analysis, timelines, and action items. Use when conducting incident reviews, writing postmortem documents, or improving incident response processes.
Why this skill is useful
Provides a structured approach to writing postmortems that includes templates and best practices for root cause analysis, which the AI wouldn't reliably generate on its own.
What it needs
About 7k tokens when loaded. Last updated 2026-08-07. 405 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. When to Use This Skill 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 Practices Do's Start immediately - Memory fades fast Be specific - Exact times, exact errors Include graphs - Visual evidence Assign owners - No orphan action items Share widely - Organizational learning Don'ts Don't name and shame - Ever Don't skip small incidents - They reveal patterns Don't make it a blame doc - That kills learning Don't create busywork - …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/postmortem-writing--f05618