CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

postmortem-report

How the SRE team writes a postmortem PDF. Use this whenever asked for a postmortem, an incident report, a write-up to share, or a PDF of what happened.

67

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exemplary lean instruction-only skill: concrete paths, tools, and output constraints with well-organized sections and a sensible run-and-fix loop. The only gaps are minor — no executable snippet and no explicit output validation step.

DimensionReasoningScore

Conciseness

The body is ~28 lean lines with zero explanation of concepts Claude already knows: it assumes competence and every instruction carries new, non-derivable information (paths, tool availability, output rules, margins), matching the lean-and-efficient anchor.

5 / 5

Actionability

Guidance is highly concrete for an instruction-only skill — exact paths ('/mnt/session/uploads/app.log', '/workspace/findings/*.json', '/mnt/session/outputs/postmortem.pdf') and a specific API ('matplotlib.backends.backend_pdf.PdfPages') — but there is no runnable snippet and one soft, non-concrete pointer ('Follow any postmortem conventions you find in team memory'), leaving minor gaps versus fully executable guidance.

4 / 5

Workflow Clarity

A clear sequence is present (start from findings, write one script, run it, 'fix it only if it errors', then report the file name) with a minimal error-recovery loop, but there is no explicit checkpoint on the output itself (the skill even says not to inspect the rendered PDF), matching the anchor for clear sequence with minor validation gaps rather than the 5-anchor's explicit validation steps.

4 / 5

Progressive Disclosure

The skill is under 50 lines, needs no external references (none exist in the bundle), and is organized into two well-signaled sections ('What it must contain', 'How to build it'), so per the simple-skill guideline it fully meets the well-organized-sections bar.

5 / 5

Total

18

/

20

Passed

Description

73%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 concise, well-targeted description with strong triggers and a clear niche. Its main weakness is a thin 'what' clause: it names the artifact but not the capabilities involved, leaving it just short of the top anchors.

Suggestions

Expand the 'what' clause to name 2-3 concrete capabilities (e.g., 'Build a postmortem PDF: incident timeline, pages-by-root-cause table, charts computed from the app log, action items') to raise specificity from anchor 3 toward 4-5.

Add common synonyms users might say as triggers, such as 'post-mortem', 'retrospective', 'RCA', or 'incident review', to push trigger term coverage from good to comprehensive.

Keep the existing 'Use this whenever asked for...' trigger clause — it is explicit and concrete — while ensuring any expansion stays in third person and does not add padding.

DimensionReasoningScore

Specificity

The description names a specific domain (SRE postmortems) and one concrete action — "writes a postmortem PDF" — but lists no subordinate capabilities (timelines, charts, action items), matching the anchor for domain plus 1-2 concrete actions rather than the several specific actions required for a 4.

3 / 5

Completeness

Both what ("How the SRE team writes a postmortem PDF") and when ("Use this whenever asked for...") are explicitly present, and the when is concrete; however the what is a single thin clause rather than a concrete capability list, so it sits between the 4 and 5 anchors rather than clearly matching 5's comprehensive what-plus-trigger example.

4 / 5

Trigger Term Quality

"postmortem, an incident report, a write-up to share, or a PDF of what happened" gives good natural keyword coverage, but common variations users might say are missing ("post-mortem", "retrospective", "RCA", "incident review"), matching the anchor for good coverage with a few natural terms missing.

4 / 5

Distinctiveness Conflict Risk

"How the SRE team writes a postmortem PDF" with triggers like "postmortem" and "incident report" carves out a clear niche; the "PDF of what happened" phrasing is qualified so overlap with generic PDF-creation skills is minimal, matching the clear-niche anchor.

5 / 5

Total

16

/

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.

Repository

anthropics/cwc-workshops

Path

ship-your-first-managed-agent/skills/postmortem-report/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.