Content
88%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A high-quality instructional skill body: every step is executable with concrete tool calls, worked examples, and explicit hard gates, and the workflow closes with a validation-and-fix feedback loop. The only weaknesses are mild redundancy between the Non-goals recap and the in-step gates, and a single-file layout that inlines some reference-shaped material at ~190 lines.
Suggestions
Trim the Non-goals section to only the items not already stated as HARD GATES or in-step rules (e.g., keep 'don't relitigate a design decision' but drop the restatements of Step 0, Step 1, and Step 6), cutting roughly 10 lines of duplication.
Move the trigger-vs-root-cause-symptom definitions (Step 6) and the blamelessness rules (Step 0) into a references/ file (e.g., references/analysis-models.md), keeping a two-line pointer in SKILL.md so the body stays a lean procedural overview.
Tighten persuasive asides ('Repeat classes are where postmortems earn their keep', 'An action item with no owner is a wish') into single-clause rules to reduce rhetorical tokens without losing the guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with judgment-relevant craft guidance and never tutorials concepts Claude already knows, but the Non-goals section restates gates already stated verbatim in the steps ("Don't assign blame to people" repeats Step 0, "Don't fabricate the timeline" repeats Step 1's gate, "Don't stop at the first plausible cause" repeats Step 6), and a few rhetorical flourishes ("Repeat classes are where postmortems earn their keep") could be trimmed. This matches the level-4 anchor (efficient, minor instances that could be trimmed) rather than 5, because some redundancy and persuasive prose does not earn its tokens; not 3, because there is no padded explanation or tutorial filler. | 4 / 5 |
Actionability | Every step carries copy-paste-ready commands — `exec("ls -A postmortems/")`, `search({ query: "<subsystem> <failure mode>" })`, `write({ document: { path: "postmortems/YYYY-MM-DD-name.md", template: "postmortem" } })`, `audit({ path: "postmortems/YYYY-MM-DD-name.md" })` — plus a complete worked timeline example, a fully-formed action-item line with link syntax, and a runbook-stub write call. This matches the level-5 anchor (fully executable, specific examples covering the common cases). | 5 / 5 |
Workflow Clarity | Steps 0–11 are clearly sequenced, each with concrete sub-guidance, and the skill includes explicit validation checkpoints with a feedback loop (Step 10: "audit(...) returns clean... — fix every finding") plus HARD GATES that act as go/no-go checkpoints at the riskiest moments (blame-seeking framing, unsourced timeline entries). This matches the level-5 anchor (clear sequence with explicit validation steps, feedback loops for error recovery). | 5 / 5 |
Progressive Disclosure | As a single-file skill with no references/, scripts/, or assets/ bundles, the body is cleanly sectioned (Steps 0–11, Non-goals) with no buried or nested references, and all cross-references (to the /open-knowledge skill, guides/ stubs, sibling skills) are clearly signaled one level deep. This matches the level-4 anchor (good structure, content appropriately placed, minor organization gaps) rather than 5, because at ~190 lines — beyond the under-50-line simple-skill exception — nothing is split out and sections like the trigger-vs-root-cause definitions or blamelessness rules could live in a reference file. | 4 / 5 |
Total | 18 / 20 Passed |