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.
An exceptionally lean, operational skill body: exact commands, explicit handling of the tricky failure mode (a successful process exit encoding failure), and clear safety boundaries around credentials and mutations. The only gap is that the JSON payload structure behind the success check is unspecified.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every sentence carries operational information — the timeout guidance ("normally 11 minutes"), the availability check ("command -v openclaw"), the payload-parsing caveat, and safety constraints — with no padding and no explanation of concepts Claude already knows. This matches the lean, every-token-earns-its-place anchor. | 5 / 5 |
Actionability | The core guidance is concrete and executable: an exact command ("openclaw agent --local --agent main --message \"<prompt>\" --json --timeout 600") and a specific availability check ("command -v openclaw"). It falls just short of the top anchor because the JSON payload's success/failure structure is never shown, leaving "accept the response only when the JSON payload reports success" without a literal field-level example. | 4 / 5 |
Workflow Clarity | The three-step sequence (set working directory and timeout, check availability, run once) includes explicit validation checkpoints — parse the JSON payload "even when the process exits zero" and "Report payload errors and timeouts as failures" — plus defined failure paths (stop and ask the user on missing binary or missing onboarding/credentials). This matches the explicit-validation anchor rather than the minor-gaps anchor at 4. | 5 / 5 |
Progressive Disclosure | The body is under 50 lines, requires no external references (the bundle has no references/, scripts/, or assets/ directories), and is organized into two clear sections ("## Run", "## Authentication And Permissions"). Per the simple-skill guideline, this earns the top score with just well-organized sections. | 5 / 5 |
Total | 19 / 20 Passed |