CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/grpc-streaming-test-author

Use when a server-streaming, client-streaming or bidirectional gRPC call needs tests, or a suite needs auditing for gaps: ordering, completion, cancellation, deadlines and partial failures, with skeletons for Go, Python, JVM and Node, plus the 17 gRPC status codes and their retry rules.

Quality

87%

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

78%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.

A well-structured, actionable skill body: clear five-step workflow, executable server-streaming examples, a useful anti-patterns table, honest limitations, and exemplary progressive disclosure across four real reference files. The main gaps are the undefined test fixtures (delegated to the external grpc-mock skill), no inline examples for two of the four streaming patterns, and no run-the-suite validation step at the end of the workflow.

Suggestions

Add a final Step 6 instructing the model to run the generated suite (e.g. `pytest tests/grpc-streaming/ -x`) and fix failures before declaring done, closing the workflow-validation gap.

Trim the Overview's restatement of the four gRPC streaming patterns and the 'Unary (covered for completeness)' section (or collapse unary to one line pointing at the status-codes reference) to save tokens on content Claude already knows.

Include a minimal conftest.py fixture definition (or a one-line pointer to the exact grpc-mock fixture names) so the inline pytest examples are copy-paste runnable without the external skill's context.

DimensionReasoningScore

Conciseness

The body is largely lean — tables, dense executable pytest snippets, an anti-patterns table, and a limitations section that each earn their tokens — but there is minor over-explanation: the Overview paragraph re-explains that gRPC has four streaming patterns (concepts Claude already knows), and the 'Unary (covered for completeness)' section spends two full test examples on a pattern the description doesn't even claim. Matches 'efficient; minor instances of over-explanation that could be trimmed', not 5.

4 / 5

Actionability

Server-streaming is exhaustively covered with copy-paste-ready pytest code, a concrete coverage matrix, a per-language harness table, and an output directory layout. Not a 5: the `stub_with_fake` / `stub_with_slow_fake` fixtures are never defined in the bundle (delegated to the external `grpc-mock` skill), and client-streaming and bidi — two of the four patterns — have no inline executable example, only pointers to reference skeletons, leaving minor gaps.

4 / 5

Workflow Clarity

Steps 1–5 are clearly sequenced (classify → per-pattern categories → coverage matrix → harness → emit directory) and the matrix rule 'Empty cells in covered patterns = coverage gap. PR must justify or add a test' acts as a checkpoint. Falls short of 5 because there is no explicit validation step — nothing instructs running the generated suite or verifying the tests compile/pass against the in-process server before finishing.

4 / 5

Progressive Disclosure

SKILL.md is a genuine overview: representative Python examples inline, with per-language skeletons, the 17-code status matrix, and wire-level patterns each split into a real, substantive reference file, all one level deep and clearly signaled both inline and in a References section. This matches 'clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'.

5 / 5

Total

17

/

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.

A highly specific, well-triggered description: it names the exact RPC patterns, test categories, languages, and status-code surface, and gives an explicit 'Use when' clause covering both new-test authoring and suite auditing. Its only weakness is missing a few natural synonyms (proto/.proto, Java vs JVM) that would make triggering even more reliable.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities: writing tests and auditing suites for "ordering, completion, cancellation, deadlines and partial failures", "skeletons for Go, Python, JVM and Node", and "the 17 gRPC status codes and their retry rules". This matches the anchor for multiple specific concrete actions with comprehensive coverage; the only reason to consider 4 is that actions are framed inside the trigger clause, but the deliverables are explicitly enumerated.

5 / 5

Completeness

Both what and when are explicit: "Use when a server-streaming, client-streaming or bidirectional gRPC call needs tests, or a suite needs auditing for gaps" gives concrete trigger conditions, and the what is spelled out (test authoring/auditing across the listed categories, per-language skeletons, status-code and retry rules). Matches the anchor 'clearly and explicitly answers both what AND when with concrete trigger phrases'; a 4 would require the when to be less explicit than it is.

5 / 5

Trigger Term Quality

Strong natural keywords a user would actually say: "gRPC", "server-streaming", "client-streaming", "bidirectional", "tests", "cancellation", "deadlines", "status codes". Not a 5 because common variations and file extensions are missing — no ".proto"/"proto file", no "streaming RPC" phrasing, and "JVM" is less natural than "Java" — so it falls at 'good keyword coverage; a few natural terms missing'.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche — authoring/auditing tests for gRPC streaming RPCs specifically — with distinct triggers (the three streaming pattern names, cancellation, deadlines, status codes) that would not fire for unrelated skills. Minor overlap potential with general gRPC or contract-testing skills exists, but the streaming-test framing is unmistakable, matching the 'clear niche with distinct triggers' anchor.

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: 2 missing

Warning

Total

15

/

16

Passed

Reviewed

On this page