postmortem

Generates blameless postmortems with root-cause analysis for software incidents.

5|2|Updated Dec 11, 2025
One-click install
npx skills add https://github.com/thoreinstein/opencode-config --skill postmortem
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: postmortem
Source: https://github.com/thoreinstein/opencode-config/tree/main/skill/postmortem
Command: npx skills add https://github.com/thoreinstein/opencode-config --skill postmortem

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation of blameless postmortems with root-cause analysis, reducing time-to-insight after incidents and strengthening organizational learning.

Core Features & Use Cases

  • Blameless postmortems: Generate structured postmortem documents focused on learning and prevention.
  • Multi-track RCA: Coordinate external research, codebase exploration, and code analysis to surface root causes.
  • Obsidian integration: Write the final document into an Obsidian vault with a dated filename and a link back to the original incident.
  • 5 Whys synthesis: Produce a concise five-whys analysis to surface contributing factors and durable fixes.
  • Template-driven output: Provide a consistent document structure aligned with organizational standards.

Quick Start

Use this skill to generate a blameless postmortem for incident reference "INCIDENT-XXXX" and publish it to Obsidian at the path Postmortems/YYYY-MM-DD-incident-title.md.

Frequently Asked Questions about postmortem

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

FAQPage Schema
How do I automate blameless postmortem generation for software incidents?

Automating blameless postmortem generation involves coordinating external research, codebase exploration, and code analysis to produce a structured root-cause analysis. This process builds an incident document focused on organizational learning and prevention.

How do I write a five whys root-cause analysis into Obsidian?

Writing a five whys root-cause analysis into Obsidian requires appending the synthesized RCA document using an auto-generated filename like YYYY-MM-DD-incident-title.md. The output includes a wiki-link back to the original incident reference.

What is the best way to conduct root-cause analysis across multiple codebases?

Conducting root-cause analysis across multiple codebases is best handled by guiding parallel research tracks. This approach simultaneously surfaces external research, codebase exploration, and code analysis to identify contributing factors and durable fixes.

Does this incident management approach require a specific Obsidian vault setup?

This incident management approach requires an Obsidian vault configured to accept appended content. It writes the final postmortem document to a specified path within the vault, ensuring structured documentation aligned with organizational standards.

Can I generate a structured postmortem document from an incident reference ID?

Generating a structured postmortem document from an incident reference ID like INCIDENT-XXXX is fully supported. The system uses the reference to coordinate research tracks and publishes the blameless postmortem directly to your Obsidian vault.

When should I not use an automated postmortem template?

Automated postmortem templates should not be used when an incident lacks sufficient codebase context or external research data. Without these inputs, the parallel research tracks cannot effectively synthesize an accurate five whys root-cause analysis.