Content
77%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is well-structured and mostly lean, with real base commands and clear per-domain workflows. Its main weakness is actionability: a substantial fraction of documented CLI flags are absent from the actual script, making those examples non-executable, and two reference bundle files (errors.md, examples.md) are present but never surfaced.
Suggestions
Reconcile documented flags with derivatives_tracker.py's argparse: either implement --history, --alert-threshold, --changes, --divergence, --recent, --min-size, --pcr, --expiry, --quarterly, --all, --min-yield, and --output, or remove the examples that reference them.
Link references/errors.md and references/examples.md from the body (e.g., in Error Handling and Examples sections) so the existing bundle files are discoverable, or fold their content out of the inline sections to keep the split one level deep.
Verify each code block against the script before publishing so all examples are copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Body is lean and well-organized with executable command blocks; sentiment/OI interpretation tables act as decision guidance rather than padding. Not a 2 because no concept-explaining fluff and every section earns its place. | 3 / 3 |
Actionability | Base commands (funding/oi/liquidations/options/basis/dashboard) are real, but many documented flags — --history, --alert-threshold, --changes, --divergence, --recent, --min-size, --pcr, --expiry, --quarterly, --all, --min-yield, --output — do not exist in derivatives_tracker.py's argparse, so those examples would error. Not a 3 because the examples are not copy-paste-ready; not a 1 because the core commands are concrete and executable. | 2 / 3 |
Workflow Clarity | Each market type is a clearly sequenced single action with interpretation guidance, plus an Error Handling table mapping errors to causes/fixes. No destructive or batch operations require validation checkpoints, so the simple-skill exception applies. | 3 / 3 |
Progressive Disclosure | Body points to references/implementation.md (one level, real file), but references/errors.md and references/examples.md exist yet are never linked from the body, and inline Output/Examples sections duplicate content that belongs in those reference files. Not a 3 because discovery of bundle files is incomplete and split is not fully clean; not a 1 because structure exists and the main reference is signaled. | 2 / 3 |
Total | 10 / 12 Passed |