CtrlK
BlogDocsLog inGet started
Tessl Logo

testland/post-mortem-author

Build-an-X workflow that produces a blameless post-mortem from an incident - captures the timeline (chronological event sequence with sources), root cause analysis (what + why, not who), impact (users / revenue / SLO debt), action items (with owners + due dates + measurable success criteria), and "what went well" (intentional). Per Google SRE: "Blameless postmortems are a tenet of SRE culture." Use after every user-visible incident, not just severe ones.

72

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Overview
Quality
Evals
Security
Files

Quality

Content

85%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 highly actionable, well-structured instruction skill: concrete skeletons, worked example, blameless rewrites, and explicit closure criteria, with a clean one-level bundle split. The one weakness is conciseness — the Overview's stacked SRE quotes re-teach blameless culture that Claude already knows and that the body itself restates twice more.

Suggestions

Collapse the Overview's four SRE block quotes into one framing paragraph plus a single citation — the blameless principle is restated in Step 2 and the Anti-patterns table, so the Overview could lose ~15 lines.

Trim the 'When to use' section's quoted trigger list to the five trigger terms themselves rather than a full quote, since the description already carries the 'use after every user-visible incident' guidance.

In Step 2, drop the repeated 'Postmortems are not punishment' quote (already quoted in the Overview) and keep only the three before/after review rules, which carry the instruction.

DimensionReasoningScore

Conciseness

The Steps, worked example, anti-patterns, and limitations are dense and earn their tokens, but the Overview re-explains blameless postmortem culture — a concept Claude already knows — through four separate SRE quotes ('A postmortem is a written record...', 'Blameless postmortems are a tenet of SRE culture', 'Writing a postmortem is not punishment...', plus 'The blameless framing is load-bearing...'), with the same principle restated again in Step 2 and the Anti-patterns table. Not 4: the redundancy is more than minor trimming — the Overview alone could lose ~15 lines. Not 2: apart from the quote pileup there is no padding or over-explanation.

3 / 5

Actionability

Fully concrete instruction-level guidance: a 9-section skeleton with per-section specs, before/after blameless rewrites ('"Bob deployed without testing" → "The pre-deploy testing didn't cover the null-metadata case"'), four required action-item fields, a storage layout with filename convention, and a completely filled worked example covering the common case. Not 4: the worked example is the copy-paste analog for an instruction-only skill and covers the common path end to end.

5 / 5

Workflow Clarity

Steps 1–5 are clearly sequenced (author → blameless review → action item discipline → approval/closure → storage) with explicit validation checkpoints (reviewer sign-off, action items in tracker, 'closed only when all action items ship') and feedback loops (Step 2's reject-and-rewrite patterns for blame language). Not 4: checkpoints are explicit rather than 'most present' — no significant validation gaps.

5 / 5

Progressive Disclosure

Structure is appropriate: SKILL.md is the overview with a compact inline section list, while the full per-incident template lives in the clearly signaled, one-level-deep references/post-mortem-document-template.md (verified to exist and match what the body claims). Anti-patterns, worked example, and limitations — which belong inline — are inline. Not 4: navigation is clean with no buried references and nothing that should be external is inlined.

5 / 5

Total

18

/

20

Passed

Description

92%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: it names the deliverable, enumerates the five post-mortem sections with their defining details, and gives an explicit 'use when' trigger clause. The only gap is modest synonym coverage for trigger terms.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions with comprehensive coverage: 'captures the timeline (chronological event sequence with sources), root cause analysis (what + why, not who), impact (users / revenue / SLO debt), action items (with owners + due dates + measurable success criteria), and "what went well"' — each deliverable is named with its defining detail. Not 4: coverage is comprehensive with no material gaps; it exceeds the 'minor gaps' of the 4 anchor.

5 / 5

Completeness

Explicitly answers both questions: what — 'produces a blameless post-mortem from an incident' with the five content areas enumerated; when — 'Use after every user-visible incident, not just severe ones', a concrete trigger clause. Not 4: the 'when' is explicit and specific rather than 'could be more explicit'.

5 / 5

Trigger Term Quality

Good natural keyword coverage — 'post-mortem', 'blameless', 'incident', 'root cause', 'impact', 'action items', 'user-visible incident' — terms a user would naturally say. Not 5: misses common synonyms like the one-word 'postmortem', 'retrospective'/'retro', and 'incident review'/'SEV'. Not 3: coverage goes well beyond 'some relevant keywords', including the canonical phrasings.

4 / 5

Distinctiveness Conflict Risk

Clear niche — blameless incident post-mortem authoring — with distinct triggers ('after every user-visible incident'). Minimal conflict risk; only slight adjacency to generic retrospective/write-up skills. Not 4: the trigger set and deliverables are specific enough that mis-triggering is unlikely.

5 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Reviewed

Table of Contents