Content
68%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.
The body delivers a concrete, copy-structured post-mortem template with clear inputs, triggers, and routing — actionable and free of padding. Its main weakness is that the multi-step process is never made explicit: the reader must infer the sequence from the output template, and no verification steps guard the scoring work (e.g., confirming pre-committed criteria exist).
Suggestions
Add a short numbered 'Process' section (locate decision record → gather actual outcomes → score success/kill criteria → audit assumptions and dissent → write record → route by status) so the sequence is explicit rather than implied by the output template's section order.
Insert a validation checkpoint before scoring: verify the decision record from /c-level-agents:decide actually contains pre-committed success and kill criteria, and flag or abort if criteria were never recorded (retro-fitted criteria would undermine the skill's stated purpose).
Make the 'Actual outcomes' input executable by specifying where to source it (execution plan status, metrics dashboards, customer-signal logs) rather than leaving it as a generic list.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence: no concepts Claude already knows are explained, and the output template earns its tokens as the core deliverable. The two short 'Why...' sections are borderline — they carry behavioral guidance (don't retroactively justify, score the dissent) but could be trimmed — matching 'efficient; minor instances of over-explanation' rather than the fully lean anchor of 5. | 4 / 5 |
Actionability | Concrete guidance dominates: an explicit save path ('~/.claude/postmortems/YYYY-MM-DD-<slug>.md'), a complete fill-in-the-blank record template covering every section, named inputs, and command-level routing. Gaps keep it below 5: no worked example showing a filled record, and no direction on where the 'Actual outcomes (metrics, events, customer signals)' should be sourced from. | 4 / 5 |
Workflow Clarity | The process sequence (gather record → pull actuals → score criteria → audit assumptions → route by status) is only implicit in the output template's section order — there is no explicit step list. There are also no validation checkpoints (e.g., verifying the decision record actually contains pre-committed criteria before scoring), fitting 'sequence present but checkpoints missing or implicit' at 3 rather than 4. | 3 / 5 |
Progressive Disclosure | A well-sectioned single-file skill: no bundle files exist, the ~55-line template is appropriately inline as the core content, and the Related section clearly signals one-level-deep links to sibling skills and agents. Minor gaps — mixed navigation styles ('${CLAUDE_PLUGIN_ROOT}/...' vs '../../...') and the two rationale sections could live in a reference if the file grows — keep it at 'good structure; minor organization gaps' rather than 5. | 4 / 5 |
Total | 15 / 20 Passed |