Content
75%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 highly actionable, well-structured reference with copy-paste examples across SWR's API surface. Main weakness is conciseness: a hard-coded version number and some explanatory padding that Claude does not need.
Suggestions
Remove the hard-coded version number ('latest: 2.4.1') or move it to a dedicated version/deprecated section so the skill does not go stale.
Trim the 'You are an expert in SWR v2...' opener and the stale-while-revalidate concept definition; assume Claude knows the caching strategy.
Consider splitting the full subscription/error-retry reference into a referenced file if the skill grows, to keep SKILL.md a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with copy-paste examples, but includes stale time-sensitive info ('latest: 2.4.1'), an 'You are an expert' framing line, and a stale-while-revalidate concept explanation Claude already knows. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready code covering the common cases (useSWR, mutation, infinite, subscription, optimistic updates, error retry) with concrete options and return values. | 5 / 5 |
Workflow Clarity | Well-organized into clear per-API sections with a 'Key Rules' guardrails list; no destructive/batch workflow so no validation cap applies, though there is no explicit multi-step sequence with checkpoints. | 4 / 5 |
Progressive Disclosure | Single self-contained file with clear section headers and a navigation-like structure; no bundle files exist, and the inline reference content is reasonably scoped for a focused library skill. | 4 / 5 |
Total | 16 / 20 Passed |