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

realtime-sync — скилл для Claude Code: что делает и как установить

Скилл realtime-sync помогает проектировать синхронизацию данных с низкой задержкой, связывать WebTransport, CRDT и пакетный рендеринг потоков ИИ-токенов.

MIT 108 установок ★ 29 обновлён 2026-08-17

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

Что делает realtime-sync

Скилл содержит архитектурные паттерны для организации многопользовательского взаимодействия с задержкой до 50 миллисекунд. Он помогает настроить двунаправленные потоки WebTransport на базе HTTP/3, сборку изменений через транзакционный outbox в базе данных и отслеживание последовательностей сообщений для восстановления после разрыва связи.

Внутри собраны правила работы с CRDT-библиотеками Yjs и Automerge без взаимных блокировок, включая курсоры через модуль y-protocols/awareness и выборочную отмену действий с Y.UndoManager. Для генеративных интерфейсов скилл задаёт батчинг токенов через requestAnimationFrame, чтобы избежать подвисаний React при частом рендеринге.

Корпоративные файрволы часто блокируют трафик UDP и HTTP/3, поэтому для надёжной работы потребуется фолбэк на WebSocket.

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

  • настроить двунаправленный обмен данными через WebTransport
  • устранить конфликты одновременного редактирования с помощью CRDT
  • пакетировать поток токенов нейросети для плавной отрисовки интерфейса
  • реализовать паттерн transactional outbox для синхронизации базы с клиентами

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

  • Спроектируй совместный текстовый редактор на Yjs с отслеживанием курсоров пользователей.
  • Настрой клиентский транспорт WebTransport с автоматическим переключением на WebSocket.
  • Сделай компонент вывода стриминга токенов с буферизацией через requestAnimationFrame.

Как установить realtime-sync

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill realtime-sync -a claude-code

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

~/.claude/skills/realtime-sync/SKILL.md

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

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

Вопросы о realtime-sync

Как установить realtime-sync в Claude Code?

Выполните в терминале команду npx skills add oakoss/agent-skills --skill realtime-sync -a claude-code.

Что делает скилл realtime-sync?

Он снабжает агента инструкциями по проектированию синхронизации в реальном времени, настройке протоколов WebTransport и WebSocket, а также интеграции CRDT и потокового вывода нейросетей.

Чем сериализовать данные в потоках с частотой выше 100 Гц?

Для высокочастотных потоков скилл рекомендует отказаться от JSON.stringify в пользу Protocol Buffers или MessagePack, чтобы снизить накладные расходы на сериализацию.

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

SKILL.md · MIT
---
name: realtime-sync
description: 'Low-latency synchronization with WebTransport, pub/sub messaging, CRDTs, and AI stream orchestration. Covers bidirectional streaming, transactional outbox patterns, sequence tracking, and collaborative editing. Use when building real-time collaborative UIs, implementing pub/sub messaging, handling WebTransport or WebSocket connections, orchestrating live AI token streams, or resolving conflicts with CRDTs.'
license: MIT
metadata:
  author: oakoss
  version: '1.1'
user-invocable: false
---

# Realtime Sync

## Overview

Architects high-concurrency, sub-50ms latency synchronization between distributed clients and servers. Covers WebTransport (HTTP/3) bidirectional streaming, transactional outbox patterns for database-to-sync consistency, CRDTs for collaborative editing, and AI token stream orchestration.

Core principles: the database is the source of truth (real-time channels notify, not persist), CRDTs eliminate locking for concurrent edits, and backpressure management prevents UI jitter from high-frequency streams.

**When to use:** Real-time collaborative UIs, pub/sub messaging, WebTransport/WebSocket connections, live AI token streams, presence tracking, conflict resolution with CRDTs, multiplayer applications.

**When NOT to use:** Batch processing pipelines, static content delivery, request-response APIs without real-time requirements, offline-only applications.

## Quick Reference

