Content
82%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 throughout that match the actual scanner CLI, a compact error table, and appropriately deferred detail in real reference files. The main improvements are de-duplicating the Examples section against Instructions and linking the orphaned references/examples.md bundle file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — no explanation of what RSI/MACD/Bollinger Bands are, compact error table, and every section carries commands. The main trimmable padding is the Examples section, which re-runs three commands already shown verbatim in Instructions, and the Resources section's mild restatement of dependencies — matching anchor 4's 'minor instances that could be trimmed'. | 4 / 5 |
Actionability | Every command is copy-paste executable and verified against scanner.py's actual CLI (--watchlist, --symbols, --detail, --filter, --min-confidence, --rank, --output, --list-watchlists all exist), prerequisites include install commands, and the examples cover the common cases (multi-asset scan, single-symbol deep dive, filter/rank, JSON export). This matches the fully-executable anchor 5. | 5 / 5 |
Workflow Clarity | A clear sequence is present — install dependencies, quick scan, detailed analysis, filter/rank, export — and the Error Handling table maps each failure to cause and fix, providing recovery guidance. It is not a destructive or batch-mutating skill (read-only analysis plus optional JSON output), so the cap of 3 does not apply, but no explicit validation checkpoint (e.g., confirm data fetched before acting on signals) keeps it at anchor 4 rather than 5. | 4 / 5 |
Progressive Disclosure | Good structure: the body stays an overview and points to real one-level-deep files — references/implementation.md (output formats, backtester integration) and references/errors.md (comprehensive error handling), both of which exist. The gap keeping it from anchor 5: references/examples.md exists in the bundle but is never linked from the body, and implementation.md is cited twice (Output and Resources sections), which are minor organization/navigation gaps. | 4 / 5 |
Total | 17 / 20 Passed |