wshobson avatar

Postmortem Writing

Does the structured work of writing blameless postmortems after incidents. Walks you through building proper timelines, running 5-whys root cause analysis, and turning findings into trackable action items. Includes templates for standard postmortem documents and facilitating the actual postmortem meetings. The blameless culture guidance is solid, focusing on system improvements rather than individual blame. Most helpful when you're dealing with SEV1/SEV2 incidents or trying to establish consistent postmortem practices across your team. Beats starting from scratch every time something breaks.

skills.sh installs
11.2K
GitHub stars
42.4K
last updated
Aug 21, 2026

Install

$ npx -y skills add wshobson/agents --skill postmortem-writing --agent claude-code

Installs into .claude/skills of the current project.

Files

Postmortem Writing

Comprehensive guide to writing effective, blameless postmortems that drive organizational learning and prevent incident recurrence.

When to Use This Skill

  • Conducting post-incident reviews
  • Writing postmortem documents
  • Facilitating blameless postmortem meetings
  • Identifying root causes and contributing factors
  • Creating actionable follow-up items
  • Building organizational learning culture

Core Concepts

1. Blameless Culture

Blame-FocusedBlameless
"Who caused this?""What conditions allowed this?"
"Someone made a mistake""The system allowed this mistake"
Punish individualsImprove systems
Hide informationShare learnings
Fear of speaking upPsychological safety

2. Postmortem Triggers

  • SEV1 or SEV2 incidents
  • Customer-facing outages > 15 minutes
  • Data loss or security incidents
  • Near-misses that could have been severe
  • Novel failure modes
  • Incidents requiring unusual intervention

Quick Start

Sponsors

Details

Repository
github.com/wshobson/agents
Categories
DevOps & CI/CD, Documentation

More from wshobson/agents

All 174
1shopify avatarshopify-use-shopify-clishopify/shopify-ai-toolkitChoose when the user needs **Shopify CLI** to run or fix something now: validate app or extension config on disk (`shopify.app.toml`, `shopify.app.<name>.toml`,11.2Kskills.sh installs
2getcargohq avatarcargo-contextgetcargohq/cargo-skillsInspect and edit the workspace's git-backed context repository (the GTM knowledge base of markdown/MDX files) and its runtime sandbox using the Cargo CLI. Use w11.1Kskills.sh installs
3getcargohq avatarcargogetcargohq/cargo-skillsRouter and overview for the Cargo CLI agent skills. Explains the fifteen skills (this router + one onboarding skill cargo-quickstart + one outcome skill cargo-g11.1Kskills.sh installs
4getcargohq avatarcargo-contentgetcargohq/cargo-skillsManage workspace knowledge files and libraries in the Cargo content domain — upload, list, rename, move, and remove files (PDFs, CSVs, text), and create or sync11Kskills.sh installs
5shopify avatarshopify-polaris-app-homeshopify/shopify-ai-toolkitBuild your app's primary user interface embedded in the Shopify admin. If the prompt just mentions `Polaris` and you can't tell based off of the context what AP11Kskills.sh installs
6apify avatarapify-actor-developmentapify/agent-skillsDevelop, debug, and deploy Apify Actors - serverless cloud programs for web scraping, automation, and data processing. Use when creating new Actors, modifying e10.9Kskills.sh installs