Skip to content
Writing

Postmortem Writing

Reconstruct an incident timeline and turn contributing conditions into owned follow-up actions.

Install with Skills CLI
npx skills add wshobson/agents@postmortem-writing

What it does

An incident report can jump from an alert straight to a fix and leave the cause uncertain. Postmortem Writing helps a team connect its observations, decisions and recovery steps in a blameless account.

What changes after install

  • Separate impact, detection and recovery in a timeline.
  • Trace contributing conditions alongside the immediate trigger.
  • Attach owners and follow-up actions to the findings.

Install

Run this command with Node.js 22.20 or later and select your agent in the Skills CLI.

Install with Skills CLI
npx skills add wshobson/agents@postmortem-writing

Before using Postmortem Writing

  • Timestamped incident notes, impact evidence and participants who can review the reconstruction.

Read the reviewed setup instructions for the selected workflow.

When to use it

  • Reconcile the chronology of an outage.
  • Assign and track concrete prevention work after recovery.

When not to use it

  • Directing a live response while service impact is still changing.

A worked example

For a stalled job queue, supply alert times, deployment notes and the time backlog processing resumed. Ask for a timeline that distinguishes the first delayed job from the first alert. Have the operator confirm the intervention and the analyst confirm the impact interval.

Troubleshooting

  • Normalize mixed time zones before ordering events.
  • Mark missing evidence as unknown.
  • Replace an action like ‘be more careful’ with a change that has an owner and a way to tell whether it worked.

How it chooses an approach

Use a short review for a bounded incident. When several safeguards failed, follow the evidence through each layer and record open questions for the review meeting.

When to use another skill

What to check after it runs

Check that the timeline agrees with the logs, the impact estimate names its source and the team can find each assigned action after the meeting.

More in Writing

Related skills in other categories

FAQ

Who should review the chronology?
Invite the people who observed or acted on the incident to check their portions against the available evidence.
What if the root cause is still unclear?
Document confirmed contributing conditions, identify the missing evidence and assign the investigation to an owner.