Content
92%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 code-skill body: a fully executable worked skeleton, boundary rules stated with rationale, an ordered validation sequence with failure handling, and clean one-level-deep reference splitting. The only notable flaw is the duplicated app-wrapper code between the Component Skeleton and the Patterns section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and task-specific with no explanation of concepts Claude already knows, and every rule carries a because-clause instead of padding. It is not 5 because the "Client-facing API" pattern repeats the sendNotification wrapper code already shown in the Component Skeleton, and the Patterns section partly restates the Critical Rules. | 4 / 5 |
Actionability | The Component Skeleton provides complete, copy-paste-ready code across five files (component config, schema, functions, app config, app wrapper), plus exact commands like "npx convex codegen --component-dir convex/components/<name>" and "npx convex dev". Concrete bad/good code pairs cover the common boundary pitfalls, fully covering the default local case. | 5 / 5 |
Workflow Clarity | The ten-step workflow is clearly sequenced with a validation ordering (component-dir codegen, then codegen, then dev) and explicit error recovery ("If validation blocks on Convex login or deployment setup, stop and ask the user for that exact step instead of guessing"), plus a fix-issues-before-finishing feedback loop and a closing checklist. This matches the anchor for clear sequence with explicit validation and feedback loops. | 5 / 5 |
Progressive Disclosure | The SKILL.md is a genuine overview: the default local flow and its skeleton live inline, while shape-specific detail is split into four real one-level-deep reference files (local-components.md, packaged-components.md, hybrid-components.md, advanced-patterns.md), all of which exist in the bundle. References are well signaled via the shape decision table, "Read exactly one reference file", the Reference Files section, and the Advanced Patterns pointer, with no nested references. | 5 / 5 |
Total | 19 / 20 Passed |