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 tightly written operational skill: executable commands with concrete flags, a clearly sequenced search workflow with verification checkpoints and a troubleshooting table, and a bundle whose on-disk structure (5 reference files, finder script) matches every path the body cites. The only real weakness is mild redundancy in the Codex Notes section and some inline CLI documentation that could be slightly tightened.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense operational guidance (command blocks, filter/field tables, troubleshooting rows) with almost no padding or explanation of concepts Claude already knows. It sits at anchor 4 rather than 5 because the 'Codex Notes' section largely repeats Phase 0's finder workflow and example commands, and the Subagent/Child Sessions storage table could be trimmed or delegated to references. | 4 / 5 |
Actionability | Commands are fully executable and copy-paste ready ('python3 scripts/find-agent-sessions.py list --limit 20', 'find --query ... --include-subagents --workers 64', 'read <session-id>'), with concrete query-lane expansion heuristics and per-problem troubleshooting fixes. Not anchor 4 because the examples cover the common cases (fuzzy recall, cross-platform search, subagent inclusion) completely. | 5 / 5 |
Workflow Clarity | The Phase 0 steps form a clear sequence: route to the platform reference, run the broad finder with expanded query lanes, split parallel lanes when needed, read via detail_hint, then 'Verify by opening raw transcripts for claims'. Explicit validation checkpoints (detail_hint before ad hoc digging, raw-path verification) plus a troubleshooting table for error recovery match anchor 5; this is a read-only search skill so the destructive-batch cap does not apply. | 5 / 5 |
Progressive Disclosure | SKILL.md is an overview with well-signaled, one-level-deep references: the platform router table maps each platform to a specific references/*.md file, all of which exist in the bundle, and per-platform storage details are correctly deferred to references and the script. Navigation is easy and nothing is nested two levels deep. | 5 / 5 |
Total | 19 / 20 Passed |