Content
65%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 lean, high-signal advisory body with concrete thresholds, named frameworks, and a strong verification loop, but it stops short of sequencing its advisory workflows end-to-end, and its progressive-disclosure architecture is broken in practice because every referenced bundle file is missing. Tightening the script usage examples and shipping the referenced files would raise both dimensions.
Suggestions
Ship the referenced bundle files (references/product_strategy.md, references/product_org_design.md, references/pmf_playbook.md, scripts/pmf_scorer.py, scripts/portfolio_analyzer.py) or remove/inline their content — currently the Resources table points users to files that do not exist in the bundle.
Add a short sequenced workflow for the main request types (e.g., for 'Do we have PMF?': 1) load references/pmf_playbook.md, 2) gather retention/Sean Ellis data, 3) run scripts/pmf_scorer.py, 4) produce scorecard through the quality loop) so the path from request to validated artifact is explicit.
Specify inputs for the two scripts (expected data format, file arguments, example invocation) and drop the 'Keywords' section, which duplicates trigger terms already in the description.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and imperative throughout — tables for responsibilities, metrics, postures, and red flags with no concept tutorials and no padding; it assumes Claude knows frameworks like BCG and team topologies by name only. Not 5 because of minor trimmable material: the 'Keywords' section duplicates trigger terms already in the frontmatter description, and the Communication section restates an external protocol ('see ../agent-protocol/SKILL.md') in detail. Not 3 because there is no over-explanation — every section delivers operational content (thresholds, frequencies, question sets). | 4 / 5 |
Actionability | Concrete and specific throughout: runnable commands ('python scripts/pmf_scorer.py', 'python scripts/portfolio_analyzer.py'), hard thresholds ('D30 retention is below 20% (consumer) or 40% (B2B)'), named frameworks (RICE/ICE, Sean Ellis, team topologies), and a request→artifact table mapping deliverables. Not 5 because the script invocations specify no inputs (what data file or format the scorer/analyzer takes), so a user cannot actually run them copy-paste from this file alone. Not 3 because the guidance for an instruction-only skill is concrete and executable in nearly all sections. | 4 / 5 |
Workflow Clarity | The content supplies raw material (diagnostic question sets, red flags, output artifacts) and an explicit output-verification loop ('Self-verify: source attribution, assumption audit, confidence scoring', 'Peer-verify', 'Critic pre-screen'), but the core advisory workflows are never sequenced — there is no step-by-step path from a request like 'Do we have PMF?' through gathering data, running diagnostics, to producing the artifact. Not 4 because a clear sequence with most checkpoints present would connect request → analysis → validated output; here the sequence and its checkpoints are implicit, and key verification detail is delegated to a file outside this bundle ('../agent-protocol/SKILL.md'). Not 2 because a rough structure does exist (Quick Start → responsibilities → diagnostics → artifacts) and validation guidance is explicitly stated in the Communication section. | 3 / 5 |
Progressive Disclosure | In-file organization is good: a Resources table with per-file 'when to load' guidance and clearly signaled one-level-deep references. However, scoring against the actual bundle structure, none of the referenced files exist — references/product_strategy.md, references/product_org_design.md, references/pmf_playbook.md, scripts/pmf_scorer.py, and scripts/portfolio_analyzer.py are all absent from the bundle, as are '../agent-protocol/SKILL.md' and 'company-context.md'. Not 4/5 because navigation as written leads to missing files, and detailed content that the missing references presumably cover (dashboard tables, north star examples, red flags) remains stranded inline in SKILL.md. Not 2 because the in-body structure itself is well organized and references are clearly, prominently signaled rather than buried. | 3 / 5 |
Total | 14 / 20 Passed |