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

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

Добавляет в агент паттерны для работы с Socket.IO: комнаты, авторизацию через middleware, типизацию в TypeScript и масштабирование через Redis.

MIT 106 установок ★ 50 обновлён 2026-10-23

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

Что делает socket-io

Скилл снабжает агента инструкциями по настройке двусторонней связи на базе Socket.IO. Внутри собраны готовые шаблоны для сервера и клиента: строгая типизация входящих и исходящих событий через TypeScript-интерфейсы, подтверждения доставки (acknowledgments) и готовый хук useSocket для React.

Для распределённых систем скилл предлагает подключение @socket.io/redis-adapter через связку двух клиентов Redis. Без такого адаптера рассылка сообщений по комнатам на нескольких серверах сразу ломается.

Для чистого WebRTC или Server-Sent Events этот скилл не подходит: правила предписывают переключаться на отдельные скиллы вроде sse или webrtc.

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

  • настроить двусторонний обмен событиями между клиентом и сервером
  • добавить авторизацию сокетов через middleware с проверкой JWT
  • распределить события по комнатам вместо общей рассылки
  • масштабировать Socket.IO на несколько серверов через Redis-адаптер
  • типизировать события клиента и сервера в TypeScript

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

  • Настрой сервер Socket.IO с авторизацией по токену в middleware и типизированными событиями
  • Добавь React-хук для подключения к комнате и отправки сообщений с подтверждением доставки
  • Покажи, как масштабировать Socket.IO горизонтально с помощью адаптера Redis

Как установить socket-io

1Через Skills CLI (Vercel)

npx skills add claude-dev-suite/claude-dev-suite --skill socket-io -a claude-code

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

~/.claude/skills/socket-io/SKILL.md

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

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

Вопросы о socket-io

Как установить socket-io в Claude Code?

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

Что делает скилл socket-io?

Он обучает ассистента надёжным приёмам работы с библиотекой: от типизации событий и переподключения до чеклиста готовности к продакшену.

Подходит ли этот скилл для Server-Sent Events или WebRTC?

Нет, для односторонних потоков данных через SSE или медиапотоков WebRTC скилл рекомендует подключать отдельные инструменты sse и webrtc.

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

SKILL.md · MIT
---
name: socket-io
description: |
  Socket.IO real-time bidirectional communication. Rooms, namespaces,
  acknowledgments, middleware, scaling with Redis adapter, and TypeScript types.

  USE WHEN: user mentions "Socket.IO", "socket.io", "real-time chat",
  "live updates", "bidirectional WebSocket", "rooms", "namespaces"

  DO NOT USE FOR: SSE (server-sent events) - use `sse`;
  WebRTC - use `webrtc`; raw WebSocket without Socket.IO - use framework WS skills
allowed-tools: Read, Grep, Glob, Write, Edit
---
# Socket.IO

## Server Setup

```typescript
import { Server } from 'socket.io';
import { createServer } from 'http';

const httpServer = createServer(app);

interface ServerToClientEvents {
  message: (data: { user: string; text: string; timestamp: number }) => void;
  userJoined: (user: string) => void;
}

interface ClientToServerEvents {
  sendMessage: (text: string, callback: (status: 'ok' | 'error') => void) => void;
  joinRoom: (room: string) => void;
}

const io = new Server<ClientToServerEvents, ServerToClientEvents>(httpServer, {
  cors: { origin: process.env.CLIENT_URL },
});

// Authentication middleware
io.use((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) => {
  console.log(`${socket.data.user.name} connected`);

  socket.on('joinRoom', (room) => {
    socket.join(room);
    socket.to(room).emit('userJoined', socket.data.user.name);
  });

  socket.on('sendMessage', (text, callback) => {
    const message = { user: socket.data.user.name, text, timestamp: Date.now() };
    io.to('general').emit('message', message);
    callback('ok');
  });

  socket.on('disconnect', () => {
    console.log(`${socket.data.user.name} disconnected`);
  });
});
```

## Client Setup

```typescript
import { io, Socket } from 'socket.io-client';

const socket: Socket<ServerToClientEvents, ClientToServerEvents> = io(API_URL, {
  auth: { token: getAuthToken() },
  reconnection: true,
  reconnectionDelay: 1000,
});

socket.on('connect', () => console.log('Connected'));
socket.on('message', (data) => addMessage(data));
socket.on('connect_error', (err) => console.error(err.message));

// With acknowledgment
socket.emit('sendMessage', 'Hello!', (status) => {
  if (status === 'error') showError('Failed to send');
});
```

