Content
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is well-structured and offers concrete entry points (install, MCP config, connector commands, example prompts), but it is verbose and repetitive and keeps large reference material inline rather than pushing it to bundled files. Workflows are sequenced but lack explicit validation checkpoints.
Suggestions
Move the full 54-tool catalog and per-zoo Alpha Zoo detail into separate reference files, leaving the SKILL.md body a concise overview that links to them.
Add explicit validation/verification checkpoints to the Shadow Account and backtest workflows (e.g. confirm data coverage, check for lookahead bias, verify report rendered).
Deduplicate the Alpha Zoo, tool-count, and data-source content that currently repeats across the intro, dedicated sections, tool table, and Quick Start.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and assumes Claude's competence (no basic-concept explanations), but it is padded with redundancy — the Alpha Zoo, tool counts, and data sources are repeated across the intro, dedicated sections, the 54-row tool table, and Quick Start — so it could be tightened considerably. | 2 / 3 |
Actionability | It provides some concrete executable guidance (pip install, MCP config JSON, connector CLI commands, example prompts), but the example workflows are largely prose prompts and the 54-tool table gives one-line descriptions without runnable signatures, leaving key usage details incomplete. | 2 / 3 |
Workflow Clarity | Multi-step processes like the Shadow Account loop and the backtesting example are clearly sequenced with tool names, but there are no explicit validation or verification checkpoints for batch/risky operations such as backtests or report rendering. | 2 / 3 |
Progressive Disclosure | The body has clear section structure, but large content blocks that could live in separate files — the full 54-tool catalog and the per-zoo Alpha Zoo detail — are inlined, and the bundle scripts/ directory is never referenced or signaled from the body. | 2 / 3 |
Total | 8 / 12 Passed |