Content
100%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 compact reference: dense with tool-specific facts, concrete commands, explicit safety rules, and built-in failure handling, with no filler and no unnecessary external files. It models its stated constraints (read-only default, orchestrator-only operation, optional registration) precisely and consistently.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and every token earns its place: it contains only Aside-specific facts Claude could not know ('120-second timeout; `page` starts unset, so call `openTab(url)` or `getTabs()` first') with no padding or explanation of known concepts. Version sensitivity is handled with an explicit fallback ('Flag and tool names here reflect one observed version; if a probe or a call fails, treat Aside as absent') rather than a pinned version number. | 5 / 5 |
Actionability | For an instruction-only skill the guidance is fully concrete: copy-paste ready commands ('moai mcp add aside --command aside --args mcp --scope user', 'aside --version', 'aside skills install') and specific executable rules ('Prefer to omit `--permission` entirely', 'restrict REPL work to navigation, reading, and screenshot operations', 'Redirect verbose REPL output to a file and bring only the exit code and a bounded tail into context') cover the common cases. | 5 / 5 |
Workflow Clarity | This is a simple single-purpose skill under 50 lines whose action is unambiguous, and validation checkpoints are present rather than missing: an availability probe ('aside --version'), a failure fallback ('if a probe or a call fails, treat Aside as absent'), a silent-continue path when excluded ('for example when `CI=true`'), and mandatory operator confirmation before any state-changing step. Because verification steps exist, the destructive-operation cap at 3 does not apply. | 5 / 5 |
Progressive Disclosure | The skill has no bundle files (references/, scripts/, and assets/ do not exist) and the body contains no dangling file references, so nothing needs external splitting. At under 50 lines with clear, well-organized sections (Purpose, When to use, Who operates it, Safe-use rules, Optional registration, Relation to /moai e2e) it qualifies for 5 under the rubric's simple-skill provision. | 5 / 5 |
Total | 20 / 20 Passed |