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.

90

1.26x
Quality

Does it follow best practices?

Impact

92%

1.26x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

77%

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 and well-sequenced with strong templates and facilitation guidance, but it is a long, monolithic document padded with sample data and duplicated analysis that could be tightened and split into referenced files for better token efficiency and navigation.

Suggestions

Split the four large templates (Standard, 5 Whys, Quick, Facilitation Guide) into separate reference files and keep SKILL.md as a concise overview with one-level-deep links, improving both conciseness and progressive_disclosure.

Trim the realistic filler data inside the example templates (specific dates, ticket IDs, customer counts, revenue figures) to skeleton placeholders, and remove the standalone 5 Whys template since its analysis already appears in the Standard template's RCA section.

Cut or condense the 'Core Concepts' blameless-culture comparison table, which restates knowledge Claude already has, preserving only the actionable framing needed for the postmortem workflow.

DimensionReasoningScore

Conciseness

The body runs ~390 lines with fully-fleshed sample templates padded with realistic filler data ('12,000 customers', '$45,000', 'v2.3.4', 'ENG-1234', '2024-01-15') and a Core Concepts table explaining blameless culture that Claude largely already knows; the 5 Whys template also duplicates the RCA already embedded in Template 1. It is mostly efficient and actionable rather than purely abstract (so above level 1), but it is clearly not lean and could be tightened significantly (so not level 3).

2 / 3

Actionability

It provides copy-paste-ready markdown templates, a concrete action-items table with owners/due dates/tickets, a timed facilitation agenda, and anti-pattern tables with explicit better approaches. This matches the level-3 anchor of fully concrete, executable guidance rather than the level-2 pseudocode/incomplete anchor.

3 / 3

Workflow Clarity

The process is clearly sequenced (Day 0 → quarterly review timeline, a 60-minute meeting structure with timed segments, and a draft→review→finalize→tickets flow) with checklists (Do's/Don'ts, anti-patterns, action-item tracking). Postmortem writing is not a destructive/batch operation, so the missing-validation cap does not apply; the explicit sequencing and checklists meet the level-3 anchor.

3 / 3

Progressive Disclosure

The skill is a single monolithic SKILL.md with no bundle files and no external references, yet at ~390 lines it contains multiple large, self-contained templates (Standard, 5 Whys, Quick, Facilitation Guide) that would benefit from being split into referenced files. It is well-organized with clear headers (above level 1's monolithic wall), but content that should be separate is inline with no one-level-deep references, matching the level-2 anchor rather than the under-50-line exception for level 3.

2 / 3

Total

10

/

12

Passed

Description

100%

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

The description is concise, written in third person, and clearly answers both what the skill does and when to use it with concrete, natural trigger terms. It is a strong, low-conflict description that mirrors the rubric's good examples.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Write effective blameless postmortems with root cause analysis, timelines, and action items' — naming root cause analysis, timelines, and action items specifically. This matches the level-3 anchor (multiple specific concrete actions) rather than level 2, which only names a domain and some actions without being comprehensive.

3 / 3

Completeness

It answers both 'what' ('Write effective blameless postmortems with root cause analysis, timelines, and action items') and 'when' ('Use when conducting incident reviews...') with an explicit trigger clause. This matches the level-3 example which pairs a capability statement with a 'Use when...' clause, and is above level 2 where the when is missing or implied.

3 / 3

Trigger Term Quality

The 'Use when' clause surfaces natural user phrasing — 'conducting incident reviews, writing postmortem documents, or improving incident response processes' — giving good coverage of terms a user would actually say. It is not at level 2 because it includes multiple common variations (incident reviews, postmortem documents, incident response) rather than a single keyword.

3 / 3

Distinctiveness Conflict Risk

The postmortem / incident-response niche is clearly scoped with distinct triggers unlikely to fire for unrelated skills. It is above level 2 because the triggers (blameless postmortems, incident reviews) are specific and not the generic 'works with document files' style that overlaps broadly.

3 / 3

Total

12

/

12

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.

Validation15 / 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.