CtrlK
BlogDocsLog inGet started
Tessl Logo

postmortem-writing

Write effective blameless postmortems with root cause analysis, timelines, and action items. Use when conducting incident reviews, writing postmortem documents, or improving incident response processes.

81

1.26x
Quality

75%

Does it follow best practices?

Impact

92%

1.26x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./tests/ext_conformance/artifacts/agents-wshobson/incident-response/skills/postmortem-writing/SKILL.md

The canonical home for this skill is postmortem-writing in wshobson/agents

SKILL.md
Quality
Evals
Security

Quality

Content

63%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.

The body is highly actionable — templates, agendas, and tables give Claude everything needed to execute — and the workflow is clearly sequenced. Its weaknesses are token efficiency and structure: it re-explains concepts Claude already knows, duplicates the 5 Whys material, and inlines ~300 lines of templates that belong in separate reference files.

Suggestions

Move the three full templates and the facilitation guide into references/ files (e.g., templates/standard-postmortem.md, templates/5-whys.md, facilitation.md) and keep SKILL.md as a lean overview with clearly signaled links.

Cut content Claude already knows — the blame-vs-blameless table, the What Went Well/Wrong/Lucky scaffolding, and the do's/don'ts — down to a few non-obvious pointers.

Remove the duplication of the 5 Whys analysis (it appears fully worked inside Template 1 and again as Template 2) and keep it in one place.

Add explicit validation checkpoints to the workflow (e.g., 'confirm timeline with responders before In Review → Final' and 'verify each action item has a filed ticket').

DimensionReasoningScore

Conciseness

The ~390-line body spends heavily on things Claude already knows — a blame-vs-blameless culture table, 'What Went Well / What Went Wrong / Where We Got Lucky' scaffolding, and obvious do's and don'ts like "Don't name and shame" — and it duplicates the 5 Whys analysis both inside Template 1 and again as Template 2. This matches the level-2 anchor of noticeably verbose with several padded sections, rather than level 3, because the padding is substantial and structural, not occasional.

2 / 5

Actionability

For an instruction-only skill the guidance is fully concrete: three copy-paste-ready templates (standard, 5 Whys with evidence fields, quick postmortem), a minute-by-minute 60-minute meeting agenda, a prioritized action-item table format with owners/due dates/tickets, and an anti-patterns table with better approaches. This matches the level-5 anchor's fully executable, common-cases-covered guidance; level 4's 'minor gaps' do not apply.

5 / 5

Workflow Clarity

The postmortem timeline (Day 0 through Quarterly review) and the sequenced meeting structure with time-boxes give a clear sequence, and the Draft | In Review | Final status plus 'Identify gaps in timeline' act as implicit checkpoints. It falls short of the level-5 anchor because validation steps (e.g., verify the timeline with responders before finalizing, confirm action-item tickets exist) are implied rather than explicit feedback loops.

4 / 5

Progressive Disclosure

The body has clear section headers and is navigable, but the three full templates (Template 1 alone runs ~160 lines) and the facilitation guide are inlined content that clearly belongs in separate reference files — matching the level-3 anchor of 'content that should be separate is inline'. It is above level 2 because the structure is real and nothing is buried, but below level 4 because there is no file split at all despite the bulk.

3 / 5

Total

14

/

20

Passed

Description

87%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.

A strong description that clearly states capabilities and gives an explicit, natural-language 'Use when' clause with distinct trigger phrases. Its only weakness is modest keyword coverage — synonyms like 'retrospective', 'post-mortem', or 'incident report' are absent, and 'improving incident response processes' slightly broadens scope without concrete actions.

Suggestions

Add common synonyms such as 'retrospective', 'post-mortem', or 'incident report' to the trigger clause to catch more natural user phrasings.

Either drop the vague 'improving incident response processes' trigger or make it concrete (e.g., 'running incident retrospectives') to sharpen both specificity and distinctiveness.

DimensionReasoningScore

Specificity

The description names several concrete capabilities — "root cause analysis, timelines, and action items" — paralleling the level-4 anchor's several specific actions. It stops short of the level-5 anchor's comprehensive coverage because "improving incident response processes" broadens scope without naming the concrete actions involved.

4 / 5

Completeness

It explicitly answers both questions: what ("Write effective blameless postmortems with root cause analysis, timelines, and action items") and when ("Use when conducting incident reviews, writing postmortem documents, or improving incident response processes"), with concrete trigger phrases. This matches the level-5 anchor example's structure; the level-4 anchor requires a 'when' that is only partly explicit, which does not apply here.

5 / 5

Trigger Term Quality

"incident reviews", "postmortem documents", and "incident response" are natural phrases users would say, matching the level-4 anchor's good keyword coverage. Common synonyms like "retrospective", "post-mortem", or "incident report" are missing, so it does not reach the level-5 comprehensive-synonym anchor.

4 / 5

Distinctiveness Conflict Risk

"Blameless postmortems" and "incident reviews" carve out a clear niche with distinct triggers and minimal overlap with adjacent skills (e.g., generic writing or code-review skills), matching the level-5 anchor. The level-4 anchor's "minor overlap risk with closely related skills" is not triggered, since postmortem/incident terminology is unambiguous.

5 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 2 missing

Warning

Total

15

/

16

Passed

Repository
Dicklesworthstone/pi_agent_rust
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.