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

websocket-realtime — скилл для Claude Code

Скилл websocket-realtime обучает Claude Code архитектуре реального времени: от чистого WebSocket и Socket.io до Server-Sent Events и связки с Redis.

Apache-2.0 ★ 2 858 обновлён 2026-05-12

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

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

Паттерны внутри скилла помогают ассистенту писать серверный и клиентский код для постоянных соединений. Он содержит готовые решения для комнат, авторизации при рукопожатии и отправки событий через Server-Sent Events без лишних сложностей сокетов.

В репозитории есть готовый класс клиента с механизмом повторного подключения. Если брокер сообщений не настроен заранее, масштабировать Socket.io на несколько серверов не получится, так как адаптеру нужен Redis.

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

  • организовать комнаты и рассылку сообщений на чистом WebSocket
  • настроить масштабирование Socket.io через адаптер Redis
  • реализовать односторонний поток событий через Server-Sent Events
  • добавить клиенту автоподключение с нарастающей задержкой

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

  • Напиши сервер на ws с авторизацией по токену и разделением по комнатам
  • Реализуй эндпоинт Server-Sent Events на Express с подпиской на Redis
  • Создай клиентский класс для WebSocket с повторными попытками подключения

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

1Через Skills CLI (Vercel)

npx skills add rohitg00/awesome-claude-code-toolkit --skill websocket-realtime -a claude-code

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

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

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

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

Вопросы о websocket-realtime

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

Выполните команду npx skills add rohitg00/awesome-claude-code-toolkit --skill websocket-realtime -a claude-code. Также файл можно сохранить вручную по пути ~/.claude/skills/websocket-realtime/SKILL.md.

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

Он снабжает Claude Code проверенными шаблонами кода для работы с двусторонней связью и потоковой передачей данных. Сюда входят примеры для ws, Socket.io и SSE.

Когда лучше выбрать Server-Sent Events вместо WebSocket?

SSE проще использовать, если данные передаются строго от сервера к клиенту. Такой протокол работает через стандартные прокси без специальной конфигурации.

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

SKILL.md · Apache-2.0
---
name: websocket-realtime
description: Real-time communication patterns with WebSocket, Socket.io, Server-Sent Events, and scaling strategies
---

# WebSocket & Real-Time

## WebSocket Server

```typescript
import { WebSocketServer, WebSocket } from "ws";

const wss = new WebSocketServer({ port: 8080 });

const rooms = new Map<string, Set<WebSocket>>();

wss.on("connection", (ws, req) => {
  const userId = authenticateFromUrl(req.url);
  if (!userId) {
    ws.close(4001, "Unauthorized");
    return;
  }

  ws.on("message", (data) => {
    const message = JSON.parse(data.toString());

    switch (message.type) {
      case "join":
        joinRoom(message.room, ws);
        break;
      case "leave":
        leaveRoom(message.room, ws);
        break;
      case "broadcast":
        broadcastToRoom(message.room, message.payload, ws);
        break;
    }
  });

  ws.on("close", () => {
    rooms.forEach((members) => members.delete(ws));
  });

  ws.send(JSON.stringify({ type: "connected", userId }));
});

function joinRoom(room: string, ws: WebSocket) {
  if (!rooms.has(room)) rooms.set(room, new Set());
  rooms.get(room)!.add(ws);
}

function broadcastToRoom(room: string, payload: unknown, sender: WebSocket) {
  const members = rooms.get(room);
  if (!members) return;
  const message = JSON.stringify({ type: "message", room, payload });
  members.forEach((client) => {
    if (client !== sender && client.readyState === WebSocket.OPEN) {
      client.send(message);
    }
  });
}
```

## Socket.io with Rooms

```typescript
import { Server } from "socket.io";
import { createAdapter } from "@socket.io/redis-adapter";
import { createClient } from "redis";

const io = new Server(httpServer, {
  cors: { origin: "https://app.example.com" },
  pingTimeout: 20000,
  pingInterval: 25000,
});

const pubClient = createClient({ url: "redis://localhost:6379" });
const subClient = pubClient.duplicate();
await Promise.all([pubClient.connect(), subClient.connect()]);
io.adapter(createAdapter(pubClient, subClient));

io.use(async (socket, next) => {
  const token = socket.handshake.auth.token;
  try {
    socket.data.user = verifyToken(token);
    next();
  } catch {
    next(new Error("Authentication failed"));
  }
});

io.on("connection", (socket) => {
  socket.join(`user:${socket.data.user.id}`);

  socket.on("chat:join", (roomId) => {
    socket.join(`chat:${roomId}`);
    socket.to(`chat:${roomId}`).emit("chat:userJoined", socket.data.user);
  });

  socket.on("chat:message", async ({ roomId, text }) => {
    const message = await saveMessage(roomId, socket.data.user.id, text);
    io.to(`chat:${roomId}`).emit("chat:message", message);
  });

  socket.on("disconnect", () => {
    console.log(`User ${socket.data.user.id} disconnected`);
  });
});
```

## Server-Sent Events (SSE)

```typescript
app.get("/events/:userId", authenticate, (req, res) => {
  res.writeHead(200, {
    "Content-Type": "text/event-stream",
    "Cache-Control": "no-cache",
    Connection: "keep-alive",
  });

  const sendEvent = (event: string, data: unknown) => {
    res.write(`event: ${event}\n`);
    res.write(`data: ${JSON.stringify(data)}\n\n`);
  };

  sendEvent("connected", { userId: req.params.userId });

  const interval = setInterval(() => {
    res.write(":heartbeat\n\n");
  }, 30000);

  const listener = (message: string) => {
    const event = JSON.parse(message);
    sendEvent(event.type, event.data);
  };

  redis.subscribe(`user:${req.params.userId}`, listener);

  req.on("close", () => {
    clearInterval(interval);
    redis.unsubscribe(`user:${req.params.userId}`, listener);
  });
});
```

