websocket-streaming — скилл для Claude Code: установка
Скилл websocket-streaming для Claude Code настраивает двусторонний обмен данными по WebSocket между DAG-движком и дашбордом. Передаёт события выполнения и живое состояние графа.
MIT 152 установок ★ 274 обновлён 2026-10-30
npx skills add curiositech/some_claude_skills --skill websocket-streaming -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/websocket-streaming/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/websocket-streaming/
1Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill websocket-streaming -a codex2Вручную: положить файлы
.agents/skills/websocket-streaming/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill websocket-streaming -a cursor2Вручную: положить файлы
.cursor/skills/websocket-streaming/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install curiositech/some_claude_skills .claude/skills/websocket-streaming2Вручную: положить файлы
.github/skills/websocket-streaming/SKILL.md1Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill websocket-streaming -a gemini-cli2Командой платформы
gemini skills install https://github.com/curiositech/some_claude_skills --path .claude/skills/websocket-streamingВручную: положить файлы
.devin/skills/websocket-streaming/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill websocket-streaming -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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