CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

grpc-golang

Build production-ready gRPC services in Go with mTLS, streaming, and observability. Use when designing Protobuf contracts with Buf or implementing secure service-to-service transport.

Quality

72%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/grpc-golang/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The skill has a clear structure, sensible scope boundaries (use/do-not-use, limitations), and genuinely useful best-practice bullets, but it consistently stops one level short of executable: the mTLS, observability, and streaming core has no code, per-step checkpoints are absent, and its single detail reference is a file that does not exist in the bundle. Uniformly at the midpoint across all four dimensions.

Suggestions

Add the missing resources/implementation-playbook.md (or correct the path to an existing bundle directory) so the twice-referenced detail file actually resolves (progressive_disclosure).

Include copy-paste-ready Go code for the headline capabilities — e.g., a minimal mTLS server/client setup with credentials and the x509.CertPool, and an OpenTelemetry interceptor example — so steps 4–5 are executable rather than one-line abstractions (actionability).

Add per-step commands and a feedback loop to the guide, e.g. run `buf lint` at the schema step with 'if lint fails, fix and re-run' before proceeding, instead of a single terminal verification step (workflow_clarity).

Tighten duplication: drop or merge the Overview/"Use this skill when" sections that restate the frontmatter description, mention the playbook pointer once, and move version assumptions (Go 1.21+, gRPC-Go v1.60+) into a clearly labeled compatibility note (conciseness).

DimensionReasoningScore

Conciseness

The body is mostly lean (best practices like "Handle ctx.Done() in all streaming handlers" and "Map domain errors to standard gRPC status codes" earn their tokens), but the Overview and "Use this skill when" sections substantially duplicate the frontmatter description, the Resources section repeats the playbook pointer already given in the step-by-step guide, and version pins ("Assumes Go 1.21+ and gRPC-Go v1.60+") sit in Limitations rather than an old-patterns/deprecated section, which the guidelines penalize. This fits anchor 3 ("mostly efficient but includes some unnecessary explanation or could be tightened") better than anchor 4, since these are several instances rather than minor ones.

3 / 5

Actionability

There is real concrete guidance — a complete executable proto example ("service UserService { rpc GetUser... }", "option go_package = ..."), commands ("buf lint", "buf generate"), and specific status codes ("codes.NotFound") — but the skill's headline capabilities have no code: step 4 "Implement mTLS for service-to-service authentication" and step 5 "Configure interceptors for tracing, metrics, and structured logging" are one-line abstractions with zero Go examples, and the playbook file that would contain "detailed patterns, code examples" does not exist in the bundle. This lands at anchor 3 ("some concrete guidance but incomplete... missing key details") rather than 4, where the common cases would be covered by executable code.

3 / 5

Workflow Clarity

The six-step guide is a coherent sequence (context → requirements → schema → security → observability → verification) and step 6 is an explicit checkpoint ("Always run buf lint and breaking change checks before finalizing code generation"), with a Troubleshooting section covering three failure modes. But only one of six steps has an executable checkpoint; steps 1–5 are one-line considerations with no commands or validation (e.g., no "if lint fails, fix and re-run" loop). That matches anchor 3 ("sequence present but checkpoints missing or implicit") better than anchor 4's "most checkpoints present".

3 / 5

Progressive Disclosure

The body is well-sectioned and defers detail via a clearly signaled, one-level-deep reference ("Refer to resources/implementation-playbook.md for detailed patterns, code examples, and anti-patterns"), which would merit 4–5 — but scoring against the actual bundle, no resources/, references/, scripts/, or assets/ directories exist, so both pointers to the playbook are dangling and the promised detail layer is unreachable. Scored 3: structure and signaling are good (not anchor 2's "minimal structure" or "buried references"), but the navigation path is broken by the missing file, preventing a higher score.

3 / 5

Total

12

/

20

Passed

Description

83%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 description in third-person voice with a clear what + explicit 'Use when' trigger clause and natural, domain-appropriate keywords. The only gaps are minor: a few missing synonyms (.proto files, unary/bidirectional) and slight overlap risk with general Protobuf contract-design work.

DimensionReasoningScore

Specificity

"Build production-ready gRPC services in Go with mTLS, streaming, and observability" names the domain plus several concrete capability areas (mTLS, streaming, observability), matching anchor 4 ("lists several specific actions; minor gaps in coverage"). Not 5 because the what-clause omits actions that only surface in the when-clause (contract design with Buf, error mapping, interceptors); not 3 because more than 1–2 concrete actions are listed.

4 / 5

Completeness

Explicitly answers both questions: the what is "Build production-ready gRPC services in Go with mTLS, streaming, and observability" and the when is a concrete trigger clause, "Use when designing Protobuf contracts with Buf or implementing secure service-to-service transport." This mirrors the anchor-5 example structure (what + explicit 'Use when' with concrete trigger phrases), so neither 4 ("when could be more explicit") nor below applies.

5 / 5

Trigger Term Quality

Terms a user would naturally say are well covered: "gRPC services in Go", "mTLS", "streaming", "Protobuf contracts", "Buf", "service-to-service transport" — matching anchor 4 ("good keyword coverage; a few natural terms missing"). Not 5 because common variations like ".proto files", "proto", or "unary/bidirectional" are absent, and not 3 because coverage goes well beyond "some relevant keywords".

4 / 5

Distinctiveness Conflict Risk

The gRPC + Go + mTLS niche is clearly distinct from general Go or REST skills, with dedicated triggers ("Buf", "mTLS", "service-to-service") matching anchor 4 ("mostly distinct; minor overlap risk with closely related skills"). Not 5 because "designing Protobuf contracts with Buf" could also fire for non-Go protobuf work, creating minor overlap with a general Protobuf/API-design skill.

4 / 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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/grpc-golang/SKILL.md

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.