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.
An exemplary reference-style skill body: dense, executable code examples with wire-level comments, decision tables for hook and controller action selection, and a clean one-level-deep reference structure where every link resolves. The only gap is the absence of inline multi-step validation/feedback checkpoints, which is largely mitigated by routing debugging workflows to the dedicated devtools-debugging reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is code-first and lean: comments do double duty by documenting the wire request ("// GET https://jsonplaceholder.typicode.com/todos/5"), and the prose bullets carry only non-obvious guidance ("`undefined` from `useCache`... means 'not loaded yet', not 'doesn't exist'"). Nothing re-explains React or data-fetching basics Claude already knows; the "Before React 19" clause is a necessary version conditional, not padded dating. | 5 / 5 |
Actionability | Every section is copy-paste-ready executable TypeScript covering the common cases: reads, live subscriptions, parallel fetch with React.use(), all mutation shapes (ctrl.fetch for PUT/PATCH/DELETE, getList.unshift/push, getPage pagination), useLoading, useDebounce, AsyncBoundary, and Query aggregations — plus a decision table mapping refresh intents to exact ctrl.* calls. | 5 / 5 |
Workflow Clarity | Task routing is clear: hook-selection semantics (useCache/useQuery vs useSuspense/useDLE), waterfall-avoidance sequencing ("load 2+ endpoints with useFetch"), a refresh-vs-invalidate decision table, and explicit delegation to sibling skills ("apply the skill 'data-client-rest'"). It falls short of anchor 5 because no explicit multi-step workflow with inline validation or error-recovery checkpoints is present — those live in the referenced devtools-debugging file rather than in the body. | 4 / 5 |
Progressive Disclosure | A well-structured overview with inline links at point of use (AsyncBoundary, Controller, devtools-debugging) plus a cataloged References section giving one-line descriptions of every file; all 22 referenced paths resolve to real files, and reference files only cross-link siblings within the same directory, keeping disclosure one level deep and easy to navigate. | 5 / 5 |
Total | 19 / 20 Passed |