playbooks

home / skills / jeremylongshore / claude-code-plugins-plus-skills / incident-postmortem-template

incident-postmortem-template skill

/skills/17-technical-docs/incident-postmortem-template

This skill provides automated guidance and production-ready templates for incident postmortem documentation to speed technical writing and adherence to best

npx playbooks add skill jeremylongshore/claude-code-plugins-plus-skills --skill incident-postmortem-template

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
2.3 KB
---
name: "incident-postmortem-template"
description: |
  Manage incident postmortem template operations. Auto-activating skill for Technical Documentation.
  Triggers on: incident postmortem template, incident postmortem template
  Part of the Technical Documentation skill category. Use when working with incident postmortem template functionality. Trigger with phrases like "incident postmortem template", "incident template", "incident".
allowed-tools: "Read, Write, Edit, Bash(cmd:*), Grep"
version: 1.0.0
license: MIT
author: "Jeremy Longshore <[email protected]>"
---

# Incident Postmortem Template

## Overview

This skill provides automated assistance for incident postmortem template tasks within the Technical Documentation domain.

## When to Use

This skill activates automatically when you:
- Mention "incident postmortem template" in your request
- Ask about incident postmortem template patterns or best practices
- Need help with technical documentation skills covering api docs, user guides, architecture docs, and documentation automation.

## Instructions

1. Provides step-by-step guidance for incident postmortem template
2. Follows industry best practices and patterns
3. Generates production-ready code and configurations
4. Validates outputs against common standards

## Examples

**Example: Basic Usage**
Request: "Help me with incident postmortem template"
Result: Provides step-by-step guidance and generates appropriate configurations


## Prerequisites

- Relevant development environment configured
- Access to necessary tools and services
- Basic understanding of technical documentation concepts


## Output

- Generated configurations and code
- Best practice recommendations
- Validation results


## Error Handling

| Error | Cause | Solution |
|-------|-------|----------|
| Configuration invalid | Missing required fields | Check documentation for required parameters |
| Tool not found | Dependency not installed | Install required tools per prerequisites |
| Permission denied | Insufficient access | Verify credentials and permissions |


## Resources

- Official documentation for related tools
- Best practices guides
- Community examples and tutorials

## Related Skills

Part of the **Technical Documentation** skill category.
Tags: documentation, markdown, api-docs, readme, technical-writing

Overview

This skill automates creation, validation, and management of incident postmortem templates for technical documentation teams. It provides step-by-step guidance, generates production-ready templates and configurations, and enforces common postmortem standards. Use it to standardize investigations, speed documentation, and improve learning from incidents.

How this skill works

The skill inspects trigger phrases like "incident postmortem template" and activates guidance flows tailored to your incident type and audience. It generates templated sections (summary, timeline, impact, root cause, remediation, follow-up), validates required fields, and outputs ready-to-use Markdown or structured JSON. It can also suggest remediation tasks and review checklists to ensure completeness.

When to use it

  • Preparing a postmortem after a service outage or degraded incident
  • Standardizing postmortem format across teams or projects
  • Onboarding writers or engineers to postmortem best practices
  • Automating generation of postmortem drafts from incident data
  • Validating completeness before publishing a postmortem

Best practices

  • Include concise executive summary and clear impact metrics up front
  • Record an accurate timeline with timestamps and evidence sources
  • State root cause and contributing factors separately and clearly
  • List actionable remediation with owners and deadlines for follow-up
  • Use a consistent template and validation checklist before publishing

Example use cases

  • Generate a first-draft postmortem from an incident ticket or timeline
  • Enforce required fields and checklist validation before sign-off
  • Create a template variant for customer-facing vs internal reports
  • Produce remediation task list and export to tracking tools
  • Train new engineers on effective postmortem structure and content

FAQ

Can the template be exported to different formats?

Yes. Outputs can be generated as Markdown, structured JSON, or configurable plain text suitable for import into trackers or documentation sites.

Does the skill enforce any specific postmortem policy?

It follows widely accepted industry patterns but is configurable so you can enforce your own required fields, SLA metrics, and review workflows.

What happens if required incident data is missing?

The skill highlights missing fields, offers guidance on how to collect the data, and provides placeholders and validation rules to complete the template.