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 instruction-only skill: lean, specific to its memory system, with a clear sequenced workflow and an honesty checkpoint. The only improvement space is making bank identification fully concrete (naming this Bot's bank and how to list the user's other banks).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 14-line body is lean with zero padding: "`recall` returns individual memories. `reflect` reads across them and answers the question, which is better for anything that needs a judgement over history" is system-specific knowledge Claude would not already have, and every remaining sentence instructs. This matches the anchor "Lean and efficient; assumes Claude's competence; every token earns its place". | 5 / 5 |
Actionability | "Call `reflect` with the user's question on the bank most likely to hold the answer: `grok-bot::shared` for things about the user or the team" gives a concrete command with a named bank, and steps 2-3 give concrete combining and honesty rules. It stops short of the 5 anchor because "this Bot's bank for its own work, or one of the user's other banks" leaves the reader without names or a way to discover the available banks - a minor gap versus fully executable guidance. | 4 / 5 |
Workflow Clarity | A simple, single-purpose skill under 50 lines with a clear three-step sequence (reflect on the likeliest bank, combine across banks when needed, answer directly with an honesty check). "If memory is thin or contradictory, say so rather than filling the gap" acts as an explicit checkpoint, and the non-destructive Q&A nature means no validation loop is required, so the simple-skill exception applies and the sequence is unambiguous. | 5 / 5 |
Progressive Disclosure | The skill has no bundle files and needs none: it is under 50 lines, self-contained, and organized into an orientation paragraph plus a "## Steps" section. Per the rubric guideline for short skills with no external-reference need, this matches the top anchor for well-organized structure. | 5 / 5 |
Total | 19 / 20 Passed |