Content
65%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 compact, well-organized reference with concrete paths and config, but the plugin template is placeholder code with no working hook example or explicit creation/verification workflow, leaving the user to assemble the steps themselves.
Suggestions
Replace the placeholder template with one complete, executable plugin example showing a real hook (e.g. a working hook name and handler from the OpenCode API).
Add a short ordered workflow: create the file in the appropriate directory (from the paths listed), implement hooks, and verify the plugin loads on startup.
Trim filler such as the '(Already Configured)' heading qualifier and 'Use the docs as the escape hatch when unsure' to tighten the body further.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and fact-dense (paths, load order, cache location), with only minor trimmable bits such as 'Use the docs as the escape hatch when unsure', the '(Already Configured)' heading, and the Reference line duplicating the Notes section — anchor 4, not quite 'every token earns its place'. | 4 / 5 |
Actionability | Plugin paths and the opencode.json snippet are concrete, but the plugin template is a placeholder — '// Hook implementations go here' with no actual hook names or working example — so the core artifact is not executable as written, matching anchor 3. | 3 / 5 |
Workflow Clarity | The body lists where plugins live and how they load, but there is no ordered create-a-plugin sequence (where to save the template, how to confirm it loaded) and no verification checkpoints; the content reads as reference facts rather than a workflow — anchor 3. | 3 / 5 |
Progressive Disclosure | Under 50 lines, no bundle files needed, well-organized sections, and a clearly signaled one-level-deep external reference (official docs URL); the simple-skill exception applies. | 5 / 5 |
Total | 15 / 20 Passed |