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 exemplary process skill: fully executable commands and a clearly sequenced, validation-gated workflow, with detail correctly split into one-level-deep reference files that all exist and are cited where needed. Its only weakness is modest verbosity in historical anecdotes and low-level port mechanics that could be trimmed or moved to references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly every line carries operational specifics — exact commands, ports, env-var names — with no explanation of concepts Claude already knows, placing it above anchor 3. It sits at anchor 4 rather than 5 because of trimmable narrative: the historical-incident anecdotes ('that is what happened on the 2026-08-07 shakedown') and the WebTransport UDP-port mechanics paragraph could be tightened or pushed to references. | 4 / 5 |
Actionability | Fully executable throughout: 'git status --porcelain # must be clean', './mvnw install -DskipTests -Pfastinstall', 'grep 'AI config:' target/sweep/<sample>-<port>.log', the complete 'sweep-sample.sh start <sample> --port <9101+n> --ready-path <path> --env LLM_MODE=local' invocation, exact model names ('qwen2.5:3b', 'qwen2.5:7b-instruct-q4_K_M'), and a copy-paste attestation JSON template. This matches the 5 anchor — copy-paste-ready commands covering the common cases. | 5 / 5 |
Workflow Clarity | Steps 0–5 are explicitly sequenced with validation checkpoints at every risky point (clean-tree check, launcher that 'refuses to boot if the port is already answering', teardown that 'verifies the port is actually released', PASS/PARTIAL/FAIL evidence rules) plus an explicit feedback loop — 'Repeat triage → fix → re-test until the sweep is clean'. For a 33-sample batch operation this matches the 5 anchor with validation, error recovery, and checklists all present. | 5 / 5 |
Progressive Disclosure | Verified against the actual bundle: all seven references/, the script, and the asset exist with real content, and each is cited at the exact point of use (references/expo-sweep.md at Step 1b, references/cli-sweep.md at Step 1c, references/regression-specs.md at Step 3). References are one level deep with no nested pointers, and the 'Files in this skill' table aids discovery — matching the 5 anchor. Not a 4: there is no content that clearly belongs in a separate file still inlined; the body keeps only the orchestration procedure. | 5 / 5 |
Total | 19 / 20 Passed |