incident-postmortem
Structured operational protocol for conducting root cause analyses and producing immutable incident reports following safety halts, kill switch activations, or reconciliation breaches.
Install / Use
npx skills add abdulhayykhan/AEGIS --skill incident-postmortemInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of incident-postmortem
incident-postmortem scores 62/100 on our quality scale, 4077th of 4,705 Development & Engineering skills we index.
Its SKILL.md is 2.9 KB long, well organised into 12 sections with 1 code example: a solid amount of guidance for an agent.
It has no GitHub stars yet, so there is no community track record; judge it on its content.
Maintenance, license and trust
- We could not determine when the repository was last updated.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 68/100, with 3 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
incident-postmortem compared with similar skills
All 4 of these similar skills score higher than incident-postmortem; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| incident-postmortem (this skill)by abdulhayykhan | 62 | 0 | — | SKILL.md |
| taste-skillby Leonxlnx | 100 | 120.0k | today | CLAUDE.md |
| hyperframesby heygen-com | 100 | 88.2k | today | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 73.0k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.5k | 1d ago | CLAUDE.md |
Frequently asked questions
- How do I install incident-postmortem?
- Run
npx skills add abdulhayykhan/AEGIS --skill incident-postmortem. The install tabs above show the steps for each supported agent. - Which AI agents does incident-postmortem work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is incident-postmortem safe to use?
- It declares no license and scores 68/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is incident-postmortem still maintained?
- We could not determine when the repository was last updated.
Skill content
View source on GitHubname: incident-postmortem description: Structured operational protocol for conducting root cause analyses and producing immutable incident reports following safety halts, kill switch activations, or reconciliation breaches.
Incident Postmortem & Safety Review Protocol
Prepared by Abdul Hayy Khan
Inspired by mattpocock/skills and The AI Agent Factory (Panaversity) Chapter 25.
This skill defines the mandatory protocol whenever the AEGIS system encounters a failure, halt, or automated demotion.
1. When to Use
- Triggered immediately when:
- Emergency Kill Switch is activated (
kill_switch_active == True). - Stale market data causes a cycle halt (> 2 missed bar intervals).
- Internal database records diverge from broker balances (reconciliation mismatch).
- Autonomy demotion event occurs ("any safety violation drops an autonomy rung").
- Emergency Kill Switch is activated (
2. Four-Part Run Brief
- Outcome: A signed, immutable incident postmortem report stored in
docs/postmortems/YYYY-MM-DD-<slug>.mdand logged in PostgreSQL. - Context: System logs, broker trade logs, database reconciliation diffs, and Risk Gate check traces.
- Format: Standard blameless engineering postmortem template (Summary, Impact, Timeline, Root Cause, Remediation Actions, Owner Sign-Off).
- Constraints:
- Blameless: Focus strictly on code invariants, network latencies, or data integrity boundaries.
- No resume without owner instruction: Recovery requires explicit sign-off from Abdul Hayy Khan.
3. Postmortem Template
# Incident Postmortem: [YYYY-MM-DD Title]
**Owner & Reviewer**: [Abdul Hayy Khan](https://abdulhayykhan.dev)
**Status**: Resolved / Pending Sign-off
**Autonomy Impact**: System Demoted to RECOMMEND_ONLY
## 1. Incident Summary
- What occurred, when it started, and when it was detected.
## 2. Impact & Risk Assessment
- Financial impact (realized loss, slippage, unhedged exposure).
- Gate interventions (which checks failed, whether orders were blocked).
## 3. Timeline of Events (UTC)
- `HH:MM:SS` - Event detected by scheduler/monitor.
- `HH:MM:SS` - Risk Gate or Kill Switch engaged.
- `HH:MM:SS` - Owner alert dispatched.
## 4. Root Cause Analysis (5 Whys)
- Why did the anomaly occur?
- Was it data feed staleness, broker API latency, or mathematical edge case?
## 5. Corrective & Preventative Invariants
- Deterministic code patch or test case added.
- New unit/property test added to `tests/` to prevent recurrence.
## 6. Promotion Sign-off
- Signed by owner: [Abdul Hayy Khan](https://abdulhayykhan.dev)
4. Citations & Attribution
- mattpocock/skills: Structured workflow definitions and failure-handling procedures for production AI agents.
- The AI Agent Factory (Panaversity): Chapter 25 (Production Operations, Monitoring, Demotions, and Postmortems).
Related Skills
taste-skill
120.0kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
hyperframes
88.2kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ai-job-search
73.0kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.5kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
