Content
96%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 high-quality, actionable skill: domain-specific and concise, with copy-paste tool calls and clearly sequenced workflows that include explicit validation checkpoints for destructive and batch operations. Its only gap is progressive disclosure — a dense migration section could be split into a reference file for cleaner navigation.
Suggestions
Consider extracting the detailed 'Move local skills' classification rules (vendor prefixes, environment-bound conditions, clean-up-first flags) into a one-level-deep reference file (e.g. references/migration.md) with a clear pointer from SKILL.md to improve progressive disclosure.
The 'when a task looks like one a stored skill would cover' trigger in the description is broad; narrow it (e.g. to skill-authoring/install/migrate tasks) to reduce overlap risk with the openviking-memory skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — it explains only OpenViking-specific details Claude would not know (URI expansion, tool-name prefixes, add_skill semantics, zip-upload flow) with no concept padding, fitting the score-5 'every token earns its place' anchor rather than the minor-over-explanation anchor at 4. | 5 / 5 |
Actionability | Fully executable, copy-paste-ready guidance throughout: parameterized tool calls like find(query=..., context_type="skill") and add_skill(data=...), plus a complete zip/curl upload command, matching the score-5 anchor for copy-paste-ready code covering common cases. | 5 / 5 |
Workflow Clarity | Multi-step processes (Create, Install, Move local skills) are clearly sequenced with explicit validation checkpoints — confirm-before-replace, user-approves-upload, and a tree-based verify step — and a classify→confirm→upload→verify→remember checklist; because validation is present the destructive-ops cap does not apply, matching the score-5 anchor. | 5 / 5 |
Progressive Disclosure | Well-organized with clear section headers and no nested references, but the file is a single self-contained document (~125 lines) with a dense 'Move local skills' section whose classification rules could arguably live in a one-level-deep reference, fitting the score-4 'good structure, minor organization gaps' anchor better than the split-and-signaled anchor at 5. | 4 / 5 |
Total | 19 / 20 Passed |