Content
88%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 excellent operational skill: fully executable commands, explicit validation checkpoints with a fallback loop, and a clean section structure. The only deductions are minor — slight redundancy between the overview and detail sections, a version-pinned detail outside a deprecation section, and all content inlined in one file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean operational commands with no padding of concepts Claude already knows, and the env -i rationale is project-specific and justified. Minor trimmable instances remain — the Core Workflow partially repeats later sections, and the time-sensitive "OpenCode 1.17.11" version pin sits outside any deprecated/old-patterns section — matching anchor 4 rather than 5. | 4 / 5 |
Actionability | Every step is fully executable copy-paste bash: npm pack with a temp destination, tarball install and version check, complete opencode.json heredocs, full env -i opencode run invocations with timeout, an rg log-signature search, and a fill-in reporting template. Both the isolated and host-provider common cases are covered, matching anchor 5. | 5 / 5 |
Workflow Clarity | An 8-step numbered workflow carries explicit validation checkpoints: opencode debug config verification with a three-item Confirm checklist, the expected "OK" result, "No matches should appear" for the crash-signature search, and a recovery loop ("If OpenCode needs provider aliases... run a second non-isolated smoke"). This matches anchor 5; the operation is a read-only smoke test so the destructive/batch cap does not apply. | 5 / 5 |
Progressive Disclosure | Well-organized single-file skill with clear sections (Core Workflow, Pack Candidate, Isolated Config, Runtime Smoke, Host-Provider Smoke, Reporting Template) and no nested or dead references — the referenced bundle directories do not exist and no external files are cited. At ~155 lines with everything inlined (e.g., the reporting template and host-provider variant), the under-50-line simple-skill exception does not apply, matching anchor 4 rather than 5. | 4 / 5 |
Total | 18 / 20 Passed |