| Pattern               | Approach                                     | Key Points                                               |
| --------------------- | -------------------------------------------- | -------------------------------------------------------- |
| WebTransport          | `new WebTransport(url)` + `await ready`      | HTTP/3 multiplexed; replaces WebSockets for new projects |
| Bidirectional stream  | `transport.createBidirectionalStream()`      | Returns `{ readable, writable }` for request-response    |
| Unidirectional stream | `transport.createUnidirectionalStream()`     | Returns a `WritableStream` directly for one-way pushes   |
| Datagrams             | `transport.datagrams.writable`               | UDP-like unreliable delivery for high-frequency state    |
| Connection stats      | `transport.getStats()`                       | Returns `smoothedRtt`, `bytesSent`, `packetsLost`        |
| Transactional outbox  | DB write + outbox insert in one transaction  | CDC worker pushes to channel; prevents state drift       |
| Sequence tracking     | Sequence IDs on every message                | Rewind on reconnect to fetch missed messages             |
| CRDT collaboration    | Yjs (text) or Automerge (JSON state)         | Conflict-free concurrent editing without locks           |
| CRDT awareness        | `y-protocols/awareness` module               | Tracks cursors, selections, and user presence            |
| CRDT undo/redo        | `Y.UndoManager` with `trackedOrigins`        | Tracks only local user operations for selective undo     |
| Presence              | Heartbeat-based user tracking                | Epidemic broadcast for reliable zombie cleanup           |
| AI stream batching    | `requestAnimationFrame` for token rendering  | Prevents UI jitter from high-frequency updates           |
| Buffer-and-batch      | `useTransition` for sync-triggered updates   | Defers non-urgent re-renders during sync bursts          |
| Backpressure          | Buffer size limit with forced flush          | Prevents memory buildup when tokens outpace rendering    |
| WebSocket fallback    | Detect WebTransport support first            | Enterprise firewalls may block UDP/HTTP/3                |
| Serialization         | Protocol Buffers or MessagePack              | Avoid JSON.stringify on 100Hz+ streams                   |
| Web Worker transport  | Handle WebTransport in a Web Worker          | Prevents blocking the UI thread                          |
| Channel multiplexing  | Subscribe to multiple channels on one socket | All subscriptions share a single transport connection    |

## Common Mistakes

| Mistake                                                        | Correct Pattern                                                      |
| -------------------------------------------------------------- | -------------------------------------------------------------------- |
| Using real-time messages as the primary source of truth        | State lives in the database; real-time is the notification of change |
| Using JSON.stringify on high-frequency streams (100Hz+)        | Use Protocol Buffers or MessagePack for serialization                |
| Ignoring sequence drift when a client misses messages          | Implement Sequence IDs and a rewind mechanism on the client          |
| Implementing global locks for concurrent access                | Use Optimistic UI and CRDTs for conflict-free collaboration          |
| Sticking with WebSockets for new projects needing multiplexing | Use WebTransport (HTTP/3) for bidirectional, multiplexed streams     |
| CRDT document bloat from unbounded history                     | Use snapshotting (LWW) for fields that do not need history           |
| Failing to close WebTransport streams on unmount               | Explicitly close streams to prevent transport crashes                |
| Importing Awareness from `yjs` instead of `y-protocols`        | Use `import { Awareness } from 'y-protocols/awareness'`              |
| Using `ydoc.clientID` as UndoManager tracked origin            | Use custom transaction origins passed to `doc.transact()`            |
| One React re-render per AI token received                      | Batch tokens with `requestAnimationFrame` and flush once per frame   |
| Not handling WebTransport `closed` promise                     | Monitor `transport.closed` to detect unexpected disconnections       |

## Delegation

> If the `local-first` skill is available, delegate local-first architecture decisions, sync engine comparison, and client storage selection to it.
> If the `electricsql` skill is available, delegate ElectricSQL shape-based Postgres sync patterns to it.

