Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a high-quality skill with excellent actionability — the required-inputs checklist, structured sections, worked example, and output flow create a clear, executable workflow. The main weakness is length: at 300+ lines in a single file with no bundle, it consumes significant context window. Some sections (Tone guidelines, meta-commentary on the worked example) could be trimmed without losing clarity.
Suggestions
Trim the 'What this post-mortem does that the management-talk version didn't' commentary after the worked example — the example speaks for itself and Claude can infer the distinctions.
Consider moving the worked example to a separate EXAMPLE.md file referenced from the main skill, reducing the SKILL.md token footprint by ~40%.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is well-written but quite long (~300+ lines). The worked example is valuable but extensive. Some sections like 'Tone' repeat guidance Claude already follows (active voice, short paragraphs). The 'What this post-mortem does' commentary after the example adds meta-explanation that isn't strictly necessary. However, most content earns its place given the complexity of the task. | 2 / 3 |
Actionability | Extremely actionable: provides a concrete checklist of required inputs, a mandatory section structure with clear ordering, a complete worked example showing exactly what the output should look like, specific JIRA API posting instructions, and explicit rules for when to refuse. The worked example alone is a copy-paste-quality template. | 3 / 3 |
Workflow Clarity | The output flow is clearly sequenced (confirm inputs → confirm destination → draft → sign-off → offer handoff) with explicit validation gates: refuse without all four inputs, get sign-off before posting, and a feedback loop rule ('one iteration is normal, three is a smell'). The 'When NOT to use' section adds important boundary conditions. Destructive operations (posting to JIRA) have explicit approval gates. | 3 / 3 |
Progressive Disclosure | The skill is a single monolithic file with no bundle files to offload content to. The worked example (~40 lines) and the detailed section descriptions could potentially be split into separate reference files. However, the content is well-organized with clear headers and the cross-reference to management-talk is well-signaled. For a skill of this length, some splitting would improve navigability. | 2 / 3 |
Total | 10 / 12 Passed |