๐Ÿงช
QualityTypeScript

Debugging WebSocket Issues

by AgentWorkforce

Debugging WebSocket Issues is a Quality skill for Claude Code, published by AgentWorkforce in relay.

801 stars64 forkson AgentWorkforce/relayAdded 2026/08/23+1% in starsRepository updated 2026/08/22
agentagent-collaborationagent-communicationagent-skillsagentic-aiagentsheadlessorchestrationorchestration-systemsreal-timeslack
Install in seconds
Install Debugging WebSocket Issues
Copy Debugging WebSocket Issues into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/AgentWorkforce/relay/tree/main/.claude/skills/debugging-websocket-issues ~/.claude/skills/debugging-websocket-issues

Requires Node.js. Downloads this skill only โ€” not the rest of the repository โ€” into your Claude Code skills folder.

Without Node.js

git clone https://github.com/AgentWorkforce/relay.git

Clones the whole repository, then copy the skillโ€™s own directory into your skills folder yourself.

In this catalog

Source file
.claude/skills/debugging-websocket-issues/SKILL.md in AgentWorkforce/relay
Installs to
~/.claude/skills/debugging-websocket-issues
Collection
One of 25 skills cataloged from this repository
Category
Quality โ€” 1354 skills

What Debugging WebSocket Issues does

Debugging WebSocket Issues helps diagnose invalid frame header, RSV1, and unexpected close errors in WebSocket servers. Use it to trace upgrade conflicts, compression mismatches, and raw HTTP written to sockets.

Debugging WebSocket Issues is cataloged under Quality on DirSkills. Debugging WebSocket Issues comes from a repository tagged agent, agent-collaboration, agent-communication, agent-skills and agentic-ai.

Documentation

README

Debugging WebSocket Issues

Overview

WebSocket "invalid frame header" errors often stem from raw HTTP being written to an upgraded socket, not actual frame corruption. The most common cause is multiple WebSocketServer instances conflicting on the same HTTP server.

When to Use

  • Error: Invalid WebSocket frame: RSV1 must be clear
  • Error: WS_ERR_UNEXPECTED_RSV_1
  • Error: Invalid frame header
  • WebSocket connects then immediately disconnects with code 1006
  • Server logs success but client receives garbage data

Quick Reference

This is the opening of the README. Read the full README on GitHub.

Commands Debugging WebSocket Issues provides

Slash commands named in this skillโ€™s SKILL.md, listed in the order they first appear.

  • /ws

Frequently asked about Debugging WebSocket Issues

  • What else does AgentWorkforce publish alongside Debugging WebSocket Issues?

    Debugging WebSocket Issues is one of 25 skills that DirSkills catalogs from AgentWorkforce/relay, the repository it ships in. Its siblings there include Agent Relay, Agent Relay and Animation Review. Each one is a separate skill with its own page in this directory, installs the same way Debugging WebSocket Issues does, and is maintained by AgentWorkforce in that same repository. The rest of the collection is listed on the AgentWorkforce/relay page.

  • How does Debugging WebSocket Issues compare to other Quality skills?

    Debugging WebSocket Issues ranks #974 by stars among the 1354 Quality skills in this catalog. The most-starred ones next to it are Benchmark, Benchmark Optimization Loop and API Design Patterns. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Debugging WebSocket Issues against them. Open each page to compare what they document and how they install.

More from AgentWorkforce/relay

Debugging WebSocket Issues is one of 25 skills cataloged on DirSkills from AgentWorkforce/relay.

See all 25 skills โ†’
๐Ÿค
1w ago

Agent Relay

Agent Relay coordinates registered agents in real time using channels, DMs, threads, reactions, inbox checks, and worker spawn or release. Use it when your session is already in a Relay workspace and needs to communicate or coordinate with peers.
AI Engineering
80164
๐Ÿ”—
1w ago

Agent Relay

Agent Relay coordinates multiple Codex agents through shared messaging, handoffs, and status tracking. Use it when workers need peer-to-peer updates, ACK/BLOCKED/DONE signals, or a shared workspace.
AI Engineering
80164
๐ŸŽž๏ธ
1w ago

Animation Review

Animation Review checks animation and motion code against a strict craft bar focused on timing, easing, origin, performance, and accessibility. Use it when reviewing UI motion changes and deciding whether they should be approved.
Quality
80164
๐Ÿ“ธ
1w ago

Browser Testing With Screenshots

Browser Testing With Screenshots automates Chrome interactions and screenshot capture to verify web app UI flows. Use it when you need visual confirmation of layouts, forms, or localhost behavior during development.
Quality
80164
๐Ÿงฉ
1w ago

Choosing Swarm Patterns

Choosing Swarm Patterns helps you pick the right Agent Relay orchestration pattern for coordinating multiple AI agents. It covers the core and specialized swarm patterns, with decision guidance and YAML or fluent builder examples.
AI Engineering
80164
๐Ÿง 
1w ago

Choosing Swarm Patterns

Choosing Swarm Patterns helps you pick the right Agent Relay orchestration pattern for coordinating multiple AI agents. Use it to choose and configure YAML or builder-based workflows for fan-out, pipeline, hub-spoke, consensus, mesh, handoff, cascade, dag, debate, and hierarchical patterns.
AI Engineering
80164