Content
76%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 tombstone body is a model of token efficiency and gives a concrete install command plus clear redirect instructions. Its main flaws are a vague "load the replacement if installed" step and a destructive cleanup instruction ("Delete this folder") with no verification checkpoint, plus orphaned asset files in the bundle.
Suggestions
Add a verification checkpoint before the destructive step, e.g., "Only after confirming convex-design loads successfully, delete this folder."
Specify how to load the replacement when it is already installed (e.g., the expected skill path or invocation) so the "load" step is executable.
Remove or reference the unused assets/large-logo.png and assets/small-logo.svg so the bundle contains only files the skill actually uses.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is 12 lean lines — "This skill moved. Use `convex-design` (official Convex) instead" — with zero padding and no explanation of concepts Claude already knows; every token earns its place. | 5 / 5 |
Actionability | It provides a copy-paste-ready command ("npx skills add convex/agent-skills --skill convex-design") and a followable URL, but "load the replacement if it is installed" omits how to locate or load it, a minor gap that fits the 'mostly executable with minor gaps' anchor rather than fully copy-paste-ready level 5. | 4 / 5 |
Workflow Clarity | The redirect sequence (tell the user, then load or install the replacement) is clear, but "Delete this folder after you switch" is a destructive step with no verification checkpoint (e.g., confirm the replacement is installed and working first), so the destructive-operation cap holds workflow clarity at 3. | 3 / 5 |
Progressive Disclosure | For an under-50-line single-purpose skill the body is well organized with a clear heading and one-level-deep external links, but the bundle's assets (large-logo.png, small-logo.svg) are orphaned — referenced nowhere in the body — a minor organization gap that keeps it below the top anchor. | 4 / 5 |
Total | 16 / 20 Passed |