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 well-structured, token-efficient instruction skill: four clearly sequenced modes with concrete prompts, inputs, scoring formulas, and named output artifacts, plus explicit integration handoffs. The main gaps are missing validation checkpoints in the workflows and a few under-specified steps (competitor comparison method, scoring anchors).
Suggestions
Add a validation checkpoint to Mode 1, e.g., after drafting PRODUCT-BRIEF.md, re-ask any diagnostic question answered vaguely ('metric, not vibes') before issuing the go/no-go recommendation.
Define the scoring anchors for Mode 2's product-market fit signals (what a 2 vs an 8 on 'usage growth trajectory' looks like) so scores are reproducible rather than vibes-based.
Specify the method for Mode 3's competitor comparison (which competitor artifacts to fetch, which onboarding steps to time) and give the output a named artifact like the other modes do.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean throughout: no concept explanations, no library comparisons, and compact numbered question lists ('What's the MVP? (smallest thing that proves the thesis)'). Every line carries guidance, including the framing asides ('Like YC office hours but automated'), so there is nothing over-explained to trim as a 4 would require. | 5 / 5 |
Actionability | Instruction-only guidance is concrete and executable: exact questions with quantification hints, exact inputs ('Read README, CLAUDE.md, package.json, recent commits'), an exact scoring formula ('impact (1-5) × confidence (1-5) ÷ effort (1-5)'), and a defined artifact ('a `PRODUCT-BRIEF.md`'). Not a 5: a few steps are underspecified — Mode 3's 'Compare to competitor onboarding' gives no method, and the 0-10 founder-review signal scoring lacks defined anchors. | 4 / 5 |
Workflow Clarity | Each of the four modes has a numbered, ordered procedure with a defined output, and Mode 1 specifies the follow-on handoff ('the next lane is product-capability'). Not a 5: validation checkpoints are absent — no step to confirm the brief's answers with the user or to re-ask unanswered diagnostic questions; no destructive/batch operations exist, so the score-3 cap does not apply. | 4 / 5 |
Progressive Disclosure | The body is cleanly sectioned (When to Use, four mode subsections, Output, Integration), fully self-contained with no bundle files, and its cross-skill mentions are handoffs rather than dangling references. Not a 5: at roughly 80 body lines it exceeds the under-50-line simple-skill bar, and growing detail such as the founder-review scoring rubric would belong in a one-level-deep reference file. | 4 / 5 |
Total | 17 / 20 Passed |