CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/graphql-subscription-test-author

Use when GraphQL subscriptions need tests over graphql-ws (WebSocket) or graphql-sse: subscribing through the async iterator, asserting event shape and order, connection lifecycle and close codes, auth on connect and pubsub triggers. Queries and mutations belong to the server test skills.

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Overview
Quality
Evals
Security
Files

Quality

Content

86%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is explicit about both capability and trigger conditions, packed with concrete actions and transport-specific keywords, and cleanly bounded against sibling query/mutation test skills. Its only weakness is a handful of missing natural synonyms (SSE spelled out, real-time, event stream).

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "subscribing through the async iterator, asserting event shape and order, connection lifecycle and close codes, auth on connect and pubsub triggers" — giving comprehensive coverage of the subscription-testing niche. It exceeds the score-4 anchor because every major test category for the domain is named rather than having minor gaps.

5 / 5

Completeness

It opens with an explicit "Use when GraphQL subscriptions need tests over graphql-ws (WebSocket) or graphql-sse" trigger clause and pairs it with a concrete list of what the skill does. Both what and when are explicitly answered with concrete trigger phrases, matching the top anchor.

5 / 5

Trigger Term Quality

Natural keywords like "GraphQL subscriptions", "graphql-ws", "graphql-sse", "WebSocket", "auth on connect", and "pubsub triggers" match what a user would say. A few natural synonyms ("SSE" spelled out, "Server-Sent Events", "real-time", "live updates") are missing, so it falls just short of the comprehensive-synonym anchor.

4 / 5

Distinctiveness Conflict Risk

The niche is clear (subscription transport testing via graphql-ws/graphql-sse) and it explicitly delimits boundaries — "Queries and mutations belong to the server test skills" — so conflict with sibling server-test skills is minimal.

5 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Reviewed

On this page