Content
76%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.
Highly actionable content with executable, copy-paste-ready examples and a tight key-rules section that captures the non-obvious API details. The main weakness is the scaffold workflow, which lacks any verification step to confirm the plugin loaded correctly after session restart.
Suggestions
Add a validation step to the scaffold workflow, e.g. after restart, confirm the plugin loaded by checking that its tools are available (or by inspecting OpenCode's plugin load output) before telling the user it is done.
Move the full hooks listing and/or the Anthropic compatibility table into a one-level-deep reference file (e.g. references/hooks.md) and keep only the most common hooks inline in SKILL.md.
Trim the "Available hooks" block to the hooks most plugins actually use, since tool-execute and event hooks are already exercised by the multi-tool example.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The key-rules list and code examples are dense with little padding and no explanation of concepts Claude already knows, but the Anthropic compatibility table and inline hooks listing could each be trimmed. | 4 / 5 |
Actionability | Two complete copy-paste TypeScript examples (minimal shape and multi-tool plugin) plus both file-path and npm registration JSON cover the common cases fully. | 5 / 5 |
Workflow Clarity | The "Scaffold workflow" section lists a clear 3-step sequence (create file, register in opencode.json, restart session) but includes no validation checkpoint such as verifying the plugin actually loaded after restart. | 3 / 5 |
Progressive Disclosure | The single-file body is well-sectioned with no buried references or nesting, but at ~160 lines with an inline hooks API listing it is somewhat past the size where a split reference file would improve organization. | 4 / 5 |
Total | 16 / 20 Passed |