WebSocket vs SSE vs polling, reconnection with backoff and jitter, heartbeats, backpressure, message ordering, connection state UI, auth on upgrade, graceful degradation
94
98%
Does it follow best practices?
Impact
90%
1.87xAverage score across 5 eval scenarios
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that comprehensively covers real-time communication patterns with specific technical details. It uses third person voice appropriately, includes explicit 'Use when' triggers for both building new features and reviewing existing code, and provides natural keywords developers would actually use. The description is thorough without being padded with fluff.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and concepts: WebSocket vs SSE vs polling decisions, reconnection with exponential backoff and jitter, heartbeat/ping-pong, message ordering and deduplication, backpressure handling, connection state management, room/channel management, authentication on WebSocket upgrade. | 3 / 3 |
Completeness | Clearly answers both what (comprehensive list of real-time communication patterns and techniques) AND when with explicit 'Use when building real-time features like...' clause plus a secondary trigger for 'reviewing existing real-time code for reliability gaps'. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'real-time', 'live updates', 'notifications', 'chat', 'dashboards', 'collaboration', 'order tracking', 'WebSocket', 'SSE', 'reconnection', 'dropped messages', 'connection death'. These are terms developers naturally use when discussing real-time features. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused specifically on real-time communication patterns with distinct triggers like WebSocket, SSE, polling, reconnection, heartbeat. Unlikely to conflict with general web development or API skills due to the specific real-time focus. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an exemplary skill document that covers real-time web patterns comprehensively while remaining highly actionable. The WRONG/RIGHT code pattern pairs are particularly effective for teaching correct approaches. The audit checklist and summary checklist provide excellent verification workflows for both new implementations and reviewing existing code.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is dense with actionable content and avoids explaining concepts Claude already knows. Every section provides concrete patterns without unnecessary preamble about what WebSockets or SSE are. | 3 / 3 |
Actionability | Excellent executable code examples throughout with copy-paste ready TypeScript. The WRONG/RIGHT pattern pairs make it immediately clear what to do and what to avoid. Code is complete and runnable, not pseudocode. | 3 / 3 |
Workflow Clarity | Clear decision guide at the start, explicit validation checkpoints in the audit checklist, and the summary checklist provides a comprehensive verification workflow. The 'Common fixes' table maps problems to solutions clearly. | 3 / 3 |
Progressive Disclosure | Well-organized with numbered sections, clear table of contents via headers, and references to verifiers at the end. Content is appropriately structured with quick reference tables and detailed examples in logical progression. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (887 lines); consider splitting into references/ and linking | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
Reviewed
Table of Contents