CtrlK
BlogDocsLog inGet started
Tessl Logo

golang-grpc

Provides gRPC usage guidelines, protobuf organization, and production-ready patterns for Golang microservices. Use when implementing, reviewing, or debugging gRPC servers/clients, writing proto files, setting up interceptors, handling gRPC errors with status codes, configuring TLS/mTLS, testing with bufconn, or working with streaming RPCs.

90

Quality

89%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Discovery

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.

This is an excellent skill description that clearly defines its scope (gRPC in Golang microservices), lists specific concrete capabilities, and provides comprehensive trigger guidance via an explicit 'Use when' clause. The description uses appropriate third-person voice, includes highly specific and natural trigger terms that developers would use, and occupies a distinct niche that minimizes conflict risk with other skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: gRPC usage guidelines, protobuf organization, production-ready patterns, implementing/reviewing/debugging gRPC servers/clients, writing proto files, setting up interceptors, handling gRPC errors with status codes, configuring TLS/mTLS, testing with bufconn, and working with streaming RPCs.

3 / 3

Completeness

Clearly answers both 'what' (provides gRPC usage guidelines, protobuf organization, and production-ready patterns for Golang microservices) and 'when' (explicit 'Use when' clause covering implementing, reviewing, debugging, writing proto files, setting up interceptors, handling errors, configuring TLS, testing, and streaming RPCs).

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: gRPC, protobuf, proto files, interceptors, status codes, TLS, mTLS, bufconn, streaming RPCs, Golang, microservices. These are all terms a developer would naturally use when seeking help in this domain.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche: gRPC + Golang + microservices. The specific trigger terms like bufconn, protobuf, interceptors, mTLS, and streaming RPCs make it very unlikely to conflict with other skills. The combination of technology stack and specific tooling creates a well-defined scope.

3 / 3

Total

12

/

12

Passed

Implementation

79%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a strong, well-structured gRPC skill that delivers dense, actionable guidance with excellent code examples and useful reference tables. Its main weakness is the lack of explicit multi-step workflows with validation checkpoints — it functions more as a comprehensive reference guide than a step-by-step procedural skill. The progressive disclosure is reasonable but cannot be fully validated without bundle files.

Suggestions

Add an explicit 'Build mode' workflow with numbered steps and validation checkpoints (e.g., 1. Define proto → 2. Generate code → 3. Verify generated files exist → 4. Implement server → 5. Test with bufconn → 6. Verify health check responds)

Provide the referenced bundle files (references/protoc-reference.md, references/testing.md) or inline minimal testing examples so the skill is self-contained for core use cases

DimensionReasoningScore

Conciseness

The content is lean and efficient throughout. It avoids explaining what gRPC is or how Go works, assumes Claude's competence, and every section delivers actionable information without padding. The tables are dense and useful, and explanatory comments are terse but informative (e.g., explaining *why* a practice matters in a short clause).

3 / 3

Actionability

Provides fully executable Go code for server setup with graceful shutdown, interceptor patterns, client configuration with retry policy, error handling with good/bad examples, and streaming. The service config JSON, status code table, and common mistakes table all give concrete, copy-paste-ready guidance.

3 / 3

Workflow Clarity

The skill covers multiple concerns (server, client, errors, streaming, security, testing) with clear sections, but lacks explicit multi-step workflows with validation checkpoints. For example, there's no step-by-step 'build a new service' workflow with verification steps, and the proto generation process is deferred to a reference file without even a summary sequence. The shutdown pattern is well-sequenced, but overall the skill reads more as a reference than a guided workflow.

2 / 3

Progressive Disclosure

References to `references/protoc-reference.md` and `references/testing.md` are well-signaled and one level deep, and cross-references to other skills are helpful. However, no bundle files were provided, so these references cannot be verified. Additionally, some sections like Security and Performance could benefit from being split out or having deeper reference material, and the inline content is moderately long without clear navigation aids beyond headers.

2 / 3

Total

10

/

12

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

9

/

11

Passed

Repository
samber/cc-skills-golang
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.