CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

swr

SWR data-fetching expert guidance. Use when building React apps with client-side data fetching, caching, revalidation, mutations, optimistic UI, pagination, or infinite loading using the SWR library.

64

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

82%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A strong, lean API reference for SWR: copy-paste-ready code covers every major hook and configuration path, with clear section organization and no unnecessary explanation. The only improvements are minor — trimming the time-sensitive version pin and strategy explainer, and optionally splitting advanced topics into reference files.

DimensionReasoningScore

Conciseness

The body is lean — nearly every section is executable code with terse annotations and no padding of concepts Claude already knows. Minor trims remain: the 'stale-while-revalidate HTTP cache invalidation strategy' explainer and the time-sensitive version pin '(latest: 2.4.1)', which is penalized outside a deprecated/old-patterns section. This fits anchor 4 ('efficient; minor instances that could be trimmed'), not anchor 5.

4 / 5

Actionability

Every section provides fully executable, copy-paste-ready code: 'npm install swr', useSWR, useSWRMutation, useSWRInfinite, SWRConfig, optimistic-update options, conditional keys, onErrorRetry, and useSWRSubscription — covering the common cases exactly as the anchor-5 example requires. Not below 5: no pseudocode, no missing imports, no gaps in the main usage paths.

5 / 5

Workflow Clarity

This is a reference-style skill with no multi-step pipeline and no destructive or batch operations, so no validation checkpoints are required; sections are well-ordered from installation through core API, configuration, strategies, and advanced hooks, ending with 'Key Rules'. It fits anchor 4 ('clear, well-organized guidance') rather than anchor 5, whose sequence-with-explicit-validation pattern describes a multi-step workflow this skill does not have.

4 / 5

Progressive Disclosure

A single-file skill with no bundle files; content is organized under clear section headers with no buried or nested references, and the ~172-line body (mostly code) is a reasonable size to keep inline. It matches anchor 4 ('good structure; most content appropriately placed') rather than anchor 5, since some advanced sections (useSWRSubscription, error retry) could be split into separate reference files.

4 / 5

Total

17

/

20

Passed

Description

75%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A well-formed description with an explicit 'Use when...' clause, strong natural trigger terms, and clear SWR-specific anchoring. The main weakness is the vague 'expert guidance' framing of the 'what', which keeps specificity and completeness just below the top anchors.

Suggestions

Replace the generic 'SWR data-fetching expert guidance' opener with concrete actions the skill performs, e.g. 'Build data-fetching hooks with SWR: configure fetchers and cache revalidation, handle mutations and optimistic updates, implement pagination and infinite loading.'

Add the natural synonyms users actually type when they need this skill — 'stale-while-revalidate', 'useSWR', and 'React data fetching' — to broaden trigger coverage to the anchor-5 level.

Optionally note what the skill is distinct from (e.g. 'for SWR specifically, not TanStack Query or React Query') to reduce overlap risk with sibling data-fetching skills.

DimensionReasoningScore

Specificity

The description enumerates seven concrete capability areas ('client-side data fetching, caching, revalidation, mutations, optimistic UI, pagination, or infinite loading'), matching the 'lists several specific actions; minor gaps' anchor. It falls short of anchor 5 because the 'what' is framed as 'expert guidance' rather than naming the concrete actions the skill performs.

4 / 5

Completeness

Both halves are present: an explicit trigger clause ('Use when building React apps with... using the SWR library') and a 'what' ('SWR data-fetching expert guidance'). It sits below anchor 5 because the 'what' is slightly generic ('expert guidance') compared to the concrete-action pattern in the anchor-5 example.

4 / 5

Trigger Term Quality

Good keyword coverage with natural user terms: 'SWR', 'React apps', 'data fetching', 'caching', 'revalidation', 'mutations', 'optimistic UI', 'pagination', 'infinite loading'. Missing a few natural synonyms such as 'stale-while-revalidate' or 'useSWR', so it fits anchor 4 rather than the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

The description is firmly anchored to 'the SWR library', giving it a clear niche with distinct triggers (anchor 4). Minor overlap risk remains with generic React data-fetching or TanStack Query skills through shared terms like 'data fetching' and 'caching'.

4 / 5

Total

16

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

openai/plugins

Path

plugins/vercel/skills/swr/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.