Content
78%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.
The skill body is well-organized with a clear multi-step workflow, strong progressive disclosure (overview plus three real one-level reference files), and actionable guidance including an output template and verdict scales. Its main weaknesses are minor verbosity in a few restating sentences and the absence of an explicit verification checkpoint in the workflow.
Suggestions
Trim restating sentences like 'Each perspective surfaces insights the others miss' and 'A company can be a great investment but a terrible place to work' to tighten conciseness.
Add an explicit validation checkpoint in Step 1 (e.g., 'Confirm you have at least the company's product and funding stage before proceeding') to strengthen workflow feedback loops.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely efficient and assumes Claude's competence (e.g., it lists core areas as bullets without explaining what CAC or TAM mean), but a few sentences restate the obvious ('Each perspective surfaces insights the others miss') and the verdict-label tables add mild padding that could be trimmed. | 4 / 5 |
Actionability | It gives concrete, executable guidance: a specific data-gathering table, decision rules for which perspective to emphasize, explicit verdict scales, and a full output template. It stops just short of a 5 because most guidance is instructional rather than copy-paste executable (appropriate for an analysis skill, but the rubric rewards concrete commands). | 4 / 5 |
Workflow Clarity | A clear five-step sequence is laid out (gather, choose perspectives, analyze each, synthesize, present) with a decision table and structured output template. It lacks an explicit validation/feedback checkpoint, but the skill is analytical rather than destructive/batch, so the destructive-cap at 3 does not apply; it sits at 4 with minor checkpoint gaps. | 4 / 5 |
Progressive Disclosure | SKILL.md is a concise overview that cleanly defers detail to three one-level-deep reference files, all of which exist and are clearly signaled both inline ('Read references/vc-framework.md') and in a closing reference list with descriptions — matching the top anchor for clear overview with well-signaled references. | 5 / 5 |
Total | 17 / 20 Passed |