Content
86%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-structured, highly actionable guide: executable code for both transports, a clear ordered workflow with validation habits, and a clean overview-to-reference split verified against the actual bundle. The only improvements are trimming minor duplication between the How-to-use/Authoring/References sections and adding an explicit failure-feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes competence — it carries non-obvious knowledge (close-code table, port: 0 pattern, retryAttempts: 0, --forceExit rationale) with no basic-concept padding. Minor trim opportunities exist: the "How to use" steps restate the Authoring sections, and sibling-skill scope is stated in both "When to use" and "References". | 4 / 5 |
Actionability | Fully executable inline TypeScript for both transports, install commands, jest config, CI workflow YAML, and a concrete worked example; the only undefined helpers (startWsServer/startSseServer) are implemented in the clearly signaled reference files. Code is copy-paste ready and covers the common subscription test cases. | 5 / 5 |
Workflow Clarity | "How to use" gives an explicit 7-step sequence (install, port: 0 server, client.iterate, errors-before-data assertion, auth rejection codes, resolver isolation, CI timeout/forceExit) with checkpoints such as checking errors === undefined and the anti-patterns table. It stops short of a 5 because there is no explicit validate→fix→retry feedback loop for recovering from failures. | 4 / 5 |
Progressive Disclosure | The SKILL.md body stays a lean overview and points to four well-signaled, one-level-deep reference files (transport-server-setup, auth-on-connect, lifecycle-and-close-codes, resolver-and-filter-tests), all of which exist with real content and no nested references. Content is appropriately split and easy to navigate. | 5 / 5 |
Total | 18 / 20 Passed |