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

websocket-streaming — скилл для Claude Code: установка

Скилл websocket-streaming для Claude Code настраивает двусторонний обмен данными по WebSocket между DAG-движком и дашбордом. Передаёт события выполнения и живое состояние графа.

MIT 152 установок ★ 274 обновлён 2026-10-30

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

Что делает websocket-streaming

Скилл описывает протокол событий между движком выполнения DAG и визуализацией. Сервер передаёт изменения узлов, активные рёбра, стоимость, завершение выполнения и запросы решения человека. Клиент может поставить выполнение на паузу, продолжить или отменить его.

Внутри есть типы ServerEvent и ClientEvent, React-хук useDAGStream и пример сервера на Node.js с комнатами для каждого DAG. Хук обновляет локальное хранилище и переподключается с экспоненциальной задержкой до 30s. Без логики переподключения дашборд будет показывать устаревшее состояние.

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

  • передавать изменения узлов DAG в дашборд
  • отправлять решения человека движку выполнения
  • показывать стоимость и прогресс выполнения в реальном времени
  • возобновлять WebSocket-соединение после разрыва

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

  • Настрой поток состояния DAG через WebSocket и добавь переподключение с задержкой до 30s.
  • Создай типизированные события для изменения узлов, стоимости и завершения выполнения.
  • Добавь в React дашборд хук useDAGStream с паузой, продолжением и отменой выполнения.

Как установить websocket-streaming

1Через Skills CLI (Vercel)

npx skills add curiositech/some_claude_skills --skill websocket-streaming -a claude-code

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

~/.claude/skills/websocket-streaming/SKILL.md

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

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

Вопросы о websocket-streaming

Как установить websocket-streaming в Claude Code?

Выполните npx skills add curiositech/some_claude_skills --skill websocket-streaming -a claude-code, затем проверьте файл ~/.claude/skills/websocket-streaming/SKILL.md.

Что делает websocket-streaming?

Скилл помогает связать DAG-движок с визуальным дашбордом через двусторонний WebSocket-канал. Он задаёт типы событий, React-хук и серверную рассылку по комнатам DAG.

Как скилл восстанавливает соединение?

useDAGStream повторяет подключение с экспоненциальной задержкой, которая растёт до 30s. При новом соединении счётчик попыток сбрасывается.

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

SKILL.md · MIT
---
name: websocket-streaming
description: Implements real-time bidirectional communication between DAG execution engines and visualization dashboards via WebSocket. Covers connection management, typed event protocols, reconnection
  with backoff, and React hook integration. Activate on "WebSocket", "real-time updates", "live streaming", "execution events", "state streaming", "push notifications". NOT for HTTP REST APIs, server-sent
  events (SSE), or general networking.
allowed-tools: Read,Write,Edit,Bash
metadata:
  category: DevOps & Site Reliability
  tags:
  - websocket
  - streaming
  - real-time-updates
  - live-streaming
  pairs-with:
  - skill: reactflow-expert
    reason: WebSocket connections deliver live DAG state updates to ReactFlow visualization dashboards
  - skill: real-time-collaboration-engine
    reason: WebSocket transport powers the real-time communication layer for collaborative editing
  - skill: llm-streaming-response-handler
    reason: WebSocket is an alternative transport to SSE for bidirectional LLM streaming
---

# WebSocket Streaming

Real-time bidirectional communication between DAG execution engines and dashboards. Typed event protocols, connection management, and React hook integration.

---

## When to Use

✅ **Use for**:
- Streaming DAG node state changes to a visualization dashboard
- Sending human gate decisions from dashboard to execution engine
- Live cost ticker and progress updates during execution
- Bi-directional communication (not just server → client)

❌ **NOT for**:
- One-way server → client updates (consider SSE, simpler)
- REST API design (use `api-architect`)
- Polling-based status checks (WebSocket replaces polling)

---

## Event Protocol

### Server → Client Events

```typescript
type ServerEvent =
  | { type: 'node_state'; node_id: string; status: NodeStatus; output?: any; metrics?: NodeMetrics }
  | { type: 'edge_active'; from: string; to: string }
  | { type: 'dag_mutated'; mutation: DAGMutation }
  | { type: 'cost_update'; spent: number; budget: number; remaining: number }
  | { type: 'execution_complete'; results: Record<string, any> }
  | { type: 'human_gate_waiting'; node_id: string; presentation: GatePresentation }
  | { type: 'error'; node_id?: string; message: string };
```

### Client → Server Events

```typescript
type ClientEvent =
  | { type: 'human_decision'; node_id: string; decision: 'approve' | 'reject' | 'modify'; feedback?: string }
  | { type: 'pause_execution' }
  | { type: 'resume_execution' }
  | { type: 'cancel_execution' };
```

---

## React Hook: useDAGStream

