Websocket Engineer

This covers the full WebSocket implementation cycle from connection handling to horizontal scaling with Redis pub/sub. It generates complete Socket.IO servers with authentication middleware, room management, and presence tracking, plus client code with exponential backoff reconnection. The workflow emphasizes testing connection behavior locally before scaling, then validating Redis adapter round-trips and sticky session configs. Useful when you need real-time features beyond simple HTTP and want battle-tested patterns for clustering, not just basic WebSocket examples. The constraints section catches common pitfalls like forgetting sticky sessions or skipping connection cleanup.

skills.sh installs: 7.1K
GitHub stars: 12.3K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add jeffallan/claude-skills --skill websocket-engineer --agent claude-code

Installs into .claude/skills of the current project.

Files

WebSocket Engineer

Core Workflow

Analyze requirements — Identify connection scale, message volume, latency needs
Design architecture — Plan clustering, pub/sub, state management, failover
Implement — Build WebSocket server with authentication, rooms, events
Validate locally — Test connection handling, auth, and room behavior before scaling (e.g., npx wscat -c ws://localhost:3000); confirm auth rejection on missing/invalid tokens, room join/leave events, and message delivery
Scale — Verify Redis connection and pub/sub round-trip before enabling the adapter; configure sticky sessions and confirm with test connections across multiple instances; set up load balancing
Monitor — Track connections, latency, throughput, error rates; add alerts for connection-count spikes and error-rate thresholds