- **Explore transport protocol options and latency benchmarks**: Use `Explore` agent to compare WebTransport, SSE, and WebSocket tradeoffs
- **Implement transactional outbox pattern with CDC pipeline**: Use `Task` agent to set up database triggers, outbox table, and background worker
- **Design real-time architecture for collaborative editing**: Use `Plan` agent to map CRDT strategy, presence management, and conflict resolution flow
- **Build multi-stream AI orchestration component**: Use `Task` agent to implement parallel token stream rendering with backpressure
- **Audit real-time connection lifecycle management**: Use `Review` agent to check for stream leaks, missing cleanup, and reconnection handling

## References

- [WebTransport streaming and worker patterns](references/webtransport.md)
- [Pub/sub messaging and guaranteed delivery](references/pubsub-delivery.md)
- [CRDTs and collaborative editing](references/crdt-collaboration.md)
- [AI stream orchestration patterns](references/ai-stream-orchestration.md)
- [Collaborative undo and redo patterns](references/undo-redo.md)

© oakoss · MIT · oakoss/agent-skills

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

Все скиллы по теме «Бэкенд и API» →
implementing-realtime-sync ancoleman Скилл implementing-realtime-sync помогает выбрать и настроить транспорт для передачи данных в реальном времени: стриминг токенов LLM, чаты, совместное редактирование через CRDT и офлайн-синхронизацию. CX Codex +1 1установок real-time-collaboration-engine curiositech Скилл real-time-collaboration-engine для Claude Code помогает проектировать совместное редактирование в реальном времени через WebSockets, OT или CRDT. Описывает синхронизацию редакторов, досок и курсоров. CX Codex +1 195установок trigger-realtime triggerdotdev Скилл trigger-realtime для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode — учит агента подключать клиентскую часть Trigger.dev к React-приложению. CX Codex +1 3 000установок inngest-realtime inngest Скилл inngest-realtime для Claude Code помогает передавать обновления Inngest workflow в интерфейс по мере выполнения. Используйте его для статуса заказов, потока токенов ИИ-агента или согласований с участием человека. CX Codex +1 881установок yjs-best-practices liveblocks Скилл yjs-best-practices подсказывает агенту, как не сломать синхронизацию Yjs: дубли импортов, поддокументы, YKeyValue и V2-кодирование. CX Codex +1 325установок neon-realtime neondatabase Скилл neon-realtime для Claude Code превращает SQL-запросы в живые подписки на изменения строк Lakebase Postgres. Передаёт изменения батчами для дашбордов, лент и синхронизации между устройствами. CX Codex +1 24 200установок

Из того же набора106

Весь набор →
electricsql Скилл для ИИ-кодинга по ElectricSQL: как стримить строки Postgres в клиент через Shapes, фильтровать их и не пускать запись мимо своего API. CX Codex +1 109установок trpc trpc — скилл для Claude Code, который помогает строить типобезопасные API на TypeScript с tRPC v11. Он подключается к задачам с роутерами, процедурами, React-клиентом и тестами. CX Codex +1 109установок tauri Помогает собирать приложения на Tauri v2 с веб-интерфейсом и бэкендом на Rust. Подключается при настройке проекта, IPC, разрешений или выпуска приложения. CX Codex +1 108установок turborepo Помогает настраивать Turborepo в монорепозиториях на JavaScript и TypeScript. Запускается при настройке задач, кэша, зависимостей между пакетами и CI. CX Codex +1 108установок plan-first-development Скилл plan-first-development для Claude Code помогает спланировать проект до начала разработки и вести прогресс между сессиями. Он включается при запуске проекта, крупных изменениях и разбиении работы на этапы. CX Codex +1 107установок tracer-bullets Скилл tracer-bullets для Claude Code разбивает многоуровневую разработку на вертикальные срезы. Каждый срез проверяется до начала следующего. CX Codex +1 107установок expert-instruction Скилл expert-instruction для Claude Code помогает проектировать системные инструкции для ИИ-агентов. Он включается при настройке роли агента, ограничений, формата ответов и работы с инструментами. CX Codex +1 106установок codebase-packager Скилл codebase-packager для Claude Code готовит контекст крупного репозитория для ИИ-кодинга. Он собирает дайджесты, упаковывает файлы и помогает проследить связи между ними. CX Codex +1 105установок

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

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