Content
92%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.
A well-structured, highly actionable skill body: executable commands, clearly sequenced phases with validation gates, and clean one-level-deep reference routing verified against the actual bundle. The only weakness is mild repetition of the not-a-trade-signal guardrail across three sections.
Suggestions
State the 'crowding alone is not a trade signal' guardrail once (Guardrails) and reference it from the Overview and Phase 3 with a one-line pointer instead of restating it fully each time.
Merge the duplicated speculator-vs-commercial rationale (Overview 'Core thesis' and Guardrails 'Fade speculators, not commercials') into a single location, leaving the other as a brief cross-reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean and its domain content (Shapiro's thesis, COT Index thresholds, publication lag) is genuinely non-obvious, but the 'crowding alone is not a trade signal' guardrail is stated three times (Overview, Phase 3, Guardrails) and the fade-speculators-not-commercials rationale appears twice, so minor trimming is possible. Not 3: padding is minor and intentional, not unnecessary explanation of known concepts. | 4 / 5 |
Actionability | Three copy-paste-ready command variants ('--core', '--symbols', full universe) with exact script paths, named output files with their schemas, and concrete per-step manual guidance (WebSearch for news failure, stop at swing extreme, exit at COT Index toward 50). | 5 / 5 |
Workflow Clarity | Phases 1–3 are clearly sequenced with prerequisites validated upfront (FMP API key, Premium+ plan, Python 3.9+), a feedback mechanism for failed/insufficient-history markets (skipped list with reasons, 'never silently dropped'), and an explicit confirmation gate ('steps 2 and 3 must both confirm first'). The screening is read-only, so the destructive/batch cap does not apply. | 5 / 5 |
Progressive Disclosure | The body is an overview with both referenced files (references/shapiro-methodology.md, references/cot-index-calculation.md) existing as real one-level-deep files and no further nesting, plus a 'When to Load References' section that explicitly says references are not needed for regular execution. | 5 / 5 |
Total | 19 / 20 Passed |