Content
56%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 body with a clear sequenced workflow and a useful error-recovery table, but it is undermined by execution gaps (the options_flow.py script and credentials file it references do not exist in the bundle, and most analysis steps lack executable detail), domain-concept over-explanation, and poor bundle hygiene — two of the three reference files are orphaned while their content is duplicated inline.
Suggestions
Link references/errors.md and references/examples.md from the body (e.g., in the Error Handling and Examples sections) or remove the duplicated inline content so all bundle files are discoverable.
Ship the actual options_flow.py script (or a scripts/ implementation) and provide executable commands or formulas for steps 2-9 instead of prose descriptions, since the example commands currently reference a script that is not in the bundle.
Trim explanations of options concepts Claude already knows (put/call ratio semantics, the max pain definition, IV compression/expansion meanings) and the redundant '# 1000000 = 1M limit' comment.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with well-organized sections, but includes unnecessary explanations of concepts Claude already knows: 'ratio above 1.0 indicates bearish bias; below 1.0 indicates bullish', the max pain definition ('the strike price at which the most options expire worthless'), 'vol compression (potential breakout ahead) or vol expansion (uncertainty increasing)', and a prerequisites list of options terminology. That is more than the 'minor instances' of the level-4 anchor but not the padded verbosity of level 2, fitting 'mostly efficient but includes some unnecessary explanation or could be tightened'. | 3 / 5 |
Actionability | Concrete guidance exists — example commands like 'python options_flow.py btc --summary' and 'python options_flow.py eth --iv-curve --format json', a specific credentials path, and '--min-notional 1000000 --period 24h' flags — but it is incomplete: the referenced 'options_flow.py' script and 'config/crypto-apis.env' are absent from the bundle (no scripts/ or config/ directories), step 2's 'Run Bash(crypto:options-*)' is a permission pattern rather than a command, and steps 3-9 ('Calculate the aggregate put/call ratio', 'Track max pain levels') are prose directions with no executable code or formulas. This matches 'some concrete guidance but incomplete; missing key details'. | 3 / 5 |
Workflow Clarity | The 10 Instructions steps form a clear, logical sequence (authenticate, pull the chain, build OI heatmap, compute put/call, filter block trades, analyze IV term structure, track max pain, compare baselines, report, export), and the Error Handling table maps concrete failure modes ('API Rate Limit Exceeded', 'WebSocket connection dropped') to recovery actions, functioning as recovery checkpoints for a read-only, non-destructive workflow. Not level 5 because proactive validation checkpoints (verify authentication before pulling, validate data completeness before computing statistics) are implicit rather than explicit. | 4 / 5 |
Progressive Disclosure | Scored against the actual bundle: only references/implementation.md is linked from the body ('See references/implementation.md for the full implementation workflow'), while the bundle's references/errors.md and references/examples.md are never referenced anywhere — buried and undiscoverable — even though the body inlines its own Error Handling table and Examples section that duplicate their content. Section structure within the body is good and the one reference is clearly signaled, so this fits 'some structure but could be better organized; references present but not clearly signaled; content that should be separate is inline' rather than the minimal-structure level-2 anchor. | 3 / 5 |
Total | 13 / 20 Passed |