post-mortem

Document root causes and corrective actions for resolved incidents.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/RonanCodes/ronan-skills --skill post-mortem-ronancodes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: post-mortem
Source: https://github.com/RonanCodes/ronan-skills/tree/main/skills/post-mortem
Command: npx skills add https://github.com/RonanCodes/ronan-skills --skill post-mortem-ronancodes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Document how to effectively capture and share learnings from bugs or incidents to prevent recurrence.

Core Features & Use Cases

  • Structured post-mortems capturing symptom, root cause, actions taken, and lessons learned.
  • Template-driven guidance to ensure consistent documentation across teams and incidents.
  • Use Case: after a production incident, generate a post-mortem to log findings and drive improvements.

Quick Start

Describe the incident, capture root cause, actions taken, and lessons learned, and save as a timestamped markdown file.

Frequently Asked Questions about post-mortem

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

FAQPage Schema
What is a post-mortem in software engineering and when do I need to write one?

A post-mortem is a structured incident report documenting root causes and corrective actions after a resolved bug or outage. You need to write one during post-incident reviews to distill lessons learned and prevent recurrence across engineering teams.

How do I write a post-mortem report after a production incident?

To write a post-mortem report, describe the incident symptom, capture the root cause, list actions taken, and outline lessons learned. Save the completed report as a timestamped markdown file to ensure consistent documentation across teams.

Does a post-mortem template need a root-cause statement?

Yes, a post-mortem template requires a clear root-cause statement. Template-driven guidance ensures you capture the symptom, root cause, actions taken, and lessons learned sections consistently for every incident.

What is the best way to document root cause and lessons learned for bug analysis?

The best way to document root cause and lessons learned for bug analysis is using a structured post-mortem template. This ensures you capture the symptom, root cause, actions taken, and lessons learned to drive improvements and knowledge-sharing.

Can I use post-mortem documentation for sharing incident knowledge across teams?

Yes, you can use post-mortem documentation for knowledge-sharing across engineering teams. By capturing root causes and lessons learned in a structured template, teams can review incident reports and drive improvements to prevent future outages.

What limitations exist when using a template-driven post-mortem for incident reporting?

Template-driven post-mortems require a clear root-cause statement and concise lessons-learned section to be effective. Without a structured template, capturing symptoms and corrective actions consistently across different incidents and teams becomes difficult.