Content
82%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 strong, highly actionable skill body: concrete MCP tool calls with documented defaults, exact error-string matching, a response template, and a clear preferred-to-fallback flow. Weaknesses are mild — some generic coaching in Performance Notes, implicit rather than explicit conditions for the fallback steps, and a long single file that inlines reference-style material.
Suggestions
Remove or drastically trim the 'Performance Notes' section — 'take your time', 'quality matters more than speed' is generic coaching that assumes Claude would otherwise be hasty, and it adds tokens without actionable content.
Make the fallback flow explicit: state when to skip harness_diagnose and use harness_list/harness_get directly (e.g., 'if diagnose returns no execution or you need to browse before choosing one, run Step 3').
Move the Analysis Framework error catalog and Troubleshooting sections into a references/ file (e.g., references/error-patterns.md) and link to it, keeping SKILL.md as a leaner overview of the diagnostic workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and mostly earns its tokens — tool-call blocks, a parameter table, and a terse error catalog — but 'Performance Notes' ('Take your time analyzing logs thoroughly', 'Quality of diagnosis is more important than speed') is generic coaching Claude doesn't need, and Steps 4–6 restate parameters already covered by the diagnose table. This fits the score-4 anchor ('efficient; minor instances of over-explanation that could be trimmed') rather than the 5 anchor where every token earns its place. | 4 / 5 |
Actionability | Every step is a concrete, copy-paste-ready MCP call with named parameters, the parameter table documents defaults ('log_snippet_lines: 120, max_failed_steps: 5'), the analysis framework matches exact error strings ('No delegate available', 'ImagePullBackOff'), and a response template is provided. This is fully executable guidance covering the common cases — the score-5 anchor, not the 4 anchor's 'minor gaps'. | 5 / 5 |
Workflow Clarity | The sequence is clear with a preferred path (Step 1/1b), a health overview, and labeled fallbacks, plus a Troubleshooting section covering recovery when logs or executions can't be found. It falls short of the score-5 anchor because there are no explicit validation checkpoints or decision rules for when to switch from harness_diagnose to the fallback steps (Steps 3–6) — conditions are only weakly implied by '(if needed)'. | 4 / 5 |
Progressive Disclosure | No bundle files exist (no references/, scripts/, or assets/), and the single ~190-line body is well-sectioned with headers and a table, fitting the score-4 anchor ('good structure; most content is appropriately placed'). It is not a 5 because the error-pattern catalog and troubleshooting content are inlined in one long file where a references file would keep SKILL.md a leaner overview; it is above the 3 anchor since structure and navigation are genuinely good. | 4 / 5 |
Total | 17 / 20 Passed |