```typescript
import { useEffect, useRef, useCallback } from 'react';

export function useDAGStream(dagId: string, store: DAGStore) {
  const wsRef = useRef<WebSocket | null>(null);
  const reconnectAttempt = useRef(0);

  const connect = useCallback(() => {
    const ws = new WebSocket(`/api/dags/${dagId}/stream`);

    ws.onopen = () => { reconnectAttempt.current = 0; };

    ws.onmessage = (event) => {
      const msg = JSON.parse(event.data) as ServerEvent;
      switch (msg.type) {
        case 'node_state':
          store.updateNodeData(msg.node_id, {
            status: msg.status, output: msg.output, metrics: msg.metrics,
          });
          break;
        case 'cost_update':
          store.setCostState({ spent: msg.spent, budget: msg.budget });
          break;
        case 'dag_mutated':
          store.applyMutation(msg.mutation);
          break;
        case 'execution_complete':
          store.setExecutionComplete(msg.results);
          break;
      }
    };

    ws.onclose = () => {
      // Reconnect with exponential backoff (max 30s)
      const delay = Math.min(1000 * 2 ** reconnectAttempt.current, 30000);
      reconnectAttempt.current++;
      setTimeout(connect, delay);
    };

    wsRef.current = ws;
  }, [dagId, store]);

  useEffect(() => { connect(); return () => wsRef.current?.close(); }, [connect]);

  // Send client events
  const send = useCallback((event: ClientEvent) => {
    wsRef.current?.send(JSON.stringify(event));
  }, []);

  return { send };
}
```

---

## Server Implementation (Node.js)

```typescript
import { WebSocketServer } from 'ws';

const wss = new WebSocketServer({ noServer: true });

// Per-DAG rooms
const rooms = new Map<string, Set<WebSocket>>();

function broadcast(dagId: string, event: ServerEvent) {
  const clients = rooms.get(dagId);
  if (!clients) return;
  const msg = JSON.stringify(event);
  for (const ws of clients) {
    if (ws.readyState === ws.OPEN) ws.send(msg);
  }
}

// Usage in execution engine:
function onNodeComplete(dagId: string, nodeId: string, result: any) {
  broadcast(dagId, {
    type: 'node_state',
    node_id: nodeId,
    status: 'completed',
    output: result.output,
    metrics: result.metrics,
  });
}
```

---

## Anti-Patterns

### No Reconnection Logic
**Wrong**: WebSocket closes and the dashboard shows stale data forever.
**Right**: Exponential backoff reconnection (1s, 2s, 4s, 8s... max 30s). Resync state on reconnect.

### Sending Full State on Every Event
**Wrong**: Broadcasting the entire DAG state on every node update.
**Right**: Send only the delta: which node changed, to what status. The client applies the update to its local store.

### No Typed Protocol
**Wrong**: Sending untyped JSON objects and parsing with `any`.
**Right**: Define `ServerEvent` and `ClientEvent` union types. Exhaustive switch on `msg.type`.

© curiositech · MIT · curiositech/some_claude_skills

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

Все скиллы по теме «Бэкенд и API» →
streaming-ssr patterns.dev Скилл streaming-ssr для Claude Code и ещё пяти агентных сред. Учит отдавать HTML частями по мере готовности на сервере, чтобы браузер начинал отрисовку раньше. CX Codex +1 964установок websocket-realtime-builder patricio0312rev Скилл websocket-realtime-builder помогает настроить обмен данными через WebSockets и Socket.io. Пригодится при сборке чатов и системных уведомлений. CX Codex +1 549установок websocket-implementation secondsky Скилл websocket-implementation для агента, который пишет сервер и клиент WebSocket: комнаты, переподключение, масштабирование через Redis. CX Codex +1 446установок media-streaming rohitg00 Субагент media-streaming проектирует пайплайны видеостриминга: от приёма файлов и транскодирования в FFmpeg до раздачи HLS или DASH через CDN и настройки плееров с адаптивным битрейтом. CX Codex ★ 2 858звёзд репо aws-messaging-and-streaming aws Скилл aws-messaging-and-streaming помогает агенту выбрать, чем двигать данные в AWS: очередью, шиной событий или журналом. Полезно до того, как вы зафиксируете SQS или Kinesis. CX Codex +1 9 200установок websocket-engineer https://github.com/Jeffallan Скилл websocket-engineer помогает проектировать WebSocket- и Socket.IO-системы: сообщения, комнаты, presence и масштабирование через Redis. CX Codex +1 7 300установок

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

Весь набор →
research-craft Скилл research-craft для Claude Code помогает формулировать научные проблемы, проверять гипотезы и структурировать диссертации или статьи. CX Codex +1 153установок database-design-patterns Скилл database-design-patterns проектирует схемы реляционных БД: нормализует таблицы до 3NF, подбирает типы индексов и планирует миграции без простоя сервиса. CX Codex +1 152установок mermaid-graph-renderer Скилл mermaid-graph-renderer для рендера Mermaid-диаграмм в SVG, PNG и PDF. Подскажет, как настроить ленивую загрузку на сайте, экспорт из CLI и выбор библиотеки. CX Codex +1 152установок logging-observability Скилл logging-observability настраивает структурированное логирование, сквозную трассировку через OpenTelemetry и пороги алертов. Помогает связать логи сервисов и убрать лишний шум из оповещений. CX Codex +1 152установок performance-profiling Скилл performance-profiling находит узкие места в стеке Node.js и React: строит флейм-графики, ищет утечки памяти по снапшотам кучи и замеряет нагрузку на event loop. CX Codex +1 148установок typescript-advanced-patterns Скилл typescript-advanced-patterns помогает проектировать сложные типы TypeScript: от branded types и discriminated unions до Zod-инференса и exhaustive checking. CX Codex +1 148установок ml-system-design-interview Скилл ml-system-design-interview тренирует прохождение собеседований по ML System Design уровня L6+. Помогает уложить архитектуру рекомендаций или RAG в тайминг 45 минут. CX Codex +1 147установок monorepo-management Скилл monorepo-management помогает спроектировать workspace для JavaScript и TypeScript, настроить задачи Turborepo или Nx и разобраться с зависимостями пакетов. Пригодится при создании монорепозитория или переносе проекта. CX Codex +1 147установок

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

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