websocket-integration-testing

What problem does it solve?

Relying on mocked unit tests for WebSocket servers leads to false positives and real-world failures. This Skill enforces rigorous functional testing with real connections and filesystem interactions, guaranteeing that your backend behaves as expected in production.

Core Features & Use Cases

• No Mocks Principle: Strictly prohibits mocks, ensuring tests validate actual server behavior and integration with the filesystem, not just mock implementations.
• Real-World Verification: Verifies WebSocket message protocols, tool execution, and actual filesystem changes (e.g., file creation, content updates) for true integration testing.
• wscat Integration: Uses wscat for direct WebSocket interaction, accurately simulating client behavior without complex test harnesses.
• Use Case: Execute Gate 3A backend functional tests for your WebSocket server, verifying that every tool call (like write_file) actually creates or modifies files on disk, guaranteeing robust backend functionality and preventing integration bugs.

Quick Start

Use the websocket-integration-testing skill to connect to ws://localhost:3001/ws, send an init_session message, and then verify a session_initialized response.