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.
The body is a well-structured operational guide: fully executable commands, a clearly sequenced workflow with an explicit verification step, and clean one-level-deep progressive disclosure into real reference files. The only weakness is mild bulk in the output-field and troubleshooting tables that could be tightened or offloaded to a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and nearly every token is novel operational fact (store locations, flags, linkage tables, filter semantics), but the 16-row Output Contract field table and lengthy troubleshooting rows (e.g., the Aside entry) carry detail that could be trimmed or moved. This matches the score-4 anchor (efficient, minor instances that could be trimmed) rather than 5 (lean) or 3, since nothing explains concepts Claude already knows and no section is padded. | 4 / 5 |
Actionability | Every section gives copy-paste-ready commands (e.g., `find "commit" --from 7d --platform senpi --platform opencode`) plus exact flag/filter tables, exact store paths, and ready-to-run `detail_hint` commands. There are no gaps — commands are executable as written and the multi-query/subagent examples cover typical usage — so it exceeds the score-4 anchor. | 5 / 5 |
Workflow Clarity | Phase 0 gives a clearly numbered sequence: platform router first, broad finder with query-lane expansion, parallel explorer lanes, read via detail_hint, then explicit verification ("Verify by opening raw transcripts for claims"), with the Troubleshooting table serving as the error-recovery loop. No destructive or batch operations are involved, so the validation cap does not apply, and the explicit verification checkpoint matches the score-5 anchor. | 5 / 5 |
Progressive Disclosure | SKILL.md is a genuine overview with per-platform detail split one level deep into five real reference files (references/codex.md, claude.md, senpi.md, opencode.md, all-platforms.md — all present in the bundle), clearly signaled by the platform-router table, plus a real scripts/find-agent-sessions.py. References are well signaled, one level deep, verified to exist, and the split is exactly appropriate, so it exceeds the score-4 anchor. | 5 / 5 |
Total | 19 / 20 Passed |