Blame-driven postmortems; focus on systems, not people
Too much focus on "what" without "why"; understanding enables prevention
No action items; analysis without improvement is waste
Same action items as last postmortem; you're repeating the cycle
Rushed postmortems without facts; gather data before writing
Further Reading
Site Reliability Engineering (SRE) Postmortem guidelines (Google)
Blameless postmortems blog (Medium)
1---2name: postmortem-analysis3description: Postmortem Analysis4---56# Postmortem Analysis78Creating blameless postmortems to learn and prevent recurrence.910## Context1112You are documenting a failure for learning. Postmortems are not blame; they're prevention.1314## Domain Context1516- **Blameless**: Focus on systems/processes, not individuals17- **Timeline**: Precise sequence of events; when did people notice? Take actions?18- **Root Cause**: What enabled the bug? (not just "someone made a typo")19- **Prevention**: What would have caught this before production?20- **Action Items**: Specific, actionable improvements2122## Instructions23241. **Gather Facts**: Collect timeline, logs, team recollection; piece together events252. **Create Timeline**: When did each event occur? Label in 5-minute intervals263. **Document Context**: What was the system state? Load? Recent changes?274. **RCA**: Use 5 Whys or fishbone to identify root cause285. **Prevention**: What would have caught this? Better tests? Monitoring? Design change?296. **Write Postmortem**: Clear, factual narrative; no blame307. **Define Action Items**: Specific, assignable, measurable improvements3132## Anti-Patterns3334- Blame-driven postmortems; focus on systems, not people35- Too much focus on "what" without "why"; understanding enables prevention36- No action items; analysis without improvement is waste37- Same action items as last postmortem; you're repeating the cycle38- Rushed postmortems without facts; gather data before writing3940## Further Reading4142- Site Reliability Engineering (SRE) Postmortem guidelines (Google)43- Blameless postmortems blog (Medium)
Run npx skillmds@latest add sethdford/postmortem-analysis in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Postmortem Analysis It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
sethdford (@sethdford) published this skill. Their other Agent Skills are listed on their SkillMD profile.