Skip to content

Keith-CY/idx.md / data

idx-md

Flagged

AgentSkill for https://idx.md. Use the index to locate AI agent library topics and fetch HEAD/BODY markdown.

FileKindSize
SKILL.mdskill md4.8 KB
agentskills-skill/BODY.mdmarkdown13.1 KB
agentskills-skill/HEAD.mdmarkdown792 B
agentskills-skill/vectors.jsonconfig1.2 KB
carmahhawwari-ui-design-brain-skill/BODY.mdmarkdown8.1 KB
carmahhawwari-ui-design-brain-skill/HEAD.mdmarkdown1.5 KB
carmahhawwari-ui-design-brain-skill/vectors.jsonconfig1.9 KB
category/ai-llms/index.mdmarkdown1.0 KB
category/calendar-scheduling/index.mdmarkdown1.1 KB
category/coding-agents-ides/index.mdmarkdown2.5 KB
category/communication/index.mdmarkdown9.7 KB
category/data-analytics/index.mdmarkdown10.8 KB
category/finance/index.mdmarkdown8.6 KB
category/git-github/index.mdmarkdown3.0 KB
category/index.mdmarkdown855 B
category/marketing-sales/index.mdmarkdown18.6 KB
category/productivity-tasks/index.mdmarkdown19.8 KB
category/search-research/index.mdmarkdown12.9 KB
category/security-passwords/index.mdmarkdown1.0 KB
category/transportation/index.mdmarkdown946 B
category/uncategorized/index.mdmarkdown495.0 KB
github-markup-readme/BODY.mdmarkdown3.3 KB
github-markup-readme/HEAD.mdmarkdown1.6 KB
github-markup-readme/vectors.jsonconfig2.0 KB
github-skill-actionbook-rust-skills-m04-zero-cost/BODY.mdmarkdown4.6 KB
github-skill-actionbook-rust-skills-m04-zero-cost/HEAD.mdmarkdown928 B
github-skill-actionbook-rust-skills-m04-zero-cost/vectors.jsonconfig1.6 KB
github-skill-agno-agi-agno-git-workflow-cdbf56f5/BODY.mdmarkdown2.2 KB
github-skill-agno-agi-agno-git-workflow-cdbf56f5/HEAD.mdmarkdown765 B
github-skill-agno-agi-agno-git-workflow-cdbf56f5/vectors.jsonconfig1.4 KB
github-skill-anthropics-knowledge-work-plugins-call-prep/BODY.mdmarkdown5.8 KB
github-skill-anthropics-knowledge-work-plugins-call-prep/HEAD.mdmarkdown987 B
github-skill-anthropics-knowledge-work-plugins-call-prep/vectors.jsonconfig1.7 KB
github-skill-composiohq-awesome-claude-skills-forcemanager-automation-185f86fa/BODY.mdmarkdown2.9 KB
github-skill-composiohq-awesome-claude-skills-forcemanager-automation-185f86fa/HEAD.mdmarkdown879 B
github-skill-composiohq-awesome-claude-skills-forcemanager-automation-185f86fa/vectors.jsonconfig1.7 KB
github-skill-composiohq-awesome-claude-skills-ip2location-io-automation-e171a20b/BODY.mdmarkdown3.0 KB
github-skill-composiohq-awesome-claude-skills-ip2location-io-automation-e171a20b/HEAD.mdmarkdown889 B
github-skill-composiohq-awesome-claude-skills-ip2location-io-automation-e171a20b/vectors.jsonconfig1.7 KB
github-skill-composiohq-awesome-claude-skills-kickbox-automation-3347ff5a/BODY.mdmarkdown2.9 KB
github-skill-composiohq-awesome-claude-skills-kickbox-automation-3347ff5a/HEAD.mdmarkdown854 B
github-skill-composiohq-awesome-claude-skills-kickbox-automation-3347ff5a/vectors.jsonconfig1.6 KB
github-skill-coreyhaines31-marketingskills-programmatic-seo/BODY.mdmarkdown7.2 KB
github-skill-coreyhaines31-marketingskills-programmatic-seo/HEAD.mdmarkdown1.0 KB
github-skill-coreyhaines31-marketingskills-programmatic-seo/vectors.jsonconfig1.8 KB
github-skill-darrenhinde-openagentscontrol-task-breakdown/BODY.mdmarkdown4.4 KB
github-skill-darrenhinde-openagentscontrol-task-breakdown/HEAD.mdmarkdown957 B
github-skill-darrenhinde-openagentscontrol-task-breakdown/vectors.jsonconfig1.7 KB
github-skill-davepoon-buildwithclaude-content-research-writer/BODY.mdmarkdown13.9 KB
github-skill-davepoon-buildwithclaude-content-research-writer/HEAD.mdmarkdown1004 B
github-skill-davepoon-buildwithclaude-content-research-writer/vectors.jsonconfig1.7 KB
github-skill-davila7-claude-code-templates-scientific-schematics/BODY.mdmarkdown23.2 KB
github-skill-davila7-claude-code-templates-scientific-schematics/HEAD.mdmarkdown1.1 KB
github-skill-davila7-claude-code-templates-scientific-schematics/vectors.jsonconfig1.9 KB
github-skill-davila7-claude-code-templates-writing-hookify-rules/BODY.mdmarkdown8.2 KB
github-skill-davila7-claude-code-templates-writing-hookify-rules/HEAD.mdmarkdown967 B
github-skill-davila7-claude-code-templates-writing-hookify-rules/vectors.jsonconfig1.7 KB
github-skill-deanpeters-product-manager-skills-pestel-analysis/BODY.mdmarkdown14.1 KB
github-skill-deanpeters-product-manager-skills-pestel-analysis/HEAD.mdmarkdown891 B
github-skill-deanpeters-product-manager-skills-pestel-analysis/vectors.jsonconfig1.6 KB
github-skill-dicklesworthstone-pi-agent-rust-deploying-monitoring-stacks/BODY.mdmarkdown3.9 KB
github-skill-dicklesworthstone-pi-agent-rust-deploying-monitoring-stacks/HEAD.mdmarkdown1.2 KB
github-skill-dicklesworthstone-pi-agent-rust-deploying-monitoring-stacks/vectors.jsonconfig2.0 KB
github-skill-dicklesworthstone-pi-agent-rust-websocket-client-creator/BODY.mdmarkdown2.2 KB
github-skill-dicklesworthstone-pi-agent-rust-websocket-client-creator/HEAD.mdmarkdown1.2 KB
github-skill-dicklesworthstone-pi-agent-rust-websocket-client-creator/vectors.jsonconfig2.0 KB
github-skill-dicklesworthstone-pi-agent-rust-windsurf-common-errors/BODY.mdmarkdown2.3 KB
github-skill-dicklesworthstone-pi-agent-rust-windsurf-common-errors/HEAD.mdmarkdown1.1 KB
github-skill-dicklesworthstone-pi-agent-rust-windsurf-common-errors/vectors.jsonconfig1.9 KB
github-skill-dlt-hub-dlt-review-pr/BODY.mdmarkdown8.7 KB
github-skill-dlt-hub-dlt-review-pr/HEAD.mdmarkdown713 B
github-skill-dlt-hub-dlt-review-pr/vectors.jsonconfig1.3 KB
github-skill-epicweb-dev-epic-stack-epic-ui-guidelines/BODY.mdmarkdown17.0 KB
github-skill-epicweb-dev-epic-stack-epic-ui-guidelines/HEAD.mdmarkdown768 B
github-skill-epicweb-dev-epic-stack-epic-ui-guidelines/vectors.jsonconfig1.5 KB
github-skill-florianbruniaux-claude-code-ultimate-guide-rtk-optimizer/BODY.mdmarkdown4.1 KB
github-skill-florianbruniaux-claude-code-ultimate-guide-rtk-optimizer/HEAD.mdmarkdown837 B
github-skill-florianbruniaux-claude-code-ultimate-guide-rtk-optimizer/vectors.jsonconfig1.6 KB
github-skill-github-awesome-copilot-copilot-instructions-blueprint-generator/BODY.mdmarkdown14.4 KB
github-skill-github-awesome-copilot-copilot-instructions-blueprint-generator/HEAD.mdmarkdown1.0 KB
github-skill-github-awesome-copilot-copilot-instructions-blueprint-generator/vectors.jsonconfig1.8 KB
github-skill-jeffallan-claude-skills-websocket-engineer/BODY.mdmarkdown6.4 KB
github-skill-jeffallan-claude-skills-websocket-engineer/HEAD.mdmarkdown872 B
github-skill-jeffallan-claude-skills-websocket-engineer/vectors.jsonconfig1.6 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-ideogram-common-errors/BODY.mdmarkdown4.4 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-ideogram-common-errors/HEAD.mdmarkdown1.1 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-ideogram-common-errors/vectors.jsonconfig2.0 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-juicebox-migration-deep-dive/BODY.mdmarkdown2.9 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-juicebox-migration-deep-dive/HEAD.mdmarkdown1.2 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-juicebox-migration-deep-dive/vectors.jsonconfig2.1 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-klingai-pricing-basics/BODY.mdmarkdown7.1 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-klingai-pricing-basics/HEAD.mdmarkdown1.1 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-klingai-pricing-basics/vectors.jsonconfig1.9 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-prisma-schema-helper/BODY.mdmarkdown2.2 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-prisma-schema-helper/HEAD.mdmarkdown1.1 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-prisma-schema-helper/vectors.jsonconfig2.0 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-testing-load-balancers/BODY.mdmarkdown6.1 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-testing-load-balancers/HEAD.mdmarkdown1.1 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-testing-load-balancers/vectors.jsonconfig1.9 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-twinmind-security-basics/BODY.mdmarkdown3.6 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-twinmind-security-basics/HEAD.mdmarkdown1.2 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-twinmind-security-basics/vectors.jsonconfig2.0 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-vercel-upgrade-migration/BODY.mdmarkdown6.0 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-vercel-upgrade-migration/HEAD.mdmarkdown1.2 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-vercel-upgrade-migration/vectors.jsonconfig2.0 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-websocket-client-creator/BODY.mdmarkdown2.3 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-websocket-client-creator/HEAD.mdmarkdown1.2 KB
github-skill-jeremylongshore-claude-code-plugins-plus-skills-websocket-client-creator/vectors.jsonconfig2.0 KB
github-skill-kevoreilly-capev2-cape-sandbox-developer/BODY.mdmarkdown15.5 KB
github-skill-kevoreilly-capev2-cape-sandbox-developer/HEAD.mdmarkdown736 B
github-skill-kevoreilly-capev2-cape-sandbox-developer/vectors.jsonconfig1.4 KB
github-skill-kurtosis-tech-kurtosis-cluster-manage/BODY.mdmarkdown1.5 KB
github-skill-kurtosis-tech-kurtosis-cluster-manage/HEAD.mdmarkdown876 B
github-skill-kurtosis-tech-kurtosis-cluster-manage/vectors.jsonconfig1.5 KB
github-skill-luongnv89-claude-howto-brand-voice-consistency/BODY.mdmarkdown2.5 KB
github-skill-luongnv89-claude-howto-brand-voice-consistency/HEAD.mdmarkdown894 B
github-skill-luongnv89-claude-howto-brand-voice-consistency/vectors.jsonconfig1.6 KB
github-skill-mukul975-anthropic-cybersecurity-skills-analyzing-ransomware-leak-site-intelligence/BODY.mdmarkdown13.9 KB
github-skill-mukul975-anthropic-cybersecurity-skills-analyzing-ransomware-leak-site-intelligence/HEAD.mdmarkdown1.0 KB
github-skill-mukul975-anthropic-cybersecurity-skills-analyzing-ransomware-leak-site-intelligence/vectors.jsonconfig1.9 KB
github-skill-neolabhq-context-engineering-kit-sadd-multi-agent-patterns/BODY.mdmarkdown23.4 KB
github-skill-neolabhq-context-engineering-kit-sadd-multi-agent-patterns/HEAD.mdmarkdown973 B
github-skill-neolabhq-context-engineering-kit-sadd-multi-agent-patterns/vectors.jsonconfig1.7 KB
github-skill-novuhq-novu-react-email/BODY.mdmarkdown14.1 KB
github-skill-novuhq-novu-react-email/HEAD.mdmarkdown799 B
github-skill-novuhq-novu-react-email/vectors.jsonconfig1.4 KB
github-skill-onmax-nuxt-skills-nuxt-seo/BODY.mdmarkdown2.9 KB
github-skill-onmax-nuxt-skills-nuxt-seo/HEAD.mdmarkdown785 B
github-skill-onmax-nuxt-skills-nuxt-seo/vectors.jsonconfig1.4 KB
github-skill-openai-openai-agents-python-pr-draft-summary/BODY.mdmarkdown7.0 KB
github-skill-openai-openai-agents-python-pr-draft-summary/HEAD.mdmarkdown996 B
github-skill-openai-openai-agents-python-pr-draft-summary/vectors.jsonconfig1.7 KB
github-skill-openclaw-openclaw-gh-issues/BODY.mdmarkdown6.2 KB
github-skill-openclaw-openclaw-gh-issues/HEAD.mdmarkdown973 B
github-skill-openclaw-openclaw-gh-issues/vectors.jsonconfig1.6 KB
github-skill-prompt-security-clawsec-claw-release/BODY.mdmarkdown7.5 KB
github-skill-prompt-security-clawsec-claw-release/HEAD.mdmarkdown778 B
github-skill-prompt-security-clawsec-claw-release/vectors.jsonconfig1.4 KB
github-skill-quickwit-oss-quickwit-simple-pr/BODY.mdmarkdown2.3 KB
github-skill-quickwit-oss-quickwit-simple-pr/HEAD.mdmarkdown734 B
github-skill-quickwit-oss-quickwit-simple-pr/vectors.jsonconfig1.4 KB
github-skill-quickwit-oss-tantivy-simple-pr/BODY.mdmarkdown1.7 KB
github-skill-quickwit-oss-tantivy-simple-pr/HEAD.mdmarkdown730 B
github-skill-quickwit-oss-tantivy-simple-pr/vectors.jsonconfig1.4 KB
github-skill-resend-react-email-react-email/BODY.mdmarkdown14.1 KB
github-skill-resend-react-email-react-email/HEAD.mdmarkdown815 B
github-skill-resend-react-email-react-email/vectors.jsonconfig1.4 KB
github-skill-sickn33-antigravity-awesome-skills-hubspot-integration/BODY.mdmarkdown1.6 KB
github-skill-sickn33-antigravity-awesome-skills-hubspot-integration/HEAD.mdmarkdown940 B
github-skill-sickn33-antigravity-awesome-skills-hubspot-integration/vectors.jsonconfig1.7 KB
github-skill-sickn33-antigravity-awesome-skills-outlook-calendar-automation/BODY.mdmarkdown10.6 KB
github-skill-sickn33-antigravity-awesome-skills-outlook-calendar-automation/HEAD.mdmarkdown952 B
github-skill-sickn33-antigravity-awesome-skills-outlook-calendar-automation/vectors.jsonconfig1.7 KB
github-skill-sickn33-antigravity-awesome-skills-upstash-qstash/BODY.mdmarkdown1.4 KB
github-skill-sickn33-antigravity-awesome-skills-upstash-qstash/HEAD.mdmarkdown926 B
github-skill-sickn33-antigravity-awesome-skills-upstash-qstash/vectors.jsonconfig1.7 KB
github-skill-vllm-project-vllm-ascend-vllm-ascend-model-adapter/BODY.mdmarkdown8.5 KB
github-skill-vllm-project-vllm-ascend-vllm-ascend-model-adapter/HEAD.mdmarkdown968 B
github-skill-vllm-project-vllm-ascend-vllm-ascend-model-adapter/vectors.jsonconfig1.7 KB
github-skill-wavetermdev-waveterm-electron-api/BODY.mdmarkdown4.5 KB
github-skill-wavetermdev-waveterm-electron-api/HEAD.mdmarkdown803 B
github-skill-wavetermdev-waveterm-electron-api/vectors.jsonconfig1.5 KB
github-skill-zjunlp-skillnet-webshop-query-parser/BODY.mdmarkdown2.6 KB
github-skill-zjunlp-skillnet-webshop-query-parser/HEAD.mdmarkdown1.1 KB
github-skill-zjunlp-skillnet-webshop-query-parser/vectors.jsonconfig1.8 KB
ibelick-baseline-ui/BODY.mdmarkdown3.3 KB
ibelick-baseline-ui/HEAD.mdmarkdown957 B
ibelick-baseline-ui/vectors.jsonconfig1.4 KB
ibelick-fixing-accessibility/BODY.mdmarkdown4.6 KB
ibelick-fixing-accessibility/HEAD.mdmarkdown1.0 KB
ibelick-fixing-accessibility/vectors.jsonconfig1.5 KB
ibelick-fixing-metadata/BODY.mdmarkdown4.3 KB
ibelick-fixing-metadata/HEAD.mdmarkdown991 B
ibelick-fixing-metadata/vectors.jsonconfig1.4 KB
ibelick-fixing-motion-performance/BODY.mdmarkdown5.4 KB
ibelick-fixing-motion-performance/HEAD.mdmarkdown1.1 KB
ibelick-fixing-motion-performance/vectors.jsonconfig1.6 KB
index.mdmarkdown582.7 KB
industry/finance/index.mdmarkdown1.2 KB
industry/index.mdmarkdown169 B
industry/uncategorized/index.mdmarkdown145 B
knowledge-work-plugins-bio-research-skills-instrument-data-to-allotrope-skill/BODY.mdmarkdown10.5 KB
knowledge-work-plugins-bio-research-skills-instrument-data-to-allotrope-skill/HEAD.mdmarkdown1.3 KB
knowledge-work-plugins-bio-research-skills-instrument-data-to-allotrope-skill/vectors.jsonconfig2.1 KB
knowledge-work-plugins-bio-research-skills-nextflow-development-skill/BODY.mdmarkdown8.6 KB
knowledge-work-plugins-bio-research-skills-nextflow-development-skill/HEAD.mdmarkdown1.1 KB
knowledge-work-plugins-bio-research-skills-nextflow-development-skill/vectors.jsonconfig1.8 KB
knowledge-work-plugins-bio-research-skills-scientific-problem-selection-skill/BODY.mdmarkdown10.9 KB
knowledge-work-plugins-bio-research-skills-scientific-problem-selection-skill/HEAD.mdmarkdown1.3 KB
knowledge-work-plugins-bio-research-skills-scientific-problem-selection-skill/vectors.jsonconfig2.1 KB
knowledge-work-plugins-bio-research-skills-scvi-tools-skill/BODY.mdmarkdown7.2 KB
knowledge-work-plugins-bio-research-skills-scvi-tools-skill/HEAD.mdmarkdown1.4 KB
knowledge-work-plugins-bio-research-skills-scvi-tools-skill/vectors.jsonconfig2.1 KB
knowledge-work-plugins-bio-research-skills-single-cell-rna-qc-skill/BODY.mdmarkdown7.8 KB
knowledge-work-plugins-bio-research-skills-single-cell-rna-qc-skill/HEAD.mdmarkdown1.0 KB
knowledge-work-plugins-bio-research-skills-single-cell-rna-qc-skill/vectors.jsonconfig1.8 KB
knowledge-work-plugins-bio-research-skills-start-skill/BODY.mdmarkdown3.4 KB
knowledge-work-plugins-bio-research-skills-start-skill/HEAD.mdmarkdown963 B
knowledge-work-plugins-bio-research-skills-start-skill/vectors.jsonconfig1.6 KB
knowledge-work-plugins-cowork-plugin-management-skills-cowork-plugin-customizer-skill/BODY.mdmarkdown9.5 KB

