Content
62%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-organized, operationally dense skill body with a clear gated workflow, but it lacks a complete executable call example, carries some redundancy in the billing section, and its reference links use a path prefix that does not match the actual bundle location.
Suggestions
Fix the reference link paths: change qveris/references/rest-api.md and qveris/references/coverage.md to references/rest-api.md and references/coverage.md so they resolve to the actual bundle files.
Add one complete executable qveris_execute example (full parameters object, max_response_size, session_id/search_id) so the call guidance is copy-paste ready.
Tighten the Billing and Modes section by merging the two redundant free-mode bullets ("unavailable in mode=free" and "mode=free means...QVeris is hidden") into a single statement.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean and assumes competence (no explaining of OHLCV or options concepts), but the Billing and Modes section restates the free-mode behavior across two redundant bullets, so not every token earns its place. | 2 / 3 |
Actionability | It gives concrete tool names, parameter names, defaults (max_response_size 20480), enum/status values, CLI commands, and example queries, but provides no complete executable call example (e.g. a full qveris_execute payload), leaving the guidance concrete yet incomplete. | 2 / 3 |
Workflow Clarity | The three-step Discover → Inspect → Execute sequence is clearly ordered with explicit gating checkpoints ("inspect before any paid call", "only after the user has enabled QVeris and the tool has been inspected") plus decision branches for truncation and not-charged outcomes. | 3 / 3 |
Progressive Disclosure | The overview is well-sectioned and points to two one-level-deep bundle files, but the body links target qveris/references/rest-api.md and qveris/references/coverage.md while the real files live at references/*.md, so the referenced paths do not resolve. | 2 / 3 |
Total | 9 / 12 Passed |