Content
93%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 lean, well-structured instruction skill: an explicit session lifecycle, a concrete retrieval-tool decision guide, disciplined write guidance with a validated destructive path, and a precise peer-config section with copy-paste examples. The only improvement area is the absence of feedback loops (e.g., what to do when retrieval comes back empty or wrong beyond 'use search in default list mode').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Roughly 90 lines of dense operational guidance with no explanations of concepts Claude already knows; every sentence carries non-obvious decision information (lifecycle behavior, tool-selection rationale, write discipline, peer-derivation rules) and guardrails are stated tersely ("Never pass them to filesystem tools"). | 5 / 5 |
Actionability | Gives exact tool names with parameters (`search` with `mode="context"`), a copy-paste JSON config for pinning a peer, an exact environment variable (OPENVIKING_PEER_ID), and exact config keys with an explicit 'do not invent other keys' boundary — fully actionable for an instruction-only skill. | 5 / 5 |
Workflow Clarity | The session lifecycle is an explicit four-step sequence with checkpoints (check injected context before searching; expand hits with `read` before relying on them), and the destructive `forget` operation includes validation ('Confirm with the user and pass the exact URI; never delete from a fuzzy match'). It falls short of anchor 5 only because there are no error-recovery feedback loops for the retrieval workflow. | 4 / 5 |
Progressive Disclosure | A well-sectioned overview where advanced material is deferred one level deep via clearly signaled references (the `openviking-skills` skill, the `ov-experience-memory` skill, and external doc URLs for CLI setup and the full documentation index), while everything inlined is decision-critical for normal use. | 5 / 5 |
Total | 19 / 20 Passed |