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.

By wshobson · 9,544 installs

npx skills add wshobson/agents --skill postmortem-writing

Source repository · Upstream listing

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 and detailed worked examples Full template library and detailed worked examples live in references/details.md . Read that file when you need the concrete templates. 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 Actions should be meaningful Don't skip follow up Verify actions completed