Content
29%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill provides comprehensive API documentation for a prediction market arbitrage tool, but it reads more like an auto-generated API reference than an actionable skill. It lacks a coherent end-to-end workflow with validation steps critical for financial operations, and the entire content is dumped into a single file rather than being progressively disclosed. The absence of error handling, risk validation checkpoints, and clear sequencing is concerning given the financial nature of the task.
Suggestions
Add a clear end-to-end workflow section (e.g., 'scan → evaluate → validate risk → execute → verify → record outcome') with explicit validation checkpoints and error recovery steps, especially given this involves real money.
Split the content into separate files: keep SKILL.md as a concise overview with quick-start example, and move the full TypeScript API reference, chat command reference, and scoring details into linked reference files.
Add validation and safety guardrails: what to check before executing (sufficient liquidity, fee impact, slippage limits), what to do if execution partially fails, and how to handle cross-platform settlement timing risks.
Remove verbose console.log formatting examples that pad token count without adding instructional value—Claude can generate appropriate logging on its own.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is extensive and mostly relevant, but includes significant verbosity in console.log examples that pad the token count without adding instructional value. The opportunity types table and scoring breakdown are useful, but the sheer volume of API surface documented inline is excessive for a SKILL.md. | 2 / 3 |
Actionability | The TypeScript code examples appear executable and concrete, and chat commands are clearly specified. However, this appears to reference a library ('clodds/opportunity') that may not exist or be verifiable, making the 'copy-paste ready' quality questionable. The code is detailed but its real-world executability is uncertain. | 2 / 3 |
Workflow Clarity | There is no clear multi-step workflow for actually finding and executing an arbitrage opportunity end-to-end. The content presents disconnected API methods without sequencing them into a coherent process. For an operation involving real money and cross-platform execution, there are no validation checkpoints, error recovery steps, or feedback loops for failed executions. | 1 / 3 |
Progressive Disclosure | This is a monolithic wall of text with the entire API reference inlined in a single file. The TypeScript API reference, chat commands, scoring details, and matching configuration should be split into separate reference files with the SKILL.md serving as a concise overview with links. | 1 / 3 |
Total | 6 / 12 Passed |