Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, highly actionable advisory skill with clean progressive disclosure and a clear design/audit framework. Its main weakness is redundancy: the keystone framing and outcomes-vs-outputs point are repeated across several sections and the closing.
Suggestions
Tighten redundancy: the sandbagged/aspirational/stretch framing appears in the intro, its dedicated section, the failure modes, and the closing — consolidate so each point is made once and referenced.
Trim or remove the Closing section, which restates the intro and failure modes without adding new guidance.
Consider moving the 'OKRs vs roadmap items vs metrics' conceptual distinctions into a reference file since the body already scopes the skill against adjacent skills in 'What this skill is for'.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is information-dense and opinionated, but the sandbagged/aspirational/stretch framing and the outcomes-vs-outputs point recur across the intro, dedicated section, failure modes, and closing, and the closing largely restates earlier material. | 2 / 3 |
Actionability | Concrete, specific guidance throughout: numeric targets (32%→45%, 0.0–1.0 scale, 60–70% stretch, 2–4 objectives, 3–5 KRs), worked examples, and a four-quarter litmus test for diagnosing practice decay. | 3 / 3 |
Workflow Clarity | The 12-consideration framework sequences the design/audit process, and the review cadence (weekly → mid-quarter → end-of-quarter → retro) is laid out as a clear ordered rhythm with time budgets. | 3 / 3 |
Progressive Disclosure | SKILL.md is an overview with each section signaling 'Detail in references/…' one level deep, a consolidated Reference files list with descriptions, and all nine referenced files exist in ./references/. | 3 / 3 |
Total | 11 / 12 Passed |