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.