SSE is simpler than WebSocket for server-to-client unidirectional streaming. Works through HTTP proxies and load balancers without special configuration.

## Client Reconnection

```typescript
class ReconnectingWebSocket {
  private ws: WebSocket | null = null;
  private retryCount = 0;
  private maxRetries = 10;

  constructor(private url: string) {
    this.connect();
  }

  private connect() {
    this.ws = new WebSocket(this.url);
    this.ws.onopen = () => { this.retryCount = 0; };
    this.ws.onclose = () => { this.scheduleReconnect(); };
    this.ws.onerror = () => { this.ws?.close(); };
  }

  private scheduleReconnect() {
    if (this.retryCount >= this.maxRetries) return;
    const delay = Math.min(1000 * 2 ** this.retryCount, 30000);
    this.retryCount++;
    setTimeout(() => this.connect(), delay);
  }

  send(data: string) {
    if (this.ws?.readyState === WebSocket.OPEN) {
      this.ws.send(data);
    }
  }
}
```

## Anti-Patterns

- Not authenticating WebSocket connections during the handshake
- Sending unbounded payloads without message size limits
- Missing heartbeat/ping-pong to detect stale connections
- Using WebSocket when SSE would suffice (server-to-client only)
- Not using a Redis adapter for horizontal scaling with Socket.io
- Blocking the event loop with synchronous processing of messages

## Checklist

- [ ] WebSocket connections authenticated during handshake
- [ ] Message size limits enforced on incoming data
- [ ] Heartbeat mechanism detects and closes stale connections
- [ ] Client implements exponential backoff reconnection
- [ ] Redis pub/sub adapter used for multi-server deployment
- [ ] SSE used when communication is server-to-client only
- [ ] Room/channel membership cleaned up on disconnect
- [ ] Rate limiting applied to prevent message flooding

© rohitg00 · Apache-2.0 · rohitg00/awesome-claude-code-toolkit

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

Все скиллы по теме «Бэкенд и API» →
websocket-realtime-builder patricio0312rev Скилл websocket-realtime-builder помогает настроить обмен данными через WebSockets и Socket.io. Пригодится при сборке чатов и системных уведомлений. CX Codex +1 549установок websocket-engineer VoltAgent Community Субагент websocket-engineer проектирует и настраивает двустороннюю связь на WebSockets или Socket.IO. Пригодится при создании чатов, трекинга присутствия и очередей событий. CX Codex 472установок websocket-implementation aj-geddes Скилл websocket-implementation для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode: подсказывает ИИ-агенту, как строить WebSocket-системы — от подключения до масштабирования через Redis. CX Codex +1 669установок websockets-realtime travisjneuman Скилл websockets-realtime для Claude Code и Codex помогает настроить передачу данных в реальном времени. Включается при создании чатов, живых лент и совместного редактирования. CX Codex +1 172установок socket-io claude-dev-suite Добавляет в агент паттерны для работы с Socket.IO: комнаты, авторизацию через middleware, типизацию в TypeScript и масштабирование через Redis. CX Codex +1 106установок competition-websocket-runtime zhaoxuya520 Скилл competition-websocket-runtime для Claude Code запускается после orchestrator при анализе WebSocket и SSE handshake, подписок и фреймов. CX Codex +1 110установок

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

Весь набор →
testing-infrastructure Субагент testing-infrastructure распределяет тесты по параллельным запускам, выявляет нестабильные тесты и сокращает время выполнения. Включается, когда CI замедляет разработку или тесты падают случайно. CX Codex ★ 2 858звёзд репо healthcare-engineer Субагент healthcare-engineer для Claude Code проектирует медицинские сервисы по стандартам HIPAA и HL7 FHIR. Выполняет интеграцию с EHR, маппинг кодов и обезличивание данных пациентов. CX Codex ★ 2 858звёзд репо continuous-learning Скилл continuous-learning для Claude Code фиксирует исправления и удачные решения из сессий и применяет накопленные знания в проекте. Учитывает прошлые правки агента. CX Codex +1 ★ 2 858звёзд репо developer-portal Субагент developer-portal для построения внутренних портальных решений на базе Backstage с каталогом сервисов, шаблонами проектов и самообслуживанием инфраструктуры. Ускоряет поиск сервисов, документации и развёртывание новых проектов. CX Codex ★ 2 858звёзд репо monitoring-observability Скилл monitoring-observability для Claude Code добавляет в Node.js-сервис трассировки, метрики, структурированные логи и правила оповещений. Связывает сигналы приложения с дашбордами и SLO. CX Codex +1 ★ 2 858звёзд репо database-optimizer Субагент database-optimizer разбирает медленные запросы, строит индексы, настраивает партиционирование и планирует нагрузку для PostgreSQL, MySQL и распределённых баз. CX Codex ★ 2 858звёзд репо accessibility-wcag Скилл accessibility-wcag для Claude Code собирает шаблоны WCAG 2.2 для настройки семантической вёрстки, ARIA-атрибутов, управления с клавиатуры и контрастности. CX Codex +1 ★ 2 858звёзд репо content-strategist Субагент content-strategist планирует SEO-контент, собирает темы в кластеры и помогает связать публикации с метриками. Подходит для технических продуктов и developer-аудитории. CX Codex ★ 2 858звёзд репо

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

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