Content
81%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 well-structured, actionable instruction skill with an explicit, validated multi-step workflow and error-recovery loops. It is slightly verbose in places and could move the legacy-server edge case to a reference file for leaner progressive disclosure.
Suggestions
Consolidate the repeated 'continue without Experience' caveats into a single Preconditions rule to reduce token redundancy (conciseness).
Move the 'Servers Without the Home Alias' legacy-server recovery detail into a separate reference file, leaving a one-line pointer in the main workflow (progressive_disclosure).
Add a short copy-pasteable example block showing the exact search call (tool name + target_uri + query + limit) for the most common runtime (actionability).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational, explaining OpenViking-specific mechanics (URIs, server versions) that Claude would not already know, but the phrase 'continue without Experience' and similar caveats recur several times and could be trimmed. | 4 / 5 |
Actionability | Provides concrete, actionable guidance — exact URIs ('viking://~/memories/experiences'), 'limit=5', per-runtime tool names in a table, error signature 'INVALID_URI (HTTP 400)', and a sample query — with only minor gaps in copy-paste-ready form. | 4 / 5 |
Workflow Clarity | The 8-step Retrieval Workflow is clearly sequenced with explicit validation ('Judge results by task, environment, preconditions, and likely effect; title similarity alone is insufficient'), a failure feedback loop (step 8: one focused follow-up search), and an error-recovery path for servers without the home alias. | 5 / 5 |
Progressive Disclosure | Well-organized into clearly headed sections with no nested references and no bundle files to navigate, but the version-specific 'Servers Without the Home Alias' edge case is inlined where a separate reference could keep the core workflow leaner. | 4 / 5 |
Total | 17 / 20 Passed |