CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

postmortem-writing

Comprehensive guide to writing effective, blameless postmortems that drive organizational learning and prevent incident recurrence.

Quality

65%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/postmortem-writing/SKILL.md

The canonical home for this skill is postmortem-writing in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

53%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 skill's core strength is highly actionable, copy-paste-ready templates and facilitation guidance covering the common cases. Its weaknesses are significant token bloat (boilerplate sections, a fully fabricated worked example, duplicated 5 Whys content), an implicit rather than explicit drafting workflow, and a monolithic structure with a dangling reference to a nonexistent `resources/implementation-playbook.md`.

Suggestions

Remove the boilerplate "Do not use this skill when" section (its two bullets are tautologies) and the generic "Instructions" bullets; replace them with an explicit ordered drafting workflow: gather timeline → verify facts with participants → draft from Template 1 → circulate for review → hold meeting → finalize and file tickets.

Fix or remove the dangling reference to `resources/implementation-playbook.md` (the file and directory do not exist), or actually create it and move the three templates into it, keeping only a lean template skeleton and summary in SKILL.md.

De-duplicate the 5 Whys material (present both inside Template 1's root-cause section and again as Template 2) and slim Template 1 from a fabricated worked example to a skeleton with brief bracketed placeholders to cut roughly half its tokens.

DimensionReasoningScore

Conciseness

Several padded sections: the boilerplate "Do not use this skill when — The task is unrelated to postmortem writing / You need a different domain or tool outside this scope" adds zero information; the generic "Instructions" bullets ("Apply relevant best practices and validate outcomes") are filler; Template 1 is a ~160-line fully fabricated worked example ("12,000 customers", "$45,000", "847 support tickets") where a lean skeleton template would preserve all the instructional value; and the 5 Whys content is duplicated between Template 1 and Template 2. This matches anchor 2 ("noticeably verbose; several unnecessary explanations or padded sections"); not 1 because there is no explaining of concepts Claude already knows, and not 3 because the padding is extensive rather than incidental.

2 / 5

Actionability

The body is dominated by concrete, copy-paste-ready artifacts: three complete markdown templates (standard postmortem, 5 Whys analysis, quick postmortem for minor incidents), a time-boxed 60-minute facilitation agenda with per-phase actions, a specific postmortem trigger list ("SEV1 or SEV2 incidents", "Customer-facing outages > 15 minutes"), and an action-item table schema with Priority/Owner/Due Date/Ticket columns. Specific examples cover the common cases, matching anchor 5 for an instruction-only skill.

5 / 5

Workflow Clarity

A rough sequence exists (the Day 0 → Day 7 → Quarterly postmortem timeline and the 5-phase meeting structure), but the core drafting workflow is never laid out as ordered steps with checkpoints — how to gather the timeline, verify facts with participants, circulate a draft, and finalize is left implicit. Validation checkpoints are only incidental ("Confirm action item owners" in the meeting closing). This matches anchor 3 ("steps listed but validation gaps; sequence present but checkpoints missing or implicit"); not 4 because the document-production workflow itself has no explicit ordered procedure, not 2 because the timeline and facilitation agenda do provide a coherent rough sequence.

3 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/ directories), yet the body points to `resources/implementation-playbook.md` in the Instructions — a dangling reference to a nonexistent file. Meanwhile ~250 lines of template content that clearly belongs in separate reference files (Template 1 alone is ~160 lines) are inlined monolithically. This matches anchor 2 ("content that clearly belongs in separate files is inlined; or references are buried"); not 1 because section headers do provide navigable structure and references are not nested, and not 3 because the single reference present is broken and the bulk content is inline rather than merely "could be" separate.

2 / 5

Total

12

/

20

Passed

Description

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

The description is clear, appropriately concise, and names a distinctive niche, but it has no explicit 'when to use' trigger guidance, which caps completeness and weakens its ability to fire reliably. Adding a 'Use when...' clause with natural trigger phrases (post-incident review, retrospective, root cause analysis) would lift it substantially.

Suggestions

Append an explicit trigger clause, e.g. "Use when the user mentions postmortems, incident reviews, retrospectives, or post-incident analysis, or asks to facilitate a blameless postmortem."

Replace the goal-oriented tail ("drive organizational learning and prevent incident recurrence") with more concrete actions such as "run 5 Whys root-cause analysis and facilitate blameless postmortem meetings" to sharpen specificity.

DimensionReasoningScore

Specificity

Phrases like "writing effective, blameless postmortems" name a concrete action in a specific domain, but the other two clauses — "drive organizational learning" and "prevent incident recurrence" — are goals/outcomes rather than distinct concrete actions (compare the anchor-4 example's parallel concrete verbs: extracts, fills, converts). It matches anchor 3 (domain + 1-2 concrete actions, not comprehensive); it is not score 2 because it does go beyond the bare domain label, and not score 4 because it does not list several distinct executable actions.

3 / 5

Completeness

The "what" is clear ("writing effective, blameless postmortems"), but there is no "Use when..." clause or equivalent explicit trigger guidance anywhere in the description — "when" is entirely absent, not even weakly implied by any trigger phrase. Per the rubric guideline, a missing 'Use when' clause caps completeness at 3; this is exactly the anchor-3 example pattern (clear what, missing when).

3 / 5

Trigger Term Quality

Includes natural terms a user would actually say: "postmortems", "blameless postmortems", "incident recurrence". Missing common variations/synonyms like "retrospective", "post-incident review", "root cause analysis" — anchor 4 ("good keyword coverage; a few natural terms missing") fits; not 5 because synonym coverage is incomplete, not 3 because the core natural vocabulary is present and well-chosen.

4 / 5

Distinctiveness Conflict Risk

"Blameless postmortems" carves a clear niche with distinctive terminology unlikely to collide with unrelated skills. It stops short of anchor 5 because "drive organizational learning" is broad language that could overlap with general learning-culture or incident-management skills, and without a 'use when' clause the distinctiveness rests only on the what-clause. Anchor 4 ("mostly distinct; minor overlap risk with closely related skills") is the best fit.

4 / 5

Total

14

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/postmortem-writing/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.