Content
87%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 redirect skill body: minimal, fully executable, and correctly structured for a tombstone. The single weakness is the destructive cleanup instruction ("Delete this folder after you switch") lacking an explicit verification step, which caps workflow clarity.
Suggestions
Add an explicit verification checkpoint before the destructive step, e.g. "Only delete this folder after confirming convex-design is installed and loads successfully".
Make the "if it is installed" check concrete — specify how to determine whether the replacement skill is present (e.g., check the installed skills list) before choosing between loading and installing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~10 lean lines with zero concept explanation: "This skill moved. Use `convex-design` (official Convex) instead." plus an install command, one alternative URL, an archive link, and a cleanup note. Every token earns its place and the skill assumes Claude's competence throughout. | 5 / 5 |
Actionability | Fully executable guidance: the copy-paste-ready command "npx skills add convex/agent-skills --skill convex-design", a direct instruction to "Tell the user this, then load the replacement if it is installed", a followable URL (convex.dev/agent-setup.md), and a pinned archive URL. All common cases (replacement installed vs. not) are covered. | 5 / 5 |
Workflow Clarity | The sequence is clear for a simple skill (tell the user → load or install the replacement → delete the folder), but the destructive step "Delete this folder after you switch" has only an implicit checkpoint and no verification that the switch actually succeeded. Per the rubric, a workflow with a destructive operation and no validation cannot score above 3, taking precedence over the simple-skill exception. Not 2 because the steps that are present are specific and coherent. | 3 / 5 |
Progressive Disclosure | Under 50 lines, single-purpose, with no need for external reference files — the body is well organized into a heading, redirect statement, install command, and archive pointer. No references/ or scripts/ files exist and none are needed; the assets/ folder contains only logo files, so there are no broken or buried references. | 5 / 5 |
Total | 18 / 20 Passed |