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.
The body is an exemplary lean overview: concrete commands, an executable adapter example, real validation steps for a write-capable workflow, and clearly signaled selective references. The only gaps are a not-quite-explicit error-recovery loop and incomplete discoverability of the reference bundle from the main file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and every line carries tool-specific facts Claude cannot know (opencli command shapes, the cli({...}) contract, adapter file locations, fixture flags). There is no generic explanation of concepts Claude already knows and no padding, matching the level-5 anchor. | 5 / 5 |
Actionability | Guidance is fully executable: copy-paste shell commands for listing, browser evidence, init, check and test, plus a complete runnable adapter example. The JSON return, typed-error, access and columns contracts are concretely specified, matching the level-5 anchor for executable, common-case-covering examples. | 5 / 5 |
Workflow Clarity | The sections give a clear sequence — reuse existing adapters, gather evidence, author via `adapter init`, then `check`/`test` — with validation checkpoints (`check` validates without executing, fixtures compare results, `--trace retain-on-bailure` diagnoses failures) and explicit write-safety rules (test account, dry-run, 'Do not automatically replay a write with an unknown outcome'). It falls short of level 5 only because there is no explicit fix-and-retest feedback loop spelled out for check/test failures. | 4 / 5 |
Progressive Disclosure | The 'Optional references' section clearly signals five real, one-level-deep files with 'Read only what is useful for the current task', and all five named files exist in references/. It is not level 5 because the bundle contains seven additional reference files (coverage-matrix, field-conventions, jsdom-fixture-pattern, site-recon, strategy-selection, success-rate-pitfalls, typed-errors) not reachable from SKILL.md except by a vague 'Site notes and fixtures are optional knowledge aids' aside, leaving a minor navigation gap. | 4 / 5 |
Total | 18 / 20 Passed |