Works with the AI tools you already use

    CClaude CodeCCursorCCodex CLIGGitHub CopilotGGemini CLI+17 more

    Incident Postmortem Writer

    by PubsProToolkit

    1

    Turn timeline fragments, Slack logs, and pager history into a complete blameless postmortem — impact summary, clean timeline, contributing factors instead of a scapegoat, action items with owners and due dates, and lessons that survive the week.

    Free

    0 installsSecurity scanned

    See it in action

    You say

    Write a blameless postmortem from these notes. Checkout was down. From #incident-checkout: 14:02 deploy of config change goes out. 14:05 first 500s, PagerDuty pages on-call. 14:11 someone asks "is this the config PR?" 14:20 rolled back, errors clear by 14:23. Alert only fired after error rate hit 5%. Impact: ~21 min, checkout failing for most users. Owner for follow-ups TBD. Flag anything you're not sure about instead of guessing.

    Your agent does

    Postmortem: Checkout Service Degradation (HTTP 500)

    Severity: SEV-1 Duration: ~21 min (14:02–14:23)

    Impact Summary

    Checkout returned HTTP 500 for most users for roughly 21 minutes following a configuration deploy. Customers could not complete purchases until the change was rolled back and error rates returned to normal at 14:23.

    Timeline

    • 14:02 — Configuration change deployed to production.
    • 14:05 — First 500s observed; PagerDuty pages on-call. (At this point responders did not yet know the deploy was the trigger.)
    • 14:11 — Responders raise the recent config PR as a possible cause.
    • 14:20 — Change rolled back.
    • 14:23 — Error rates return to baseline; incident resolved.

    Contributing Factors

    • The config deploy pipeline had no automated validation to catch the faulty change before it reached production.
    • The 5xx alert threshold (5% error rate) delayed detection, so paging lagged the first user-facing errors.

    What Went Well

    • Once the config PR was suspected, rollback was fast and fully resolved the issue.

    Action Items

    • [ ] Add a config-validation gate to the deploy pipeline. (Owner: TODO — assign) (Due: TODO) — addresses Factor 1
    • [ ] Lower the 5xx alert threshold / add rate-of-change alerting. (Owner: TODO — assign) (Due: TODO) — addresses Factor 2

    Lessons for Others

    • A fast, well-understood rollback path limits blast radius more than any single prevention control.

    TODO: Follow-up owners and due dates were not provided in the source notes — assign before publishing.

    About this skill

    Postmortems are the highest-leverage document an engineering team writes and usually the worst-written: composed at 5pm the day after, half timeline dump and half quiet blame, with action items like "improve monitoring" that no one owns. Incident Postmortem Writer applies the craft. Give it your raw material — timeline notes, incident-channel logs, alert history, who did what — and it produces the finished document: an impact summary a director can read alone, a timestamped timeline that notes what responders knew at each decision, contributing factors that are systemic and plural rather than a single-blame root cause, a what-went-well section, action items where every entry is concrete, owned, dated, and mapped to a factor, and lessons phrased so people outside the incident learn from them. It rewrites the blame your raw material contains while keeping every fact — people appear in the timeline doing things; causes live in the factors — and it flags timeline conflicts and missing facts as TODOs instead of inventing them. The download includes three reference files: the postmortem template, a blameless-language guide with the standard transformations and a two-reader test, and a complete annotated sample postmortem. Written by a professional writer; works with Claude Code, Cursor, Codex CLI, Gemini CLI, and any SKILL.md agent.

    How to install

    Drop the file into your AI Agent. Works with Claude, Cursor, ChatGPT, and 20+ more.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill passes our trust checks below.

    Security scanned

    Passed our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Free forever

    No account required to browse

    Frequently Asked Questions

    Popular in Documentation

    Free