Content
77%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 well-architected instruction-only skill: a sequenced, checkpointed workflow with concrete rating scales, explicit evidence types, and an exemplary one-level-deep reference bundle cited at the point of use. Its one real weakness is repetition — the stage-verification imperative, the thin-input caveat, and the 'common language, not gates' framing each appear multiple times, and the 'How to Run Me' section is chattier than it needs to be.
Suggestions
State the stage-verification rule once (in 'Stage Is a Required, Verified Input') and have the workflow step and the Rules entry reference it in a few words instead of restating it — this alone would trim noticeable repetition.
Tighten 'How to Run Me' to a compact ranked input list plus one short paragraph on thin-input behavior; the conversational framing ('The cleanest way to run me', 'what helps most') carries tokens without adding guidance.
Add one short worked example of a well-formed flag (mismatch → evidence gap → the specific next conversation → go/no-go implication) to close the last actionability gap and anchor the output shape.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with framework-specific knowledge Claude does not already know (stage verification, watermelon, rubber-stamp, tiering) and contains no generic-concept padding, but it could be tightened: the stage-verification message is repeated three times ('Verify it against evidence before rating', workflow step 1 'Establish and verify the stage ... Flag any stage-vs-evidence mismatch', and the Rule 'Verify the stage before trusting it. A stale status label is itself a smell'), the thin-input caveat appears in both 'How to Run Me' and workflow step 0, and 'common language, not gates' is stated three times. The 'How to Run Me' section also carries conversational prose ('The cleanest way to run me...', 'Expect a longer, noisier flag list'). Not a 4 because the repetition and chattiness are more than minor trimming; not a 2 because everything explained is genuinely skill-specific rather than concepts Claude already knows. | 3 / 5 |
Actionability | Concrete, followable guidance throughout: an explicit rating scheme ('Mark each Lean Product Canvas / risk dimension: clear / partial / question mark — and tag each as evidence-backed or opinion'), named verification evidence types ('downstream artifacts, shipped code/output, go-live state, git history, decision records'), per-step reference files, three defined output modes, and a specific next-step requirement ('Each flag carries a specific, small next conversation or derisking activity — not "do more discovery."'). Minor gaps keep it below 5: no worked example of a flag or a sample output shape, and no guidance on what to do when the stage cannot be determined at all. Not a 3 because the guidance is not pseudocode-like — an agent can execute it directly. | 4 / 5 |
Workflow Clarity | The 7-step workflow (0-6) is clearly sequenced with explicit validation checkpoints: 'Verify it against evidence before rating' with named corroboration sources, 'flag the stage mismatch first — it can invalidate the entire clarity-vs-stage comparison', an inference-correction loop ('Separate what you heard from what you inferred ... say so and invite correction'), and a closing Quality Gates checklist covering ingestion, stage verification, evidence tagging, and output language. The destructive/batch validation cap does not apply (read-only analysis). Not a 4 because checkpoints are explicit rather than merely 'most present', and a checklist plus correction loop are both provided. | 5 / 5 |
Progressive Disclosure | Clean overview-plus-references structure: the body keeps the operating model (questions, workflow, rules, gates) while the four detail files — all verified to exist — carry the per-dimension rubric, per-stage expectations, derisking matrix, and facilitation guidance. Each is cited at the exact workflow step where it is needed ('Use references/clarity-dimensions.md', 'Flag mismatches using references/lifecycle-clarity-rubric.md') and catalogued with one-line descriptions in a References section. References are one level deep: the cross-pointers between reference files (e.g. clarity-dimensions.md → lifecycle-clarity-rubric.md) are peer signposts, not buried content chains. Not a 4 because navigation is easy and nothing that belongs in a reference is inlined in the body. | 5 / 5 |
Total | 17 / 20 Passed |