К основному содержанию
скилл CX Codex

jotai · jotaijs — скилл для Claude Code: что делает и как установить

Скилл jotai для Claude Code помогает агенту писать, проверять и отлаживать состояние на базе Jotai в React или чистом TypeScript. Настраивает модели атомов, асинхронные данные и изоляцию сторов.

MIT 558 установок ★ 5 обновлён 2026-10-16

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add jotaijs/jotai-skills --skill jotai -a claude-code
Открыть на GitHub

Что делает jotai

Скилл задаёт архитектурные правила работы с Jotai версии 3.0.1 и 2.20.x. Агент учится определять владельцев состояния, выбирать минимально необходимые изменения и использовать неизменяемые обновления объектов. Инструкции запрещают мутировать значения в обход Object.is и требуют сохранять стабильные ссылки на конфигурации атомов между рендерами.

Внутри заложена маршрутизация по файлам-справочникам. При запросах на оптимизацию рендеринга или работу с большими списками ИИ обращается к references/performance-and-large-state.md. Для миграции с версии 2 на 3 используется отдельный документ с описанием удалённых API и новых требований к ESM-пакетам.

Перед генерацией кода агент обязан проверить установленные в проекте версии пакета Jotai и его расширений. Скилл требует строго разделять операции: использовать useAtomValue для чтения, useSetAtom для записи и изолировать состояние на сервере при SSR.

Какие задачи решает

  • спроектировать границы атомов и производные значения
  • настроить асинхронное чтение и Suspense
  • мигрировать кодовую базу с Jotai v2 на v3
  • оптимизировать производительность подписок через selectAtom

Примеры запросов агенту

  • Переведи этот компонент на Jotai, выделив экшены в отдельные атомы.
  • Настрой SSR-гидратацию для стора по документации из react-usage.md.
  • Обнови код с Jotai v2 до v3, проверь совместимость утилит.

Как установить jotai

1Через Skills CLI (Vercel)

npx skills add jotaijs/jotai-skills --skill jotai -a claude-code

2Вручную: положить файлы

~/.claude/skills/jotai/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/jotai/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о jotai

Как установить jotai в Claude Code?

Выполните команду npx skills add jotaijs/jotai-skills --skill jotai -a claude-code.

Что делает скилл jotai?

Он передаёт ИИ-агенту архитектурные правила и справочники для правильного использования Jotai в React-приложениях.

Какие версии поддерживает скилл?

Базовые инструкции написаны для Jotai 3.0.1. Они также покрывают отличия версии 2.20.x.

Исходный текст

SKILL.md · MIT
---
name: jotai
description: Build, review, and debug Jotai state in React or vanilla TypeScript. Use for atom modeling, async state, store isolation and hydration, subscription performance, Jotai utilities and extensions, or v2-to-v3 migration.
---

# Jotai

## Overview

Use Jotai v3 as the baseline for new code. For existing projects, inspect the installed Jotai and extension versions before giving version-sensitive advice. Preserve the requested behavior, architecture, and dependency choices; use refactoring guidance only where it serves the task.

## Workflow

- Identify state ownership, the store used by each reader and writer, atom identity, async behavior, and relevant tests before changing code.
- Choose the smallest change that satisfies the request. Derive computed values, separate independently updated state when useful, and use named action atoms when commands benefit from a shared update path.
- Verify the behavior at the appropriate level: vanilla store tests for state logic and isolation, component tests for subscriptions and user interactions. Match the existing test setup when practical.

## Core Invariants

- Atom configs identify state by reference; values belong to a store. Keep atom configs stable across renders and use the same store for all participants in a state flow.
- Replace object and array values immutably. Jotai uses `Object.is` to detect value changes; mutating a value and setting the same reference can suppress updates.
- Read-function `get` tracks dependencies; write-function `get` reads without establishing a reactive subscription. Keep reads free of unrelated side effects.
- Use `useAtomValue` for reads, `useSetAtom` for writes, and `useAtom` for both. Use vanilla `get`/`set`/`sub` for imperative integrations; a read alone does not mount an atom.
- Keep initialization and subscription lifetimes explicit. `onMount` follows atom subscriptions, not module loading or setter calls. Isolate request-owned state on the server.
- Prefer plain atom composition before utilities. Add utilities or extensions when they encode the required semantics more clearly, checking compatibility with the installed major version.

