Content
75%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.
The body is a dense, highly actionable workflow: concrete tool calls with specific parameters, relevance checkpoints, and failure-mode diagnostics. The main deductions are inline time-sensitive version constraints that belong in a compatibility/deprecated note or referenced file, and a single external reference that leaves the skill's own bundle.
Suggestions
Move the version compatibility details (V1 pin, plugin 0.4.0 range, OpenCode >=2.0.32 <3) into a 'Compatibility' or deprecated-patterns section, or into the referenced diagnostics file, to reduce inline time-sensitive content.
Fold the unclear-query and capture-pending fallbacks into the numbered step sequence (e.g., a step 0 or explicit sub-step) so the main workflow reads as one linear flow.
Verify the `../memory-config/references/opencode.md` link resolves from this skill's installed location, or move the diagnostics content into this skill's own references/ directory.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and assumes competence, but the trailing paragraph carries time-sensitive version data ("V1 users pin the published `@zilliz/memsearch-opencode@0.3.17`. Plugin 0.4.0 supports OpenCode >=2.0.32 <3") that is not placed in a deprecated or compatibility section, which the guidelines explicitly penalize. This matches anchor 3 (mostly efficient with some content that could be tightened or relocated). | 3 / 5 |
Actionability | Guidance is fully concrete with exact tool names and parameter values: "Use `memory_search` with a concrete query and `top_k: 5`", "Use `memory_get` with the most promising `chunk_hash` values", and "use `memory_transcript` with `session_id`, `turn_id` and `db_path`... Set `context: 3`; for an anchor without a turn, use `limit: 10`", covering both common and edge cases. This matches anchor 5 for an instruction-only skill with executable-grade specificity. | 5 / 5 |
Workflow Clarity | A clear numbered 1-4 sequence with explicit checkpoints ("Evaluate relevance before expanding results", "inspect its text before selecting hashes") and an error-recovery branch for transcript lookup failures. It stops short of anchor 5 because the fallback behaviors (unclear query, capture-pending) sit outside the numbered flow, slightly blurring the main sequence. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines, organized under a clear ## Steps section, with exactly one well-signaled reference whose purpose and sharing are stated ("See [OpenCode diagnostics](../memory-config/references/opencode.md), also used by `memory-config`"). It falls short of anchor 5 because that single reference points outside the skill's own bundle (no references/ directory exists here), making it unverifiable and creating a cross-bundle dependency. | 4 / 5 |
Total | 16 / 20 Passed |