CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

write-a-postmortem

Write a blameless incident postmortem under postmortems/ following the Google SRE shape — evidence-based timeline, trigger vs root cause vs symptom, contributing factors, what went well, and owned+dated+verifiable action items. Read when asked to write a postmortem, do an incident review, run a root cause analysis, write up the outage, retro on the outage, or when the user says we had an incident and wants it documented. Do NOT read to frame a proposal (use frame-a-proposal), write a spec (use write-a-spec), record a decision (use record-a-decision), or review a design (use review-a-design) — a postmortem documents an incident that already happened, it does not propose, specify, decide, or critique future work.

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A high-quality instructional skill body: every step is executable with concrete tool calls, worked examples, and explicit hard gates, and the workflow closes with a validation-and-fix feedback loop. The only weaknesses are mild redundancy between the Non-goals recap and the in-step gates, and a single-file layout that inlines some reference-shaped material at ~190 lines.

Suggestions

Trim the Non-goals section to only the items not already stated as HARD GATES or in-step rules (e.g., keep 'don't relitigate a design decision' but drop the restatements of Step 0, Step 1, and Step 6), cutting roughly 10 lines of duplication.

Move the trigger-vs-root-cause-symptom definitions (Step 6) and the blamelessness rules (Step 0) into a references/ file (e.g., references/analysis-models.md), keeping a two-line pointer in SKILL.md so the body stays a lean procedural overview.

Tighten persuasive asides ('Repeat classes are where postmortems earn their keep', 'An action item with no owner is a wish') into single-clause rules to reduce rhetorical tokens without losing the guidance.

DimensionReasoningScore

Conciseness

The body is dense with judgment-relevant craft guidance and never tutorials concepts Claude already knows, but the Non-goals section restates gates already stated verbatim in the steps ("Don't assign blame to people" repeats Step 0, "Don't fabricate the timeline" repeats Step 1's gate, "Don't stop at the first plausible cause" repeats Step 6), and a few rhetorical flourishes ("Repeat classes are where postmortems earn their keep") could be trimmed. This matches the level-4 anchor (efficient, minor instances that could be trimmed) rather than 5, because some redundancy and persuasive prose does not earn its tokens; not 3, because there is no padded explanation or tutorial filler.

4 / 5

Actionability

Every step carries copy-paste-ready commands — `exec("ls -A postmortems/")`, `search({ query: "<subsystem> <failure mode>" })`, `write({ document: { path: "postmortems/YYYY-MM-DD-name.md", template: "postmortem" } })`, `audit({ path: "postmortems/YYYY-MM-DD-name.md" })` — plus a complete worked timeline example, a fully-formed action-item line with link syntax, and a runbook-stub write call. This matches the level-5 anchor (fully executable, specific examples covering the common cases).

5 / 5

Workflow Clarity

Steps 0–11 are clearly sequenced, each with concrete sub-guidance, and the skill includes explicit validation checkpoints with a feedback loop (Step 10: "audit(...) returns clean... — fix every finding") plus HARD GATES that act as go/no-go checkpoints at the riskiest moments (blame-seeking framing, unsourced timeline entries). This matches the level-5 anchor (clear sequence with explicit validation steps, feedback loops for error recovery).

5 / 5

Progressive Disclosure

As a single-file skill with no references/, scripts/, or assets/ bundles, the body is cleanly sectioned (Steps 0–11, Non-goals) with no buried or nested references, and all cross-references (to the /open-knowledge skill, guides/ stubs, sibling skills) are clearly signaled one level deep. This matches the level-4 anchor (good structure, content appropriately placed, minor organization gaps) rather than 5, because at ~190 lines — beyond the under-50-line simple-skill exception — nothing is split out and sections like the trigger-vs-root-cause definitions or blamelessness rules could live in a reference file.

4 / 5

Total

18

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: it states what the skill produces in concrete SRE terms, gives an explicit and comprehensive 'Read when' trigger list of natural user phrasings, and closes with explicit do-not-use boundary guidance that disambiguates it from sibling lifecycle skills. Third-person imperative voice is used throughout with no first- or second-person constructions.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete deliverables — "evidence-based timeline, trigger vs root cause vs symptom, contributing factors, what went well, and owned+dated+verifiable action items" — anchored to a named structure ("the Google SRE shape") with a concrete output location ("under postmortems/"). This matches the level-5 anchor (multiple specific concrete actions, comprehensive coverage); nothing is vague and no capability is over-claimed.

5 / 5

Completeness

It explicitly answers both questions: the first sentence states what the skill does, and "Read when asked to write a postmortem..." explicitly states when to use it with concrete trigger phrases. This matches the level-5 anchor exactly; a 4 would require the 'when' clause to be less explicit, which it is not.

5 / 5

Trigger Term Quality

It covers the natural phrases users would actually say: "write a postmortem", "do an incident review", "run a root cause analysis", "write up the outage", "retro on the outage", and "we had an incident and wants it documented". This matches the level-5 anchor (comprehensive coverage of natural terms including synonyms); it is not below it because no common variation of the request is missing.

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (documenting an incident that already happened) and adds explicit negative boundary guidance — "Do NOT read to frame a proposal (use frame-a-proposal), write a spec (use write-a-spec), record a decision (use record-a-decision), or review a design (use review-a-design)" — which routes overlapping requests to sibling skills. This matches the level-5 anchor (clear niche with distinct triggers, minimal conflict risk).

5 / 5

Total

20

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

relative_links

Relative link issues: 6 missing

Warning

Total

14

/

16

Passed

Repository

inkeep/open-knowledge

Path

packages/server/assets/skills/packs/software-lifecycle/write-a-postmortem/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.