Incident postmortem assistant
Skill ClarentCinematics/Codex-Skills-for-Enterprise/skills/incident-postmortem-assistant
Create blameless incident postmortems from incident timelines, alert notes, status updates, chat excerpts, repair notes, or reliability summaries and produce impact, root-cause hypotheses, contributing factors, corrective actions, owners, and follow-up questions. Use when Codex needs to turn operational incident evidence into a reviewable postmortem without inventing missing facts.From its SKILL.md
npx -y skills add ClarentCinematics/Codex-Skills-for-Enterprise --skill incident-postmortem-assistantAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
- runs commandsInstructs the agent to run 1 command, including `scripts/check_incident_timeline.py --input <path>`.
SKILL.md
2.5 KB, 426 tokens by cl100k_base, as published. Nobody here has run it
Incident Postmortem Assistant
Workflow
- Identify incident scope, affected systems, customer or business impact, timeline, responders, and available evidence.
- Separate observed facts from hypotheses, assumptions, downstream symptoms, and missing context.
- Build a blameless narrative with impact, detection, mitigation, resolution, and learning points.
- Convert lessons into corrective actions with owners and due dates only when stated.
- Flag unresolved questions, evidence gaps, repeated timestamps, ambiguous ownership, and follow-up needs.
Script-Assisted Workflow
When given a timeline or incident notes file, run scripts/check_incident_timeline.py --input <path> before drafting the postmortem. Use --json when structured evidence is needed. Treat the script output as deterministic evidence about timeline quality, not as the final root cause.
Output Standard
Use this structure by default:
- Incident Summary: scope, status, impact, and confidence.
- Timeline: observed events with timestamps, owners, and actions when stated.
- Impact: affected users, services, duration, and business effect; use
Not statedwhen absent. - Root-Cause Hypotheses: ranked hypotheses with evidence and uncertainty.
- Contributing Factors: process, system, monitoring, release, dependency, or handoff factors.
- Corrective Actions: action, owner, due date, and validation method when stated.
- Open Questions: missing facts needed before publication.
- Caveats: source limitations and non-inferred fields.
Rules
- Keep the postmortem blameless and evidence-grounded.
- Do not invent severity, customer impact, owners, dates, root cause, or corrective action commitments.
- Label hypotheses as hypotheses until supported by source evidence.
- Treat unresolved timeline gaps, repeated timestamps, and missing owners as review risks.
- Escalate legal, customer-notification, or compliance conclusions to human review.
References
Read references/postmortem-rubric.md when preparing a formal postmortem, executive incident recap, or corrective-action review.
What ships with it: 3 files
5.6 KB alongside SKILL.md, 1 of them executable
agents/
- openai.yaml281 B
references/
- postmortem-rubric.md1.1 KB
scripts/
- check_incident_timeline.pyruns4.3 KB