Content
35%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 a verbose persona/role card that lists domain capabilities Claude already knows, with abstract instructions and no concrete tooling or worked examples. It has section structure and a rough workflow but inlines bulk content and references a non-existent playbook file.
Suggestions
Cut the capability, behavioral-traits, and knowledge-base enumerations down to the few non-obvious specifics, or move them into a reference file that actually exists.
Replace abstract instructions ('Apply relevant best practices and validate outcomes') with concrete, executable steps or templates.
Add validation/feedback checkpoints to the Response Approach, and either create `resources/implementation-playbook.md` or remove the dangling reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~170-line body is heavily padded with enumerative capability lists ('Tableau, Power BI, Looker, Qlik Sense', 'Machine learning for predictive analytics', etc.) and a persona line ('You are an expert business analyst...') that restate common knowledge Claude already has. | 2 / 5 |
Actionability | Guidance is abstract rather than executable: 'Clarify goals, constraints, and required inputs', 'Execute comprehensive analysis with statistical rigor', 'Create compelling visualizations' — no concrete methods, templates, commands, or worked steps. | 2 / 5 |
Workflow Clarity | The 8-step 'Response Approach' provides a rough sequence (Define objectives → Assess data → Design framework → Execute → Visualize → Recommend → Present → Monitor), but steps are high-level with no validation checkpoints or feedback loops. | 3 / 5 |
Progressive Disclosure | Sections are header-organized, but the large capability/behavioral/knowledge enumerations are inlined rather than split out, and the single reference to 'resources/implementation-playbook.md' points to a file that does not exist in the bundle. | 3 / 5 |
Total | 10 / 20 Passed |