Content
93%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.
An exemplary lean skill body: executable commands for every common case, precise output/error-envelope contracts, and explicit error-recovery guidance, with detail correctly delegated to referenced skills via the skills read mechanism. The only notable gap is that the primary discovery workflow is organized by section rather than laid out as an explicit sequence with a verify-before-write checkpoint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line carries operational facts Claude cannot infer — exact commands, JSON envelope shapes ('{ok:true,data:{commands,total,nextOffset?}}'), stderr/stdout conventions, flag semantics — with zero conceptual padding. It even guards against context bloat ('Do not hard-code the adapter catalog or dump all commands into context'), matching anchor 5: every token earns its place. | 5 / 5 |
Actionability | All common cases have copy-paste-ready invocations: 'opencli list search', 'opencli list --site github --limit 20', 'opencli github search --help -f json', 'opencli browser open https://example.com --session research', and the full adapter init/check/test/status sequence. The only sections without examples (plugin, auth, daemon) are deliberately routed through 'Read help for the selected capability', which is itself an executable discovery pattern consistent with this skill's design. | 5 / 5 |
Workflow Clarity | A clear discovery flow (list → inspect help → invoke → interpret envelope → recover via error codes) plus an ordered adapter workflow with real checkpoints ('adapter init' → 'adapter check' → 'adapter test' → 'adapter status') and safety gates ('Unknown write outcomes require inspecting state before repeating an action', 'Use error codes and supplied candidates/keys to recover'). It stays at 4 rather than 5 because the main discovery/invocation sequence is implied by section order rather than explicitly enumerated, and the adapter write-risk warning ('Adapter tests execute real commands and can perform writes') names the risk without an explicit verify-before-proceeding step. | 4 / 5 |
Progressive Disclosure | The body is a compact overview with well-organized sections that pushes detail to one-level-deep external references, each clearly signaled with a read mechanism: 'See opencli-browser for interaction, API evidence and tab/group management', 'See opencli-adapter-author for implementation', and 'Bundled skill content is available through skills list and skills read opencli-browser -f plain'. With no bundle files in this skill's directory, this split-and-pointer structure fully satisfies anchor 5. | 5 / 5 |
Total | 19 / 20 Passed |