Content
22%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill reads more like a feature specification or product mockup than actionable instructions for Claude. It lists data sources and shows desired output formats but provides no concrete implementation—no API endpoints, no code for fetching or comparing data, and no actual methodology for calculating 'confidence levels' or 'fair value.' The Kelly criterion example contains a mathematical error, further undermining trust in the guidance.
Suggestions
Add executable code or concrete tool-use instructions for actually fetching data from at least the primary sources (e.g., specific URLs to scrape, API endpoints, or MCP tool calls)
Define a clear step-by-step workflow: 1) identify market price, 2) fetch comparison data from specific source, 3) calculate discrepancy, 4) validate with secondary source, 5) compute Kelly sizing
Fix the Kelly criterion formula—the current example ((0.55*0.55 - 0.45*0.45)/0.55) is incorrect; the standard Kelly formula is (bp - q)/b where b=odds, p=probability, q=1-p
Remove the catalog-style data source listings or replace them with actionable access instructions (URLs, API keys needed, rate limits, data format returned)
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Reasonably efficient but includes some unnecessary listing of data sources Claude already knows about (538, RealClearPolitics, ESPN FPI, etc.) without adding actionable detail about how to access them. The data sources section is essentially a catalog of well-known sources without URLs or API endpoints. | 2 / 3 |
Actionability | Despite having command syntax and output format examples, there is no executable code, no API calls, no concrete instructions on how to actually fetch data from any of the listed sources. The skill describes what to do conceptually ('scan markets where price differs >10% from models') but never shows how. The Kelly formula example is also incorrect mathematically. | 1 / 3 |
Workflow Clarity | There is no clear multi-step workflow for edge detection. The examples section uses arrow notation to describe outcomes but doesn't sequence the actual steps Claude should take. There are no validation checkpoints, no error handling for when data sources are unavailable, and no guidance on how to assess confidence levels. | 1 / 3 |
Progressive Disclosure | The content is organized into logical sections (Commands, Data Sources, Examples, Output Format) which provides decent structure. However, the data sources section is a flat list that could benefit from linking to detailed reference files, and there's no separation between quick-start and advanced usage. | 2 / 3 |
Total | 6 / 12 Passed |