reatom

Original：🇺🇸 English

Translated

Implements and documents Reatom v1001 (@reatom/core) using project conventions. Use when writing or modifying Reatom models, actions, async flows, routing, forms, persistence, framework adapters, examples, or docs — or when answering Reatom API questions.

1installs

Sourcereatom/reatom

Added on2026-08-26

NPX Install

npx skill4agent add reatom/reatom reatom

SKILL.md Content

View Translation Comparison →

Reatom

Use this skill when implementing or explaining Reatom v1001. Treat REFERENCE.md as the canonical API reference bundled with this skill.

How to use

Read the sections of REFERENCE.md that match the task — do not load generic React/Solid/Vue state patterns when they conflict with the reference.
Follow existing code in the touched package or example for naming, file layout, and extension style.
For deep async flows (
```
wrap
```
,
```
withAsyncData
```
,
```
withAbort
```
, sampling, Suspense), switch to the
```
reatom-async
```
skill.
For
```
@reatom/jsx
```
(native DOM JSX, mount, props, css prop), switch to the
```
reatom-jsx
```
skill.
For pull requests, reviews, or skeptic validation of agent output, switch to the
```
reatom-review
```
skill.

Section map

Use this map to open only the relevant parts of REFERENCE.md:

Topic	Section
Atoms, computed, action, effect, extend	Core primitives and mental model
Queries and mutations	withAsync
Async context after await / callbacks	wrap rules
Collections, boolean, route helpers	Primitives quick usage
Nested reactive fields	Atomization
Subscribe error callback	Subscribe error listener
Logging, log.label, log.state	Full SPA example (logging setup)
Hooks, connect/disconnect, lazy work	Lifecycle and extension hooks
DOM / external events	Event sampling and orchestration
Hot derivations	Memoization: memo and memoKey
Fields and validation	Forms: base usage and reactive validation
SPA routes and loaders	Routing
Search params, storage	URL sync and persistence helpers
React Suspense integration	Suspense notes
Batched updates	Transactions notes
Tests and SSR	SSR and testing
Upgrades from older Reatom	v3 migration highlights

Deeper recipes and adapter docs live on v1001.reatom.dev under

/docs/handbook/*

and

/docs/reference/*

.

Implementation defaults

Named atoms, actions, computed values, and effects; factory names use the
```
reatom*
```
prefix.
Reads: zero-arg call. Writes:
```
.set(...)
```
.

Idempotent reads:

computed(async () => ...).extend(withAsyncData(...))

.

Commands/mutations:

action(async () => ...).extend(withAsync(...))

.

Async boundaries that leave the Reatom frame:
```
await wrap(promise)
```
; external callbacks: pass
```
wrap(fn)
```
.
Derived state in
```
computed
```
; side effects in
```
effect
```
with explicit lifetime (route loader, init action, or mount scope — not unscoped module effects for feature work).
Forms (fields, validation, submit) through
```
reatomForm
```
/
```
reatomField
```
instead of hand-rolled per-field atoms and submit actions.
Route data through
```
reatomRoute
```
loaders; navigation with
```
.go(...)
```
, links with
```
.path(...)
```
.

When the reference and local examples disagree, prefer the reference and fix the example if it is wrong.