socket-io — скилл для Claude Code: что делает и как установить
Добавляет в агент паттерны для работы с Socket.IO: комнаты, авторизацию через middleware, типизацию в TypeScript и масштабирование через Redis.
MIT 106 установок ★ 50 обновлён 2026-10-23
npx skills add claude-dev-suite/claude-dev-suite --skill socket-io -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/socket-io/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/socket-io/
1Через Skills CLI (Vercel)
npx skills add claude-dev-suite/claude-dev-suite --skill socket-io -a codex2Вручную: положить файлы
.agents/skills/socket-io/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add claude-dev-suite/claude-dev-suite --skill socket-io -a cursor2Вручную: положить файлы
.cursor/skills/socket-io/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install claude-dev-suite/claude-dev-suite skills/real-time/socket-io2Вручную: положить файлы
.github/skills/socket-io/SKILL.md1Через Skills CLI (Vercel)
npx skills add claude-dev-suite/claude-dev-suite --skill socket-io -a gemini-cli2Командой платформы
gemini skills install https://github.com/claude-dev-suite/claude-dev-suite --path skills/real-time/socket-ioВручную: положить файлы
.devin/skills/socket-io/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add claude-dev-suite/claude-dev-suite --skill socket-io -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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