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.

72

Quality

89%

Does it follow best practices?

Impact

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 proper third-person voice and includes highly specific technical terms that serve as natural trigger keywords, making it both easy to match and unlikely to conflict 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 listing specific trigger scenarios like implementing, reviewing, debugging gRPC servers/clients, writing proto files, etc.).

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 developers 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 technical terms like 'bufconn', 'protobuf', 'interceptors', 'mTLS', and 'streaming RPCs' make it very unlikely to conflict with other skills.

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-organized gRPC skill that delivers dense, actionable guidance with excellent code examples and useful reference tables. Its main weaknesses are the lack of explicit step-by-step workflows with validation checkpoints (especially given the declared Build/Review modes) and unverifiable external references due to missing bundle files. The content strikes a good balance between breadth and conciseness for a complex topic.

Suggestions

Flesh out the declared 'Build mode' and 'Review mode' into explicit step-by-step workflows with validation checkpoints (e.g., 'Build mode: 1. Define protos → 2. Generate code → 3. Implement server → 4. Verify with bufconn test → 5. Add interceptors').

Include the referenced bundle files (references/protoc-reference.md and references/testing.md) so the progressive disclosure actually works — especially the testing reference, since the testing section currently has no inline code examples.

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 purposeful (e.g., explaining *why* a practice matters rather than what gRPC is).

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 from scratch' workflow despite declaring a 'Build mode', and no verification steps after proto generation or server setup. The two declared modes (Build/Review) are not elaborated into actual workflows.

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 are unverifiable. Additionally, the security and performance sections could benefit from being split into reference files rather than being inline, and the testing section is thin since it defers entirely to a reference file that doesn't exist in the bundle.

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.