Content
92%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 strong, highly actionable body with a well-sequenced workflow and clean one-level-deep reference split. The only weakness is minor conciseness fat from duplicated troubleshooting tables and a background 'how it works' paragraph that could be trimmed.
Suggestions
Remove the duplicate rows between the Step 1 'Common setup issues' table and the end-of-file 'Error Reference' table — keep one canonical troubleshooting table and cross-reference it.
Trim or shorten the 'How it works' paragraph (CDP cookie harvesting, CORS preflight, Electron main-process bypass) to the one sentence Claude needs to act; the operational detail is not required to run the commands.
Consider folding the short Step 5 'Diagnostics' section into the existing Step 1 status check / Error Reference, since `opencli tradingview status` is already covered there.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient — the body is dominated by high-signal command tables and concrete examples — but carries minor trimmable fat: the 'How it works' paragraph explains CORS preflight / Electron main-process internals Claude does not need to execute, and the 'Common setup issues' table (Step 1) is largely duplicated by the 'Error Reference' table at the end. It is not a level-3 because the bulk is dense, actionable reference material rather than padded explanation. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands with concrete worked examples (e.g. `opencli tradingview options-chain --ticker SNDK --expiry 2026-05-22 -f json`, the RSI<30 screener, the crypto-by-market-cap screener), plus a format-flag table and per-command output-column listings that cover the common cases. | 5 / 5 |
Workflow Clarity | A clear five-step sequence (Ensure installed → Identify need → Execute → Present → Diagnostics) with an explicit validation gate in Step 1 (the status block branching on READY / SETUP_NEEDED / NOT_INSTALLED) and a feedback loop via the Error Reference table for recovery; the read-only scope means no destructive/batch validation cap applies. | 5 / 5 |
Progressive Disclosure | SKILL.md is an overview of command tables organized by step, with the bulk detail (every command, all flags, output examples, analyst workflows) split one level deep into references/commands.md — a real bundle file that is clearly signaled both inline ('See references/commands.md for the operations cheat sheet') and in a dedicated Reference Files section. | 5 / 5 |
Total | 19 / 20 Passed |