Content
85%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.
A well-engineered instruction-only skill: an unambiguous 10-step workflow with validation checkpoints and error-recovery loops, supported by real one-level-deep reference files and a working port-resolution script whose read conditions are explicitly gated. The only slack is mild justificatory prose in the port and question-tool sections that could be tightened.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational throughout — no paragraphs explaining what a browser or dev server is, and every rule carries harness-specific policy rather than common knowledge. There are minor instances that could be trimmed: step 4's justification of why .env is trustworthy but prose mentions are not, step 6's extended question-tool negotiation logic, and the Modes section pre-summarizing what references/pipeline-orchestration.md then re-states. That places it at the efficient-with-minor-trimming anchor, not the every-token-earns-its-place anchor. | 4 / 5 |
Actionability | Concrete, executable commands appear inline where they matter — `gh pr view [number] --json files -q '.files[].path'`, `git diff --name-only main...HEAD`, `scripts/resolve-port.sh`, `http://localhost:<port>` — and the referenced files (route-and-report.md, agent-browser-driver.md, pipeline-orchestration.md) carry complete copy-paste command blocks, which all exist in the bundle. Minor gaps remain in the body itself: steps 3 and 7 are directive summaries whose executable detail lives entirely in the references, and element-interaction specifics depend on the driver's own docs, so it sits at 'mostly executable with minor gaps' rather than fully copy-paste-ready. | 4 / 5 |
Workflow Clarity | A 10-step sequence with explicit validation checkpoints at the fragile points: verify the dev server is running before spending the headed/headless question (step 5), verify the root is served before iterating routes (step 6), and per-page check lists in the reference. Error recovery is a genuine feedback loop (capture error state + exact repro, then fix-and-re-run the failing test), with distinct, well-defined unattended behavior for pipeline mode (log Skip with reason, continue). This matches the anchor requiring explicit validation steps plus feedback loops for error recovery. | 5 / 5 |
Progressive Disclosure | The body is a clear overview with three one-level-deep reference files and one script, all of which exist in the bundle, each explicitly signaled with its read condition (route-and-report.md before step 3, agent-browser-driver.md before running any command, pipeline-orchestration.md only in pipeline mode). No reference chains into another referenced file — agent-browser-driver.md delegates remaining commands to the CLI's own runtime docs, not to another bundle file. Content is split exactly along likelihood-of-use lines: pipeline-only orchestration and driver-specific commands are out of the always-loaded path. | 5 / 5 |
Total | 18 / 20 Passed |