Content
92%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-orchestrated, instruction-style skill body: lean multi-step workflow with explicit failure-mode handling (ask for a URL when public data is thin), concrete tables and verdict scales instead of vague direction, and clean progressive disclosure into three real, one-level-deep reference files. The only flaw is minor duplication — verdict scales and the reference index each appear twice — which keeps conciseness at 4 rather than 5.
Suggestions
Remove the restatement of the three verdict scales in Step 5 (they are already defined per-lens in Step 3); a pointer such as 'ends with its verdict on the scale defined in Step 3' would save ~3 lines.
Drop the closing 'Reference Files' section (or the per-lens 'Read references/...' lines in Step 3) — the same three files and their purposes are described twice; a single index is enough.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes Claude's competence — no basic concept explanations (it says 'TAM/SAM/SOM' and 'burn multiple' without defining them), and the data-gathering and perspective-selection tables are dense and purposeful. It falls at anchor 4 ('efficient; minor instances... that could be trimmed') rather than 5 because of small duplications: the verdict scales are defined in Step 3 and then fully restated in Step 5, and the three reference files are listed in Step 3 and again in the closing Reference Files section. It is above anchor 3 because these are genuinely minor — no padded sections or unnecessary explanations. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is fully executable: a concrete table of exactly what data to gather, a table mapping the user's situation to which perspective to emphasize, per-lens core-area checklists, defined verdict scales (e.g., 'Strong Pass / Lean Pass / Lean Invest / Strong Invest'), and a precise report template ('titled "[Company Name] — Startup Analysis"' with named sections). Per the scoring note, absence of code is not penalized since the guidance is specific and actionable; anchor 5's 'specific examples cover the common cases' is met, including edge-case handling for insufficient public data. | 5 / 5 |
Workflow Clarity | A clearly sequenced five-step workflow (Gather Information → Determine Perspectives → Analyze Each → Synthesize → Present) with explicit checkpoints: the Step 1 branch 'If web search does not return enough information to produce a meaningful analysis... ask the user to provide the company's website URL before proceeding' is a genuine feedback loop for the primary failure mode, and Step 5's 'Don't fabricate metrics; make informed inferences and state your confidence level' plus 'Scale each section to the evidence' act as quality gates. This matches anchor 5's 'clear sequence with explicit validation steps; feedback loops'; no destructive/batch-operation cap applies. | 5 / 5 |
Progressive Disclosure | Scored against the actual bundle: all three referenced paths (`references/vc-framework.md`, `references/job-applicant-framework.md`, `references/ceo-framework.md`) exist as real files, each is one level deep, clearly signaled in its Step 3 subsection ('Read `references/vc-framework.md` for the full evaluation framework'), and re-indexed with one-line descriptions in a closing Reference Files section. SKILL.md stays a concise overview while the detailed criteria/benchmarks live in the references — anchor 5's 'clear overview with well-signaled one-level-deep references; content appropriately split'. | 5 / 5 |
Total | 19 / 20 Passed |