CtrlK
BlogDocsLog inGet started
Tessl Logo

otel-go

OpenTelemetry in Go — SDK setup, API surface, breaking changes, contrib instrumentation libraries (otelhttp, otelgrpc, otelmongo), compile-time zero-code instrumentation (otelc), and performance tuning. Use when adding, reviewing, or configuring OpenTelemetry in a Go service. Triggers on "setup otel in go", "go telemetry", "go tracing", "otelconf go", "otelhttp", "otelgrpc", "TracerProvider go", "MeterProvider go", "otelc", "compile-time instrumentation go", "zero-code go instrumentation", "go build instrumentation", or any Go-related OTel question.

75

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 strong, well-structured hub skill: lean tables and executable commands, correct progressive disclosure with verified one-level-deep references, and explicit validation steps for dependency and upgrade workflows. The only weaknesses are aging hard-coded version examples and the absence of an explicit error-recovery loop for failed dependency resolution.

Suggestions

Isolate the hard-coded version examples (v1.47.0, v0.23.0, v0.72.0) in a version-history note or replace them with the already-provided `gh api` lookups so the body does not go stale as releases advance.

Add a short fix-and-retry loop for dependency resolution failures (e.g., what to check and re-run when `go mod tidy` or `go build ./...` fails after adding modules with `@latest`).

Consider moving the module-versioning table into `references/breaking-changes.md` (or its own reference) to keep the SKILL.md body purely a routing overview.

DimensionReasoningScore

Conciseness

The body is dense and almost entirely tables, commands, and non-obvious traps (module version groups, the @latest resolution guidance) with no padding or explanations of concepts Claude already knows. Score 5 is prevented by hard-coded version examples ("v1.47.0", "v0.23.0", "v0.72.0") that are time-sensitive and will age, which the guidelines penalize unless isolated in a deprecated/version-history section; it is clearly above anchor 3's 'some unnecessary explanation'.

4 / 5

Actionability

Fully executable, copy-paste-ready guidance: a complete `go get ...@latest` block ending in `go mod tidy && go build ./...`, concrete `gh api repos/.../releases/latest -q '.tag_name'` commands for each version lookup, and WebFetch URLs. Specific commands cover the common cases (adding deps, checking latest versions, auditing upgrades); nothing is pseudocode.

5 / 5

Workflow Clarity

Clear sequences with explicit validation checkpoints: dependency addition ends with `go mod tidy && go build ./...`, and upgrade reviews "always finish with a safe local verification path (go mod tidy -diff, go build ./..., go test ./...)" tested "against a disposable local receiver, never a deployment endpoint". Missing an explicit fix-and-retry feedback loop (what to do when tidy/build fails after adding @latest), which keeps it below anchor 5's 'feedback loops for error recovery'.

4 / 5

Progressive Disclosure

Clear overview with a well-signaled reference table: each of the six `references/*.md` files exists, has a one-line 'Use when' routing description, and (verified) contains no further nested references, so everything is exactly one level deep. Cross-references to sibling skills are cleanly separated, matching the anchor-5 exemplar of easy navigation with appropriately split content.

5 / 5

Total

18

/

20

Passed

Description

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

An exemplar description: it states concrete capabilities with named libraries, gives an explicit 'Use when' clause, and supplies a comprehensive list of natural trigger phrases scoped to the Go OTel niche. Only the broad catch-all trigger phrase marginally widens scope.

DimensionReasoningScore

Specificity

Lists multiple concrete capability areas with named specifics: "SDK setup, API surface, breaking changes, contrib instrumentation libraries (otelhttp, otelgrpc, otelmongo), compile-time zero-code instrumentation (otelc), and performance tuning". Comprehensive coverage of the skill's domain, matching the anchor-5 example's level of concreteness; not score 4 because no meaningful coverage gaps exist.

5 / 5

Completeness

Explicitly answers both what ("SDK setup, API surface, breaking changes, contrib instrumentation libraries..., compile-time zero-code instrumentation (otelc), and performance tuning") and when ("Use when adding, reviewing, or configuring OpenTelemetry in a Go service" plus a concrete trigger list). This mirrors the anchor-5 exemplar verbatim in structure; score 4 would require a weaker or less explicit 'when' clause, which is not the case.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage including synonyms and package names: "setup otel in go", "go telemetry", "go tracing", "otelconf go", "otelhttp", "otelgrpc", "TracerProvider go", "MeterProvider go", "otelc", "zero-code go instrumentation". These are the exact phrases a user would naturally say, matching anchor 5; nothing common is missing.

5 / 5

Distinctiveness Conflict Risk

Clear niche — OpenTelemetry specifically in Go — with highly distinct triggers (otelhttp, otelgrpc, otelc, otelconf go) that no sibling skill would claim. The "any Go-related OTel question" catch-all slightly broadens scope, but the language scoping keeps conflict risk minimal, fitting anchor 5 better than anchor 4's 'minor overlap risk with closely related skills'.

5 / 5

Total

20

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
ollygarden/opentelemetry-agent-skills
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.