Back to Skills

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.

26,085stars2,876forksUpdated 1/20/2026

Security Assessment

Safe(100/100)
Security Score100/100

About postmortem-writing

The postmortem-writing skill is designed to assist teams in crafting effective and blameless postmortem documents, focusing on root cause analysis, timelines, and actionable follow-up items. By facilitating a structured approach to incident reviews, this skill helps organizations learn from past incidents, improve their incident response processes, and ultimately prevent future occurrences. In a culture that emphasizes learning rather than blame, teams can engage in more open discussions about failures, leading to better system designs and practices.

FAQ

When should I use the postmortem-writing skill?

You should use this skill when conducting post-incident reviews, writing postmortem documents, or facilitating blameless postmortem meetings.

What types of incidents trigger the need for a postmortem?

SEV1 or SEV2 incidents, customer-facing outages longer than 15 minutes, data loss or security incidents, and near-misses that could have been severe are all triggers.

Are there any requirements for using the postmortem-writing skill?

The skill is best utilized in a blameless culture that promotes psychological safety and open communication.

Can this skill be used for non-technical incidents?

While the primary focus is on technical incidents, the principles of blameless postmortems can be adapted for non-technical contexts as well.

Is there a specific format I must follow for postmortems?

Yes, the skill provides templates, such as the standard postmortem format, which outlines sections like executive summary, timeline, and root cause analysis.

Install postmortem-writing

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill

Repository

wshobson/agents