CtrlK
BlogDocsLog inGet started
Tessl Logo

xstate

XState Store adapter for json-render's StateStore interface. Use when integrating json-render with @xstate/store for state management via @json-render/xstate.

74

Quality

91%

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

100%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 model of a minimal adapter skill: complete executable example, precise option table, numbered integration steps, and no wasted tokens. There is nothing to trim and nothing materially missing for the skill's single purpose.

DimensionReasoningScore

Conciseness

The ~40-line body is lean with zero padding: an install command, a version requirement, one complete example, and a one-row API table. No concept Claude already knows is explained, matching the 'every token earns its place' anchor rather than the level-4 'minor instances of over-explanation'.

5 / 5

Actionability

The usage example is fully executable and copy-paste ready (imports, createAtom, xstateStoreStateStore, StateProvider) and covers the common case end-to-end, with a concrete option table. This matches the top anchor; there are no gaps that would place it at level 4.

5 / 5

Workflow Clarity

The integration steps are explicitly numbered ('1. Create an atom', '2. Create the json-render StateStore adapter', '3. Use it') with no ambiguity. This is a simple, single-purpose, non-destructive skill, so per the rubric's simple-skill exception a clear unambiguous single action can score 5 without additional validation checkpoints.

5 / 5

Progressive Disclosure

The skill is under 50 lines, has no bundle files (references/, scripts/, assets/ do not exist), and needs none — the one option and one example fit comfortably in the body. Sections (Installation / Usage / API) are well-organized, which per the rubric's under-50-lines guideline merits the top score.

5 / 5

Total

20

/

20

Passed

Description

82%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 tight, third-person description that explicitly pairs a clear 'what' with a concrete 'Use when...' trigger in a well-delineated niche. Its only weakness is that it states the integration role without enumerating the concrete capabilities the adapter provides.

Suggestions

Enumerate one or two concrete capabilities of the adapter (e.g., 'reads, writes, and subscribes to json-render state through an @xstate/store atom') to raise specificity beyond a single generic action.

Add a natural-language trigger variation such as 'wire an xstate/store atom as the state backend for json-render' so users phrasing the need in implementation terms also match.

DimensionReasoningScore

Specificity

The description names the domain precisely ("XState Store adapter for json-render's StateStore interface") but states only one action — adapting/wiring — without listing what the adapter actually does (read, write, subscribe to state). This matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' and falls short of the level-4 anchor, which expects several specific actions.

3 / 5

Completeness

It explicitly answers both: what ('XState Store adapter for json-render's StateStore interface') and when ('Use when integrating json-render with @xstate/store for state management via @json-render/xstate'), with concrete trigger phrases. This is a direct match for the top anchor; the level-4 anchor ('when could be more explicit') does not apply since the when-clause is already explicit and specific.

5 / 5

Trigger Term Quality

Good keyword coverage: 'XState Store', '@xstate/store', 'state management', 'json-render', '@json-render/xstate' — the natural vocabulary for this integration. It is not a 5 because a few natural phrasings users might say (e.g., 'wire xstate to json-render', 'use xstate as the state backend') are missing, but it clearly exceeds the level-3 anchor's 'missing common variations'.

4 / 5

Distinctiveness Conflict Risk

The trigger is a highly specific package pairing (json-render + @xstate/store) that no other plausible skill would share, giving a clear niche with minimal conflict risk — matching the top anchor rather than the level-4 'minor overlap risk with closely related skills'.

5 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
vercel-labs/json-render
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.