postmortem

Draft incident postmortems with timeline, root causes, and corrective actions.

Updated Apr 28, 2026
One-click install
npx skills add https://github.com/ChazzCoin/claude-kit --skill postmortem-chazzcoin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: postmortem
Source: https://github.com/ChazzCoin/claude-kit/tree/main/kit/skills/postmortem
Command: npx skills add https://github.com/ChazzCoin/claude-kit --skill postmortem-chazzcoin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Draft a postmortem for an incident — production outage, broken deploy, data loss, regression caught late. Captures timeline, root cause, contributing factors, what we changed (or will change) to prevent recurrence. Stored in docs/postmortems/YYYY-MM-DD-slug.md and logged in AUDIT.md. Triggered when something broke — e.g. "/postmortem", "write up what happened", "we need to capture this incident", "draft a postmortem for the deploy that broke".

Core Features & Use Cases

  • Structured templates that capture the incident timeline, root-cause chains, contributing factors, and concrete action items.
  • Stores and references the postmortem in docs/postmortems/YYYY-MM-DD-slug.md and links to an AUDIT.md entry for traceability.
  • Supports blameless, systems-focused analysis and publication-ready documentation for incident learning and process improvement.

Quick Start

Draft a postmortem file at docs/postmortems/YYYY-MM-DD-short-slug.md and append the corresponding AUDIT.md entry.

Frequently Asked Questions about postmortem

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write an incident postmortem for a production outage?

An incident postmortem captures the timeline, root causes, contributing factors, and action items following an outage or data loss. It follows a blameless, systems-focused process to drive lasting fixes and prevent recurrence.

What is a blameless postmortem and how does it help root-cause analysis?

A blameless postmortem is a systems-focused review that identifies root causes and contributing factors without targeting individuals. It drives lasting fixes by focusing on process and system improvements rather than personal blame.

How do I document an incident timeline and corrective actions in Markdown?

You document an incident timeline by drafting a templated Markdown file stored under docs/postmortems/YYYY-MM-DD-slug.md. This file captures the timeline, root causes, and corrective actions, and links to an AUDIT.md entry for traceability.

Can I use a structured postmortem template for data loss incidents?

Yes, you can use a structured postmortem template for data loss incidents. The template captures the incident timeline, root-cause chains, and contributing factors, ensuring publication-ready documentation for significant degradation or data loss events.

What is the best way to log incident reviews for traceability and auditing?

The best way to log incident reviews for traceability is to append an entry to AUDIT.md. This links directly to the postmortem Markdown file, ensuring every incident documentation effort is tracked and auditable.