## Reference Routing

Read only the files that match the task:

- `references/atom-modeling.md` for deciding atom boundaries, derived atoms, action atoms, writable adapters, resets, storage, and family-style parameterized atoms.
- `references/react-usage.md` for hook selection, Provider/store scope, vanilla integrations, SSR, hydration, dynamic atom creation, and component architecture.
- `references/async-and-side-effects.md` for Suspense, async reads, async actions, abort signals, non-Suspense states, refresh flows, and external side effects.
- `references/performance-and-large-state.md` for render tuning, `selectAtom`, `focusAtom`, `splitAtom`, large objects, lists, and dependency graph depth.
- `references/typescript-and-testing.md` for TypeScript inference, writable atom argument types, `ExtractAtomValue`, and testing strategy.
- `references/utilities-decision-guide.md` for choosing built-in utilities such as storage, SSR hydration, resettable/default atoms, lazy atoms, callbacks, reducers, select, split, and family migration.
- `references/extensions-decision-guide.md` for choosing extension packages such as TanStack Query, optics, Immer, effects, location, scope, cache, XState, GraphQL/RPC, and external-store bridges.
- `references/tools-and-debugging.md` for choosing Devtools, Babel, SWC, and Rolldown support for debugging, labels, React Refresh, and bundler integration.
- `references/recipes-decision-guide.md` for deciding when to use or adapt official recipes such as debounce, listeners, broadcast, compare, toggle, custom hooks, reducer hooks, and atom effects.
- `references/version-migration.md` for migrating from v2 to v3: raised React/TypeScript/Node requirements, ESM-only packaging, removed APIs and their replacements, and changes to `jotai/vanilla/internals`.

## Compatibility And Source Verification

This revision was written against Jotai 3.0.1, and covers Jotai 2.20.x where the two differ. Before giving version-sensitive API guidance, determine the target project's installed Jotai and extension-package versions, then inspect their exported types, source, or matching documentation and tests. Do not assume current documentation matches the installed version.

© jotaijs · MIT · jotaijs/jotai-skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →

Сначала — jotai от других авторов.

jotai vercel-labs Подключает Jotai как бэкенд состояния к интерфейсу StateStore библиотеки json-render. Атом Jotai становится единственным источником состояния для рендера JSON-описаний UI. CX Codex +1 1 200установок zustand pproenca С 43 правилами по Zustand: архитектура сторов, селекторы, предотвращение лишних ре-рендеров. Подключается при написании или рефакторинге стора. CX Codex +1 463установок pinia Anthony Fu Загружает документацию Pinia v4.0.3 прямо в контекст агента. Агент начинает правильно определять сторы, работать с storeToRefs() и настраивать SSR-гидратацию. CX Codex +1 20 600установок pinia-skilld skilld-dev Скилл pinia-skilld для ИИ-агентов, который подсказывает верные API Pinia 4.x: хранилища, геттеры, действия, SSR и миграцию с v2 и v3. CX Codex +1 349установок frontend-patterns affaan-m Скилл frontend-patterns подсказывает паттерны для React и Next.js: компоненты, состояние, загрузка данных и производительность. Нужен при разработке и ревью интерфейса. CX Codex +1 7 900установок dynamic-import patterns.dev Обучает агента разделять бандл через dynamic import(). Скилл помогает отложить загрузку тяжёлых библиотек и диалогов до действий пользователя. CX Codex +1 1 700установок zustand-state-management Mindrally Скилл zustand-state-management задаёт правила архитектуры сторов Zustand в React и TypeScript: от нарезки слайсов до SSR и тестов. Помогает избежать лишних ререндеров и ошибок гидратации. CX Codex +1 1 000установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой