Agent skill · software engineering · aiskillstore

pitfalls-websocket

WebSocket server and client patterns with heartbeat and reconnection. Use when implementing real-time features, debugging connection issues, or reviewing WebSocket code. Triggers on: WebSocket, wss, heartbeat, reconnect, real-time.

Why this skill is useful

Provides specific WebSocket server and client patterns, including reconnection logic and heartbeat management that the AI wouldn't reliably generate on its own.

What it needs

About 1k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.

What this skill does

WebSocket Pitfalls Common pitfalls and correct patterns for WebSocket implementations. When to Use Implementing WebSocket server Building WebSocket client with reconnection Debugging connection drops Adding heartbeat/ping-pong Reviewing WebSocket code Workflow Step 1: Verify Server Setup Check WebSocket server shares HTTP port. Step 2: Check Heartbeat Ensure ping/pong heartbeat is implemented. Step 3: Verify Client Reconnection Confirm exponential backoff reconnection logic. --- Server Pattern Client Reconnection Message Handling Quick Checklist [ ] WebSocket server uses same port as HTTP [ ] Heartbeat ping/pong every 30 seconds [ ] Client has reconnection with exponential backoff [ ] Messages validated before processing [ ] Connection errors logged

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills aiskillstore/pitfalls-websocket

View the source on GitHub

Browse the @skills marketplace