Content
88%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 highly actionable, well-sequenced router skill: exact commands at every step, explicit verify gates, and built-in error recovery for the common failure modes. The weaknesses are modest — repetitive emphasis around the fixed report template and bundle files (scripts/db.py, assets/) that the skill never references.
Suggestions
Collapse the repeated exact-template instructions in Step 3 into a single statement (e.g., 'reproduce word for word, changing only the <...> placeholders') to save tokens without losing compliance emphasis.
Reference or remove the unreferenced bundle files: scripts/db.py and the assets/ images are never mentioned in SKILL.md, so either link them where relevant or drop them from the skill bundle so it contains only material the routing instructions use.
State explicitly that the uninstall guide also ends with verify gates (mirroring 'every part ends with a verify gate' for install), so the destructive path's validation is asserted rather than implied.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and actionable with no background-concept explanations and a tight host table, but Step 3's report-template section repeats its exactness demand multiple ways ('This is a fixed template, not a prompt for inspiration: reproduce it word for word. Do not paraphrase it, reorder its sentences, summarize it, translate it, or "improve" the wording — a correct install ends with these exact words'). Fits anchor 4's minor over-explanation better than anchor 3's broader slack or anchor 5's fully lean text. | 4 / 5 |
Actionability | Every step ships an exact, resolvable command: 'pip install --upgrade memu-cli', 'uv tool install --upgrade memu-cli', 'memu-agent detect', '<your-binary> init --cloud-api-key <the user's memU key>', '<your-binary> docs install', and '<your-binary> retrieve "When did the user register for memU?"'. Placeholders are resolved by the host table, and common edge cases (uv-only machines, no API key, unknown host, stale build) are each handled concretely. | 5 / 5 |
Workflow Clarity | A clearly sequenced three-step flow with explicit checkpoints and feedback loops: the Codex sandbox precheck, 'every part ends with a verify gate; do not proceed past a failing one', the stale-build recovery loop ('you are on a stale build: upgrade, then re-run the command that failed'), and the final retrieve verification. The destructive uninstall path routes through the same gated guide structure rather than proceeding unvalidated, so the destructive-operation cap does not apply. | 5 / 5 |
Progressive Disclosure | A well-sectioned overview that defers detail exactly one level to the packaged '<your-binary> docs install' guide, which is clearly signaled and always in sync with the installed code. However, scoring against the actual bundle: 'scripts/db.py' and the 'assets/' images exist in the skill bundle but are never referenced or navigable from SKILL.md, an orphaned-content gap that fits anchor 4 rather than anchor 5's easy navigation. | 4 / 5 |
Total | 18 / 20 Passed |