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.
A well-structured, highly actionable QA skill body that routes each need to tested scripts and one-level-deep references, with strong validation checkpoints and isolation guards throughout. The only weakness is a few passages of trimmable prose that lightly pad an otherwise lean overview.
Suggestions
Trim the 'Honest verdict: tmux is fine for SMOKE...' paragraph and other restating prose to the essential conclusion, since the scripts and references already demonstrate the behavior.
Collapse the version-specific note ('Verified against opencode v1.17.7 (bun 1.3.12, macOS)') into a single sanity-check instruction to reduce time-sensitive clutter.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and mostly efficient, assuming Claude's competence, but contains minor trimmable prose such as the 'Honest verdict: tmux is fine for SMOKE...' narration and a few explanatory sentences that restate what the scripts already demonstrate. It is above the midpoint but not perfectly lean, so 4 rather than 5. | 4 / 5 |
Actionability | Copy-paste-ready, fully executable commands throughout — `opencode run "list files in src" --format json`, `bash scripts/sse-hook-probe.sh --self-test`, real curl invocations with auth flags and session ids — covering the common cases per case in the router. | 5 / 5 |
Workflow Clarity | A router table maps each QA need to a case, script, and reference; 'Golden rules' act as a pre-flight checklist; and explicit validation checkpoints pervade — every script ships `--self-test`, isolation is proven by comparing session counts before/after, and the text script refuses unbounded scans as a feedback guard against the 25 GB table. | 5 / 5 |
Progressive Disclosure | SKILL.md is an overview that routes to well-signaled one-level-deep references via markdown links (references/cli-commands.md, db-investigation.md, server-api.md, events-hooks.md, tui-tmux.md, testing-harness.md, sdk.md, docker-qa.md), all of which exist as real files, with detailed bulk content appropriately split out rather than inlined. | 5 / 5 |
Total | 19 / 20 Passed |