Content
92%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.
An exemplary short skill body: lean, concrete, and unambiguous, with tool-specific semantics (scopes, defaults, run_id filtering) explained in minimal space. The only gap is the absence of a worked example of the tool call with arguments.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~18-line body is lean and every sentence carries non-obvious information (tool name, argument routing, scope semantics, run_id guard). It explains only tool-specific configuration Claude cannot know — e.g. "this repository's shared memory, which everyone who works in it contributes to" — not general concepts, matching the level-5 anchor 'lean and efficient; assumes Claude's competence; every token earns its place'. | 5 / 5 |
Actionability | Concrete instruction is given: "Call `search_memories` with the user's question", with explicit per-argument handling ("Treat `--top-k`, `--category`, `--scope`, and `--run-id` as tool arguments") and default behavior for each omitted argument. It falls short of level 5's copy-paste-ready examples because no example invocation (e.g. how a question plus arguments look in the actual call) is shown, but it clearly exceeds level 3's incomplete/pseudocode level. | 4 / 5 |
Workflow Clarity | This is a simple single-task skill and the single action is unambiguous: call the tool with the question, route flags as arguments, return the tool's result directly. Per the simple-skill exception, a single unambiguous action with no destructive or batch operations scores 5; there is nothing to sequence or validate. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, self-contained, and needs no external references — no references/, scripts/, or assets/ bundle exists and none is needed. Content is appropriately kept inline at this size, matching the guideline that short skills with well-organized, complete inline content score 5. | 5 / 5 |
Total | 19 / 20 Passed |