Content
90%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 lean, highly actionable reference that consistently shows executable commands with real flags and payloads, delegates full API detail to the tool's own help surfaces, and includes explicit error-handling and validation guidance. The main improvements are marginal: promoting the implicit session lifecycle into an explicit sequence and moving flag-level reference detail into a separate file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and lean: every line carries tool-specific facts Claude cannot know (JSON envelope shapes, flag semantics, error codes like 'managed_resource_conflict', session-binding rules). It assumes Claude's competence and contains no padding or explanations of known concepts, matching the anchor 'Lean and efficient; every token earns its place'; level 4 would require minor instances of over-explanation, which are absent. | 5 / 5 |
Actionability | Commands are copy-paste ready with real arguments and payloads ('opencli browser open https://example.com --session research', chrome call examples with full JSON argument strings), and executable discovery paths are provided ('opencli list <query>', 'opencli browser <command> --help -f json'). Examples cover the common cases (open/state/click/close, network variants, native chrome calls), matching the level-5 anchor rather than level 4's 'minor gaps'. | 5 / 5 |
Workflow Clarity | The session lifecycle and interaction sequence (open --session, state, find/interact by ref, close) is clearly laid out, and validation checkpoints are present: 'When error.outcome is unknown, inspect the affected state before retrying a write', stale-ref recovery ('read fresh state or locate the element again'), and 'Check analysisComplete, script errors, omitted scripts and networkSource'. It is not level 5 because there is no explicit numbered workflow or end-of-task checklist — sequence is implied by section order — though it stays above level 3 because error-recovery feedback loops are explicitly stated, so the destructive/batch cap does not apply. | 4 / 5 |
Progressive Disclosure | Sections are well organized and full API detail is delegated one level deep to clearly signaled discovery surfaces ('opencli list <query>', '--help -f json', 'chrome describe' listing signatures and documentation). It is not level 5 because the ~85-line body inlines flag-level reference detail (the paragraph of state/find/fill/wait flag semantics) with no external reference files organizing it, and the under-50-line simple-skill exception does not apply; it exceeds level 3 because the structure is consistently clear and navigation is easy. | 4 / 5 |
Total | 18 / 20 Passed |