Content
67%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.
A strong, action-oriented skill body: executable, idiomatic TypeScript patterns with an excellent Do/Don't list and a concrete troubleshooting section. Its main costs are a conceptual "Why TanStack Query?" section that re-teaches library basics and a monolithic single-file layout where advanced SSR content could be split into references.
Suggestions
Delete or compress the "Why TanStack Query?" section — Claude already knows what the library does; keep only the "Rule of Thumb" line.
Define or stub the missing functions in examples (`updateTodoFn`, `fetchPostsServerSide`/`fetchPostsClientSide`) so every code block is fully copy-paste runnable.
Split the Next.js App Router SSR/hydration section into a references/ file, keeping a short inline summary with a clearly signaled link, to reduce SKILL.md body size.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly tight code-plus-one-line-framing, but the "Why TanStack Query?" section re-explains what the library does ("It handles caching, background updates, deduplication of multiple requests... out-of-the-box loading/error states") — knowledge Claude already has — and the intro paragraph pads with role-play phrasing ("You are a production-grade... expert. You master..."). This matches anchor 3: mostly efficient with some unnecessary explanation; not 4 because the conceptual section is a clear trim candidate, not a minor one. | 3 / 5 |
Actionability | Nearly all guidance is executable, commented TypeScript: the custom-hook useQuery example, query key factory, mutation with invalidation, provider setup, and HydrationBoundary prefetch flow are copy-paste ready. Minor gaps keep it from anchor 5: the optimistic-update example references an undefined `updateTodoFn`, the Next.js example uses undefined `fetchPostsServerSide`/`fetchPostsClientSide`, and the mutation's `res.json()` lacks the `res.ok` check used elsewhere. | 4 / 5 |
Workflow Clarity | The optimistic-updates section lays out an explicitly numbered sequence — cancel queries, snapshot, setQueryData, roll back in onError, always invalidate in onSettled — which is a genuine error-recovery feedback loop, and the Troubleshooting section maps concrete problems to fixes. Not anchor 5 because the skill is a pattern reference rather than a single end-to-end workflow, so there is no unified validate-before-proceed checklist across sections. | 4 / 5 |
Progressive Disclosure | The single-file body is organized into clear, well-labeled sections (hook pattern, query keys, mutations, Next.js, best practices, troubleshooting) with nothing buried — matching anchor 4's good structure with minor gaps. Not anchor 5 because there are no well-signaled external references; the ~70-line Next.js SSR hydration section and the full optimistic-update implementation could live in reference files to slim the SKILL.md overview. | 4 / 5 |
Total | 15 / 20 Passed |