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.
An unusually strong instruction-only skill: an explicitly gated eight-phase workflow with real validation and feedback loops, concrete per-artifact and per-tool guidance, a worked example, and a well-signaled one-level-deep reference bundle. The two deductions are motivational padding that could be trimmed and ten shared/ policy links that resolve to no files in the bundle.
Suggestions
Fix or remove the 10 dead links to shared/base/*.md and shared/workflow-contract.md — either package those files or inline the one-line effect of each policy so nothing referenced is missing.
Trim the rhetorical padding in 'The prime directive' and Core Principle 1 ('This skill exists to prevent that', 'masks symptoms, burns trust') — the rules are already stated imperatively and don't need the motivation.
The inline output-format block (~25 lines) duplicates the 'full output template' said to live in references/workflow.md — keep only the abbreviated skeleton in the body and point to the reference for the full version.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious, actionable guidance and teaches no basic concepts (no 'what a stack trace is' padding), but it carries motivational over-explanation that could be trimmed — e.g. 'This skill exists to prevent that', 'A plausible-looking fix applied to an unverified cause is worse than no fix — it masks symptoms, burns trust', and the prime-directive section restating the evidence-first rule that Core Principles then repeats. That is the anchor-4 profile: efficient with minor instances of over-explanation, not the every-token-earns-its-place anchor 5. | 4 / 5 |
Actionability | Guidance is fully concrete for an instruction-only skill: specific commands and tools per situation ('git bisect', 'EXPLAIN ANALYZE', 'kubectl describe', 'docker logs'), explicit per-artifact first moves ('read the lines before the error', 'find the first frame in our code'), a complete worked example carrying an end-to-end investigation, and a copy-paste output template with a concrete confidence rubric. Specific examples cover the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | The eight phases are explicitly sequenced with phases 1–4 marked mandatory and 5–7 gated by bug domain, and the workflow has explicit validation gates and feedback loops: 'Never propose a code change until the evidence identifies the cause', hypotheses ranked with the cheapest way to confirm or kill each, 'If the top hypothesis is only MEDIUM, the honest deliverable is ... the one check that would confirm it', and Phase 4 requiring why the other hypotheses are ruled out. This matches the anchor-5 checklist-with-explicit-validation-and-recovery pattern; anchor 4's 'minor validation gaps' does not apply. | 5 / 5 |
Progressive Disclosure | Structure is good: a 'Read | When' reference map, on-demand loading instructions ('read the reference file when its phase begins'), and all 8 references/*.md files exist and link only one level deep (sibling cross-references, no nesting chains). The gap: the body's 'Required packaged policies' section links 9 shared/base/*.md files plus shared/workflow-contract.md, none of which exist in the bundle — 10 dead reference paths — which is more than a trivial organization issue and keeps this below anchor 5's 'easy navigation'. | 4 / 5 |
Total | 18 / 20 Passed |