CtrlK
BlogDocsLog inGet started
Tessl Logo

1k-state-management

Jotai state management patterns — atoms, globalAtom, contextAtom, and persistence.

56

Quality

64%

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

Fix and improve this skill with Tessl

tessl review fix ./.skillshare/skills/1k-state-management/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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.

This is a well-structured, actionable skill: it enforces a mandatory file organization, gives explicit decision criteria for the two sanctioned atom patterns, and provides executable templates with real paths. The main weaknesses are mild redundancy across sections and a few implied steps (EAtomNames registration, actions.ts conventions) that a newcomer would have to reverse-engineer.

DimensionReasoningScore

Conciseness

The body is mostly tight — location lists, forbidden patterns, and code templates with no padding or explanation of what Jotai/React is — but locations are restated between the organization and selection sections, and the useAtom/useAtomValue/useSetAtom snippet is basic Jotai knowledge Claude already has.

4 / 5

Actionability

Copy-paste-ready templates for both globalAtom and contextAtom, with exact file paths and the directory layout for contexts, give concrete executable guidance; the gap that keeps it below a 5 is that registering a name in EAtomNames/atomNames.ts and the actions.ts convention are referenced but never shown.

4 / 5

Workflow Clarity

The core decision (globalAtom vs contextAtom) is governed by explicit, unambiguous criteria lists, and no destructive or batch operations require validation; it is not a 5 because the full create→register-name→export→wire-up sequence has implicit steps (e.g., the EAtomNames registration is never sequenced).

4 / 5

Progressive Disclosure

No bundle files exist and the ~90-line body is self-contained with clear section headers and appropriately inlined examples; it misses a 5 only because it exceeds the under-50-line simple-skill threshold while inlining content (e.g., usage examples) that could live in a reference file.

4 / 5

Total

16

/

20

Passed

Description

53%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.

The description names a distinct, well-scoped domain (Jotai state management in this codebase) with specific concepts, but it is a static noun phrase: it lists no actions and gives no guidance on when to invoke the skill. Adding an explicit trigger clause would move it from adequate to strong.

Suggestions

Add a 'Use when...' clause, e.g. 'Use when creating or modifying Jotai atoms, deciding between global and feature-scoped state, or adding persistent state in the OneKey codebase.'

Convert the noun list into concrete actions, e.g. 'Create and organize Jotai atoms using globalAtom and contextAtom, with persistence where needed.'

Include natural trigger variations users might say, such as 'React state', 'shared state', or 'atom store', to broaden keyword coverage.

DimensionReasoningScore

Specificity

"Jotai state management patterns — atoms, globalAtom, contextAtom, and persistence" names the domain plus four concrete concepts, but contains no actions (it is a noun phrase with no verbs), so it names topics rather than the concrete actions anchor 4 requires.

3 / 5

Completeness

The "what" is stated (patterns for atoms, globalAtom, contextAtom, and persistence) but there is no "Use when..." clause or equivalent trigger guidance, which per the judging guidelines caps completeness at 3; it is not a 2 because the "what" is concrete and multi-part.

3 / 5

Trigger Term Quality

"Jotai", "atoms", "state management", and "persistence" are relevant keywords a developer in this codebase would say, but common variations like "React state", "store", or "create an atom" are absent, matching the "some relevant keywords but missing common variations" anchor.

3 / 5

Distinctiveness Conflict Risk

"Jotai" carves out a clear niche with minimal conflict risk against unrelated skills; it falls short of anchor 5 only because a generic React-state-management skill could plausibly overlap on triggers like "state".

4 / 5

Total

13

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository
OneKeyHQ/app-monorepo
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.