Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is highly actionable, packed with executable commands and clear validation-gated workflows with feedback loops, but the ~700-line monolithic body repeats env-var boilerplate and inlines reference catalogs instead of splitting them into bundle files. Progressive disclosure and conciseness are the weakest dimensions.
Suggestions
Extract the Observability Flags catalog and the desktop/WebVNC + diagnostics command listings into reference files (e.g. references/flags.md, references/desktop.md) and link to them from the body, reducing the main SKILL.md to an overview.
Dedupe the repeated CI env-var prefix ('CI=1 NODE_OPTIONS=... OPENCLAW_TEST_PROJECTS_PARALLEL=6 ...') by defining it once as a variable or snippet and referencing it, instead of repeating it verbatim in every example.
Consolidate the duplicated Blacksmith footgun and cleanup notes (currently restated in 'If Crabbox Fails', 'Blacksmith Backend Notes', and 'Failure Triage') into a single shared section to remove redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence with no basic-concept padding, but the long CI env-var prefix is repeated verbatim across 4+ command examples and Blacksmith footgun/cleanup notes are duplicated across sections, so it is mostly efficient but could be tightened (anchor 2) rather than lean with every token earning its place (anchor 3). | 2 / 3 |
Actionability | It provides extensive fully-executable shell commands with concrete flags and copy-paste-ready examples (warmup/run/stop, desktop/webvnc, diagnostics, E2E templates), matching the anchor 3 example of specific, executable guidance. | 3 / 3 |
Workflow Clarity | Multi-step processes are clearly sequenced (the numbered E2E verification flow) with explicit validation checkpoints ('Verify cleanup when a run fails', 'prove the expected command before handing off', 'Read the JSON summary... exitCode') and feedback loops in the 'If Crabbox Fails' triage, matching anchor 3. | 3 / 3 |
Progressive Disclosure | The body is well-sectioned with clear headers, but it is a ~700-line monolith with no bundle files and inlines reference material (the Observability Flags catalog, desktop/WebVNC and diagnostics command listings) that could be split out, matching anchor 2 ('content that should be separate is inline') rather than the split, one-level-deep references of anchor 3. | 2 / 3 |
Total | 10 / 12 Passed |