Content
36%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 body is concise and well-sectioned but offers almost no domain-specific guidance: instructions are generic boilerplate that could describe any analysis skill, and the single progressive-disclosure pointer targets a file that does not exist.
Suggestions
Replace the generic bullet instructions with concrete, domain-specific guidance, e.g. named frameworks (Porter's Five Forces, SWOT, positioning maps), the specific inputs to collect, and the output artifacts to produce.
Create the referenced `resources/implementation-playbook.md` (or remove the dangling reference) so the progressive-disclosure pointer resolves to real content.
Add a real sequenced workflow with explicit validation, e.g. gather competitor data -> apply framework -> cross-check positioning claims -> present matrix, rather than abstract directives.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with no padding or over-explanation of concepts Claude already knows, but generic platitudes like "Apply relevant best practices and validate outcomes" do not fully earn their place, keeping it just below the top anchor. | 4 / 5 |
Actionability | The instructions are entirely abstract and generic ("Clarify goals, constraints, and required inputs", "Apply relevant best practices", "Provide actionable steps and verification") with no domain-specific code, commands, frameworks, or examples; the only concrete pointer is to a resources file that does not exist. | 1 / 5 |
Workflow Clarity | A rough four-bullet sequence exists but steps are poorly defined, there are no real validation checkpoints, and "validate outcomes" is mentioned only generically rather than as a concrete feedback loop. | 2 / 5 |
Progressive Disclosure | Section structure is reasonable (Use when / Do not use / Instructions / Resources) and the reference to the playbook is clearly signaled in a dedicated Resources section, but the referenced `resources/implementation-playbook.md` file is missing, so the one-level-deep navigation is broken. | 3 / 5 |
Total | 10 / 20 Passed |