github-skill-jeffallan-claude-skills-websocket-engineer/BODY.md

View on GitHub
---
name: websocket-engineer
description: Use when building real-time communication systems with WebSockets or Socket.IO. Invoke for bidirectional messaging, horizontal scaling with Redis, presence tracking, room management.
license: MIT
metadata:
  author: https://github.com/Jeffallan
  company: https://synergetic.solutions
  version: "1.1.1"
  domain: api-architecture
  triggers: WebSocket, Socket.IO, real-time communication, bidirectional messaging, pub/sub, server push, live updates, chat systems, presence tracking
  role: specialist
  scope: implementation
  output-format: code
  related-skills: fastapi-expert, nestjs-expert, devops-engineer, monitoring-expert, security-reviewer
---

# 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 |
| Patterns | `references/patterns.md` | Rooms, namespaces, broadcasting, acknowledgments |
| Security | `references/security.md` | Authentication, authorization, rate limiting, CORS |
| Alternatives | `references/alternatives.md` | SSE, long polling, when to choose WebSockets |

## Code Examples

### Server Setup (Socket.IO with Auth and Room Management)

```js
import { createServer } from "http";
import { Server } from "socket.io";
import { createAdapter } from "@socket.io/redis-adapter";
import { createClient } from "redis";
import jwt from "jsonwebtoken";

const httpServer = createServer();
const io = new Server(httpServer, {
  cors: { origin: process.env.ALLOWED_ORIGIN, credentials: true },
  pingTimeout: 20000,
  pingInterval: 25000,
});

// Authentication middleware — runs before connection is established
io.use((socket, next) => {
  const token = socket.handshake.auth.token;
  if (!token) return next(new Error("Authentication required"));
  try {
    socket.data.user = jwt.verify(token, process.env.JWT_SECRET);
    next();
  } catch {
    next(new Error("Invalid token"));
  }
});

// Redis adapter for horizontal scaling
const pubClient = createClient({ url: process.env.REDIS_URL });
const subClient = pubClient.duplicate();
await Promise.all([pubClient.connect(), subClient.connect()]);
io.adapter(createAdapter(pubClient, subClient));

io.on("connection", (socket) => {
  const { userId } = socket.data.user;
  console.log(`connected: ${userId} (${socket.id})`);

  // Presence: mark user online
  pubClient.hSet("presence", userId, socket.id);

  socket.on("join-room", (roomId) => {
    socket.join(roomId);
    socket.to(roomId).emit("user-joined", { userId });
  });

  socket.on("message", ({ roomId, text }) => {
    io.to(roomId).emit("message", { userId, text, ts: Date.now() });
  });

  socket.on("disconnect", () => {
    pubClient.hDel("presence", userId);
    console.log(`disconnected: ${userId}`);
  });
});

httpServer.listen(3000);
```

