Content
53%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 commendably concise and well-structured, but its instructions are abstract rather than actionable and it leans on a referenced file that does not exist in the bundle. Adding concrete examples and creating the missing playbook file would substantially improve it.
Suggestions
Add at least one concrete, executable example (e.g., a minimal Python snippet or a specific command) for the core backtest workflow rather than only high-level directives.
Create the referenced resources/implementation-playbook.md so the progressive-disclosure pointer resolves, or remove the references until the file exists.
Insert an explicit validation/verification checkpoint into the workflow (e.g., 'After running the backtest, verify results against out-of-sample data and check for lookahead bias before reporting').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and efficient with no over-explanation of concepts Claude already knows; sections like "Use this skill when" and "Do not use" are direct and every token earns its place. | 5 / 5 |
Actionability | Instructions are high-level directives ("Define hypothesis, universe, timeframe", "Build point-in-time data pipelines", "Implement event-driven simulation") with no concrete code, commands, or executable examples, matching the anchor for minimal concrete guidance with high-level hints. | 2 / 5 |
Workflow Clarity | A rough sequence is listed (define → data pipelines → simulation → train/validation/test splits → walk-forward) but there are no explicit validation checkpoints, and backtesting is a validation-heavy operation so the rubric cap of 3 applies. | 3 / 5 |
Progressive Disclosure | The body references resources/implementation-playbook.md twice, but no resources/ bundle directory exists, so the reference is a dead end; despite otherwise clear section structure, the broken one-level-deep reference fits between minimal structure (2) and some structure (3). | 2 / 5 |
Total | 12 / 20 Passed |