websocket-engineer

Installation
Summary

Real-time bidirectional messaging with Socket.IO, Redis scaling, and presence tracking.

  • Covers server setup with JWT authentication, room management, and event handling; includes client-side reconnection with exponential backoff and message queuing
  • Provides horizontal scaling via Redis pub/sub adapter with sticky session configuration for stateful connections
  • Includes reference guides for protocol details, scaling patterns, security (auth, rate limiting, CORS), and alternatives like SSE and long polling
  • Emphasizes heartbeat/ping-pong for connection health, connection cleanup on disconnect, and load testing before production
SKILL.md

WebSocket Engineer

Core Workflow

  1. Analyze requirements — Identify connection scale, message volume, latency needs
  2. Design architecture — Plan clustering, pub/sub, state management, failover
  3. Implement — Build WebSocket server with authentication, rooms, events
  4. 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
  5. 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
  6. Monitor — Track connections, latency, throughput, error rates; add alerts for connection-count spikes and error-rate thresholds

Reference Guide

Load detailed guidance based on context:

Topic Reference Load When
Protocol references/protocol.md WebSocket handshake, frames, ping/pong, close codes
Scaling references/scaling.md Horizontal scaling, Redis pub/sub, sticky sessions
Related skills

More from jeffallan/claude-skills

Installs
3.5K
GitHub Stars
9.0K
First Seen
Jan 20, 2026