## Scaling with Redis Adapter

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

const pubClient = createClient({ url: process.env.REDIS_URL });
const subClient = pubClient.duplicate();
await Promise.all([pubClient.connect(), subClient.connect()]);

io.adapter(createAdapter(pubClient, subClient));
```

## React Hook

```tsx
function useSocket(room: string) {
  const [messages, setMessages] = useState<Message[]>([]);

  useEffect(() => {
    socket.emit('joinRoom', room);
    socket.on('message', (msg) => setMessages((prev) => [...prev, msg]));
    return () => { socket.off('message'); };
  }, [room]);

  const send = (text: string) => socket.emit('sendMessage', text, () => {});
  return { messages, send };
}
```

## Anti-Patterns

| Anti-Pattern | Fix |
|--------------|-----|
| No authentication | Use `io.use()` middleware with JWT |
| Broadcasting to all instead of rooms | Use `socket.to(room).emit()` |
| No reconnection handling | Enable reconnection, show UI indicator |
| Single server without adapter | Use Redis adapter for horizontal scaling |
| No acknowledgments for critical events | Use callback parameter for delivery confirmation |

## Production Checklist

- [ ] Authentication middleware on connection
- [ ] Redis adapter for multi-server deployment
- [ ] Reconnection with exponential backoff
- [ ] Room-based message scoping
- [ ] Connection state UI indicator
- [ ] Rate limiting on message events

© claude-dev-suite · MIT · claude-dev-suite/claude-dev-suite

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

Все скиллы по теме «Бэкенд и API» →
websocket-implementation secondsky Скилл websocket-implementation для агента, который пишет сервер и клиент WebSocket: комнаты, переподключение, масштабирование через Redis. CX Codex +1 446установок websocket-engineer VoltAgent Community Субагент websocket-engineer проектирует и настраивает двустороннюю связь на WebSockets или Socket.IO. Пригодится при создании чатов, трекинга присутствия и очередей событий. CX Codex 472установок websocket-realtime rohitg00 Скилл websocket-realtime обучает Claude Code архитектуре реального времени: от чистого WebSocket и Socket.io до Server-Sent Events и связки с Redis. CX Codex +1 ★ 2 858звёзд репо websocket-realtime-builder patricio0312rev Скилл websocket-realtime-builder помогает настроить обмен данными через WebSockets и Socket.io. Пригодится при сборке чатов и системных уведомлений. CX Codex +1 549установок real-time-features aj-geddes Скилл real-time-features помогает внедрять веб-сокеты, Server-Sent Events и long polling в веб-приложения. Пригодится при сборке чатов, живых панелей мониторинга и совместного редактирования. CX Codex +1 549установок websockets-realtime travisjneuman Скилл websockets-realtime для Claude Code и Codex помогает настроить передачу данных в реальном времени. Включается при создании чатов, живых лент и совместного редактирования. CX Codex +1 172установок

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

Весь набор →
email-sending Скилл email-sending для Claude Code подключает отправку транзакционных писем, шаблоны и почтовые сервисы. Отправляет welcome-письма, сбросы пароля и уведомления. CX Codex +1 188установок cron-scheduling Скилл cron-scheduling для Claude Code помогает задавать cron-расписания и планировать фоновые задачи в Node.js, Java и Python. Описывает периодические запуски и распределённое планирование. CX Codex +1 162установок iec61131 Разбирает языки PLC, типы данных и организацию программ по IEC 61131-3. Помогает обсуждать стандарты и обмен проектами между платформами. CX Codex +1 154установок plsql Oracle PL/SQL — процедуры, функции, пакеты, триггеры, курсоры, коллекции и обработка исключений. CX Codex +1 106установок sonarqube Настраивает проверку качества кода через SonarQube или SonarCloud. Помогает прописать quality gates, файл sonar-project.properties и шаги для CI/CD. CX Codex +1 106установок spring-webflux Помогает писать реактивный код на Spring WebFlux в Spring Boot 3.x. Подключается к задачам с Mono, Flux, WebClient и R2DBC. CX Codex +1 102установок sqlserver Справочник по диалекту Microsoft SQL Server: типы данных, даты, строки, JSON и автоинкремент. CX Codex +1 102установок nats Объясняет Core NATS, JetStream и обмен запросами с ответом. Подключается к вопросам о NATS, шаблонах subject и связи микросервисов. CX Codex +1 101установок

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

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