Content
86%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 model of a retirement tombstone: minimal, unambiguous about the replacement, and provides an executable install command plus concrete follow-up URLs. Main minor gap is the implicit handling of the 'replacement already installed' branch and the loosely sequenced cleanup instruction. Structure is appropriately flat with no unnecessary bundle files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~12-line body is lean with every line actionable: the redirect instruction, a copy-paste install command, two URLs, and a cleanup note, with no explanation of concepts Claude already knows. This matches the 'every token earns its place' anchor; the time-sensitive details (version pin, old-content URL) are confined to a deprecation-style pointer rather than padded explanation. | 5 / 5 |
Actionability | Concrete, copy-paste-ready guidance is present: "npx skills add convex/agent-skills --skill convex-design" and a specific agent-setup URL, plus a clear instruction to tell the user. It falls short of 5 because "load the replacement if it is installed" leaves the installed-vs-not check implicit, and the follow-up flow (tell user, load, install) is not fully laid out in one unambiguous sequence. | 4 / 5 |
Workflow Clarity | For this simple single-purpose skill the action sequence is clear: tell the user it moved, use convex-design, install it via the given command if needed. It is not 5 because the conditional ordering (load if installed, then install instructions) could be merged into one explicit step sequence, and the "Delete this folder after you switch" cleanup step is stated without any sequencing context. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with no need for external reference files (no references/ or scripts/ exist), and the body is well organized: heading, redirect statement, install command, setup link, and old-content pointer. Per the rubric's simple-skill guideline, this earns the top score; external URLs are one level deep and clearly signaled. | 5 / 5 |
Total | 18 / 20 Passed |