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.
This is a highly actionable, well-structured scout prompt with concrete tool calls, SQL, and memory-key formats throughout, and it practices good progressive disclosure by offloading generic report mechanics to a deep reference. Its only weak spots are mild count/users-framing repetition and the absence of an explicit validate→fix→retry loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational (exact tool names, key-prefix formats, SQL fragments) and mostly avoids explaining concepts Claude already knows, though the count-vs-distinct_users framing is restated across the intro, the shape table, and the Explore section and could be tightened slightly. | 4 / 5 |
Actionability | It provides copy-paste-ready, fully executable guidance — exact MCP tool calls with parameters (`query-error-tracking-issues-list` filtered to `status=active`, sort by `last_seen_at`), concrete SQL (`event = '$exception' AND properties.$exception_issue_id = '<id>'` grouped by `toStartOfHour(timestamp)`), and exact scratchpad key formats — covering the common cases. | 5 / 5 |
Workflow Clarity | The run is a clearly sequenced cycle (Get oriented → Profile shape → Explore → Save memory → Decide → Close out) with explicit checkpoints (search the inbox and scratchpad `noise:`/`addressed:`/`dedupe:` entries before authoring, edit-vs-author rules, 'When to stop'), though there is no formal validate→fix→retry feedback loop, leaving a minor validation gap. | 4 / 5 |
Progressive Disclosure | The body is well-sectioned and deliberately pushes generic report mechanics out to `references/report-contract.md` (clearly signaled and one level deep), keeping only error-tracking-specific framing inline; the only gap is that the referenced file lives in another skill (`authoring-scouts`) rather than this skill's own bundle, so navigation is slightly indirect. | 4 / 5 |
Total | 17 / 20 Passed |