CtrlK
BlogDocsLog inGet started
Tessl Logo

testland/grpc-interceptor-test-author

Authors unit tests for gRPC interceptor logic: Go grpc.UnaryServerInterceptor/UnaryClientInterceptor, Java ServerInterceptor/ClientInterceptor, and grpc-js client interceptors. Covers auth (Unauthenticated on bad token), retry (backoff on Unavailable), logging/tracing (metadata extraction + propagation), error-mapping (status translation), and chained interceptor ordering - by calling the interceptor directly with a spy handler, no live backend. Use when a gRPC interceptor is written or modified. Different test surface from grpc-streaming-test-author (multi-message stream sequences) and grpc-mock (service handler logic) - use those, not this, for streams or handlers.

74

Quality

93%

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

85%

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 that defers language detail to three real one-level-deep references and gives a sequenced workflow plus concrete run/CI guidance. Its only weakness is a conceptual Overview that re-explains what gRPC interceptors are.

Suggestions

Trim the Overview's conceptual explanation of what interceptors are and the quoted gRPC-guide line; assume Claude knows interceptors and lead with the test-authoring approach instead.

Drop or compress the 'Interceptor taxonomy' prose intro ('Full type signatures are at the reference links ...') since the table already conveys this.

Move the worked-example prose that restates the negative-case rationale into the reference, keeping only the steps and assertions inline.

DimensionReasoningScore

Conciseness

Mostly efficient (taxonomy + anti-pattern tables, worked example, run/CI commands earn their place), but the Overview explains concepts Claude already knows ('interceptors apply cross-cutting behavior ... without touching service logic') and quotes the gRPC guide, which is padding.

2 / 3

Actionability

Provides copy-paste-ready commands ('go test ./... -race -count=1'), a concrete CI yaml, and a detailed worked example with named types, specific status codes, and exact assertions; full test code is deferred to references appropriately.

3 / 3

Workflow Clarity

A clear 7-step 'How to use' sequence with a reinforcing worked example and verification cues (isolation flags, fresh metadata map per test, negative-case requirement); not a destructive/batch operation, so the missing validate-fix-retry loop does not cap the score.

3 / 3

Progressive Disclosure

SKILL.md is a concise overview with three clearly signaled, one-level-deep language playbooks (go/java/grpc-js), each a verified real file; content is appropriately split with easy navigation and no nested reference chains.

3 / 3

Total

11

/

12

Passed

Description

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.

A highly specific, third-person description that names concrete behaviors, languages, and a precise test surface, with an explicit 'Use when' trigger and active disambiguation from sibling skills. It fully satisfies the what/when/distinctiveness requirements.

DimensionReasoningScore

Specificity

Lists multiple concrete actions: 'auth (Unauthenticated on bad token), retry (backoff on Unavailable), logging/tracing (metadata extraction + propagation), error-mapping (status translation), and chained interceptor ordering', each tied to named type surfaces across three languages.

3 / 3

Completeness

Clearly answers both what ('Authors unit tests for gRPC interceptor logic ... by calling the interceptor directly with a spy handler, no live backend') and when ('Use when a gRPC interceptor is written or modified') with an explicit trigger clause.

3 / 3

Trigger Term Quality

Natural domain terms a user would say are present (gRPC, interceptor, auth, retry, metadata, tracing) plus the explicit trigger 'Use when a gRPC interceptor is written or modified', giving good coverage of common phrasings.

3 / 3

Distinctiveness Conflict Risk

Explicitly disambiguates from siblings ('Different test surface from grpc-streaming-test-author ... and grpc-mock ... use those, not this, for streams or handlers'), establishing a clear niche unlikely to trigger the wrong skill.

3 / 3

Total

12

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Reviewed

Table of Contents