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.
The SKILL.md body is an exceptionally well-written operational runbook: lean, fully executable, and sequenced with validation gates, recovery loops, and a completion checklist. Its one real weakness is the bundle structure — the referenced verification map and runtime reference files are missing from the bundle, breaking the disclosure chain the workflow depends on.
Suggestions
Ship the referenced files (features/README.md and features/runtime-reference.md, plus scripts/e2e/mock-openai-server.mjs) in the bundle, or inline minimal proof-selection and recovery guidance in SKILL.md so the workflow does not dead-end at step 2.
Add a short map of the scripts/ directory (which scripts are entry points vs. test helpers vs. preloads), since 46 flat files are currently unnavigable from SKILL.md.
Verify every relative link in SKILL.md resolves within the published bundle, especially features/runtime-reference.md#retained-run-recovery, which the cleanup failure path depends on.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, imperative, and free of padding — every sentence carries repo-specific constraints (e.g., "Readiness from a released lease never qualifies a later run") with zero explanation of concepts Claude already knows. It matches the "every token earns its place" anchor; no trimmable over-explanation was found to justify a 4. | 5 / 5 |
Actionability | Provides copy-paste-ready commands for the common case — the full runner invocation with concrete flags ("--dm --text 'Please answer with OPENCLAW_E2E_OK only.' --record ... --output ..."), the doctor command, and explicit success criteria ("Require `ok: true`, `botApiTransport: \"direct-https\"`, and `botApiProxy: false`"). Variant guidance (--create-forum, --chat, --source-gateway) is specific about when each applies. | 5 / 5 |
Workflow Clarity | A clearly sequenced four-step workflow (Prepare → Select the proof → Check readiness and run → Judge and clean up) with explicit validation gates, error-recovery feedback loops ("A send-confirmation timeout can follow an accepted send: preserve observed events and reconcile them, rather than blindly resending"), a repair-before-retry rule, and a completion checklist. This matches the top anchor including feedback loops and checklists. | 5 / 5 |
Progressive Disclosure | The body's structure is exemplary — one-level-deep, well-signaled references such as "[the verification map](features/README.md)" and "[runtime reference](features/runtime-reference.md)" — but scored against the actual bundle, those two referenced files (and scripts/e2e/mock-openai-server.mjs) do not exist, and scripts/ is a flat 46-file dump with no navigation from SKILL.md. Step 2's primary instruction ("Read the verification map, then only the recipe for the behavior under test") is broken at its first hop, which is a larger organization gap than the "minor organization gaps" allowed at 4. | 3 / 5 |
Total | 18 / 20 Passed |