Content
88%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, dense tool-guide: every section delivers non-obvious operational facts with executable examples, a clearly sequenced list-search-read workflow, and explicit error-recovery guidance. The only real weaknesses are mild redundancy in the Rules section and inline reference-grade detail (e.g. the time_range grammar) that a slightly leaner file or a small reference file could absorb.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence (it never explains ripgrep, Python, or what compaction is) and packs each section with non-obvious facts like "The range is `[start, end)` in the original file. Filtering never renumbers messages." Minor trimmable verbosity remains: the exhaustive "Never edit, overwrite, append to, truncate, rename, move, delete, or replace" enumeration and Rules bullets that repeat body points (e.g. preferring `history_files`). | 4 / 5 |
Actionability | Four complete, copy-paste-ready `tool.call(...)` snippets with exact parameter dicts cover the common cases (default list, filtered list, scoped search, no-keyword browse, ranged read), and the exact `time_range` string forms are given with "Use the space-separated forms above in generated calls." This matches anchor 5: fully executable guidance covering common cases. | 5 / 5 |
Workflow Clarity | The sequence is explicit up front ("The normal flow is list when the file is unknown, search for a message, then read a small range around a hit") and mirrored by the numbered sections, with feedback loops for error recovery: "If there is no result, shorten the pattern or remove it only after the history files, time range, and message types are narrow enough" and "If the Agent name or ID is unknown, list subagents before reading one." The skill is read-only, so the destructive/batch validation cap does not apply. | 5 / 5 |
Progressive Disclosure | No bundle files exist; the single file is well-organized into numbered sections ("## 1. Discover history files" through "## Rules") with all content appropriately inlined for a skill of this size. It stops short of anchor 5 because at roughly 120 lines it exceeds the under-50-line simple-skill exception and reference-grade material (the full `time_range` grammar, pattern semantics) is inlined rather than split out. | 4 / 5 |
Total | 18 / 20 Passed |