Content
93%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.
This is an exemplary minimal redirect skill: lean, fully actionable, with exact commands and URLs for both the replacement-install and already-installed paths. The only meaningful gap is that the destructive cleanup instruction ("Delete this folder after you switch") relies on an implicit rather than explicit validation of the switch.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is roughly ten lines where every sentence instructs ("Use `convex-agent` (official Convex) instead. Tell the user this, then load the replacement if it is installed.") with zero padding or explanation of concepts Claude already knows. The pinned old-content URL is properly framed as a deprecated pointer, so the time-sensitivity penalty does not apply — matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | The guidance is fully executable: an exact install command ("npx skills add convex/agent-skills --skill convex-agent"), a one-step setup URL ("read and follow https://www.convex.dev/agent-setup.md"), the replacement's exact name, and explicit behavioral instructions for both the installed and not-installed cases. This matches the 'copy-paste ready commands covering the common cases' anchor. | 5 / 5 |
Workflow Clarity | The sequence is clear for a single-purpose redirect skill: tell the user it moved, load or install the replacement, then "Delete this folder after you switch". It scores 4 rather than 5 because the destructive delete step is gated only by the implicit "after you switch" condition — a checkpoint is present but never made explicit (no instruction on how to confirm the switch succeeded), which is a minor validation gap. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with no content that belongs in separate files, so per the simple-skill guidance well-organized sections suffice; the two external links (install docs, old-content archive) are one level deep and clearly labeled. The bundled assets (large-logo.png, small-logo.svg) are branding files, not content references, so they create no navigation burden. | 5 / 5 |
Total | 19 / 20 Passed |