CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/grpc-mock

Use when gRPC client code needs tests against a controllable fake server, or a gRPC interceptor needs tests: Go bufconn and mockgen, Python pytest-grpc, JVM in-process servers, Node fake servers, with success, error and timeout responses. Streaming sequences are grpc-streaming-test-author.

Quality

80%

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

75%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 multi-language cookbook: executable recipes for four ecosystems, a useful anti-patterns table, honest limitations, and properly externalized interceptor detail. Weaknesses are minor — repeated cross-references, one fragmentary code example, a dangling status-codes.md path, and an implied rather than explicit workflow sequence.

Suggestions

State the status-code catalog reference once (in References) and point to it from other sections, and clarify that references/status-codes.md lives in the grpc-streaming-test-author bundle so the path does not appear dangling within this skill.

Complete the Python unittest.mock example (close the 'with' block and add an assertion) and add the missing imports (promisify, UserServiceClient, UserServiceServer) to the Node example.

Add a short numbered workflow at the top of Authoring (1. pick an approach from the table, 2. adapt the per-language recipe, 3. run with the listed commands, 4. diagnose failures via Parsing results) to make the sequence explicit.

DimensionReasoningScore

Conciseness

Code dominates the body, tradeoffs are stated tersely ('doesn't exercise serialisation; faster, less fidelity'), and there is no padding explaining concepts Claude already knows. It is not 5 because the status-code catalog cross-reference is repeated three times, the bufconn URL appears twice, and the References section re-lists links already given inline.

4 / 5

Actionability

Mostly copy-paste-ready artifacts: a complete Go bufconn test file with setup/cleanup, mockgen install and usage commands, a full Python pytest fixture suite, and a complete JVM GrpcCleanupRule test. Not 5 because the Python unittest.mock example is a truncated fragment (unclosed 'with', no assertion) and the Node example uses 'promisify' and 'UserServiceClient' without importing them.

4 / 5

Workflow Clarity

A coherent arc is present — choose an approach via the comparison table, author per language with recipes, run with exact commands, then diagnose via the 'Parsing results' failure-to-fix mapping and anti-patterns table. Not 5 because the sequence is implied by section order rather than explicitly numbered, and there is no validate-and-retry loop; not 3 because concrete failure checkpoints are provided.

4 / 5

Progressive Disclosure

Good structure with deep interceptor playbooks correctly split into four real, one-level-deep reference files that are clearly signaled with links and descriptions. Not 5 because 'references/status-codes.md' is cited three times but does not exist in this bundle (it belongs to the sibling grpc-streaming-test-author skill), and the ~340-line body could move one or two language recipes out to references.

4 / 5

Total

16

/

20

Passed

Description

78%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 strong, trigger-first description with an explicit 'Use when' clause, concrete per-language mechanisms, and an explicit scope boundary to a sibling skill. The main gap is that the what is expressed as a compressed tool list without action verbs or common synonyms like 'mock server'/'stub'.

Suggestions

Open with an explicit action clause (e.g., 'Mock gRPC servers for client-side tests using Go bufconn/mockgen, Python pytest-grpc, JVM in-process servers, and Node fake servers') before the 'Use when' clause so the what is stated as actions rather than a bare tool list.

Weave in the natural synonyms users actually say — 'mock gRPC server', 'fake gRPC server', 'stub' — since 'mock' currently appears only in the skill name.

DimensionReasoningScore

Specificity

Names several concrete per-language mechanisms ('Go bufconn and mockgen, Python pytest-grpc, JVM in-process servers, Node fake servers') plus response types ('success, error and timeout responses'), which matches the 'several specific actions; minor gaps' anchor. It is not 5 because the what-clause is a tool list without explicit action verbs and streaming coverage is delegated wholesale to a sibling skill.

4 / 5

Completeness

The when is explicit and specific ('Use when gRPC client code needs tests against a controllable fake server, or a gRPC interceptor needs tests') and the what is conveyed through the per-language mechanism list and an explicit streaming boundary. Not 5 because the what is implicit — a list of technologies rather than clearly stated actions — and not 3 because the when is explicit, not weakly implied.

4 / 5

Trigger Term Quality

Contains natural phrases users would say ('gRPC client code needs tests', 'controllable fake server', 'a gRPC interceptor needs tests', 'timeout'), giving good keyword coverage. It falls short of 5 because common synonyms such as 'mock server' or 'stub' never appear as words — 'mock' exists only in the skill name — and no file-extension or variant terms are offered.

4 / 5

Distinctiveness Conflict Risk

The gRPC client-test mocking niche is distinct, and the explicit boundary hand-off ('Streaming sequences are grpc-streaming-test-author') actively prevents mis-triggering against the closest sibling skill. This matches the 'clear niche with distinct triggers; minimal conflict risk' anchor exactly.

5 / 5

Total

17

/

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

Warning

Total

15

/

16

Passed

Reviewed

On this page