### Client-Side Reconnection with Exponential Backoff

```js
import { io } from "socket.io-client";

const socket = io("wss://api.example.com", {
  auth: { token: getAuthToken() },
  reconnection: true,
  reconnectionAttempts: 10,
  reconnectionDelay: 1000,       // initial delay (ms)
  reconnectionDelayMax: 30000,   // cap at 30 s
  randomizationFactor: 0.5,      // jitter to avoid thundering herd
});

// Queue messages while disconnected
let messageQueue = [];

socket.on("connect", () => {
  console.log("connected:", socket.id);
  // Flush queued messages
  messageQueue.forEach((msg) => socket.emit("message", msg));
  messageQueue = [];
});

socket.on("disconnect", (reason) => {
  console.warn("disconnected:", reason);
  if (reason === "io server disconnect") socket.connect(); // manual reconnect
});

socket.on("connect_error", (err) => {
  console.error("connection error:", err.message);
});

function sendMessage(roomId, text) {
  const msg = { roomId, text };
  if (socket.connected) {
    socket.emit("message", msg);
  } else {
    messageQueue.push(msg); // buffer until reconnected
  }
}
```

## Constraints

### MUST DO
- Use sticky sessions for load balancing (WebSocket connections are stateful — requests must route to the same server instance)
- Implement heartbeat/ping-pong to detect dead connections (TCP keepalive alone is insufficient)
- Use rooms/namespaces for message scoping rather than filtering in application logic
- Queue messages during disconnection windows to avoid silent data loss
- Plan connection limits per instance before scaling horizontally

### MUST NOT DO
- Store large state in memory without a clustering strategy (use Redis or an external store)
- Mix WebSocket and HTTP on the same port without explicit upgrade handling
- Forget to handle connection cleanup (presence records, room membership, in-flight timers)
- Skip load testing before production — connection-count spikes behave differently from HTTP traffic spikes

## Output Templates

When implementing WebSocket features, provide:
1. Server setup (Socket.IO/ws configuration)
2. Event handlers (connection, message, disconnect)
3. Client library (connection, events, reconnection)
4. Brief explanation of scaling strategy

## Knowledge Reference

Socket.IO, ws, uWebSockets.js, Redis adapter, sticky sessions, nginx WebSocket proxy, JWT over WebSocket, rooms/namespaces, acknowledgments, binary data, compression, heartbeat, backpressure, horizontal pod autoscaling

Maintained by [@jeffallan](https://github.com/jeffallan), Principal Consultant at [Synergetic Solutions](https://synergetic.solutions)

[Documentation](https://jeffallan.github.io/claude-skills/skills/api-architecture/websocket-engineer/)
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall