Content
75%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 disciplined, information-dense body that documents genuine tool constraints and gives a clear multi-step query workflow with three well-defined views. Its weaknesses are redundancy between the Workflow and Rules sections, a missing concrete URL pattern for the mandated dashboard deep link, and cross-references to files and sibling skills that are not present in this skill's bundle.
Suggestions
Deduplicate the Rules section — most rules restate workflow steps verbatim; keep only the rules that add new constraints.
Give a concrete deep-link pattern (e.g. 'https://dashboard.convex.dev/d/<deployment>/logs?function=<name>') so the mandated link is copy-paste constructible.
Resolve or ship the referenced artifacts ('specs/finding.schema.json', deploy-guard, convex-advisor, monitor/sentinel) — either bundle them as references/ files or describe their interfaces inline so the hand-off step is self-contained.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence — it explains no general concepts and documents real tool limitations ('logs takes only a --history COUNT... there is NO server-side status/function/requestId/time filter'). It stops short of a 5 because the Rules section substantially restates workflow steps (no-server-filter, dashboard link, discover-first, and hand-off each appear twice), which could be trimmed. | 4 / 5 |
Actionability | Concrete, executable guidance throughout: named tools with flags ('logs --history <n> --jsonl', 'insights', 'functionSpec', 'status'), a defined answer format (one-line finding + counts + first stack per group + deep link), and explicit client-side filtering steps. It misses a 5 because the dashboard deep link — a required part of every answer — is described only as 'build it from the deployment name + function' with no URL pattern to copy. | 4 / 5 |
Workflow Clarity | Seven clearly sequenced steps with real checkpoints: a guard step (identify the deployment), discover-before-query discipline, three named views with when-to-use-each, a bounded-window rule, and a correlate-don't-assert cross-check. The skill is read-only so the destructive-cap does not apply, but there is no explicit feedback loop for error recovery (e.g., what to do when the window contains no failures or the function name isn't found), keeping it below the 5 anchor. | 4 / 5 |
Progressive Disclosure | Under 50 lines, single-purpose, and well organized with a Workflow section and a Rules section, which per the simple-skill note would support a 5. However, the body references paths and sibling skills outside this skill's bundle ('specs/finding.schema.json', 'deploy-guard step 0-1', 'convex-advisor', 'monitor/sentinel') with no references/ or scripts/ files present, leaving dangling navigation — a minor organization gap matching the 4 anchor. | 4 / 5 |
Total | 16 / 20 Passed |