CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

73

Quality

92%

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 well-structured entry-point skill: copy-paste-ready commands, a genuinely non-obvious module-versioning trap, explicit verification for upgrade reviews, and a verified one-level-deep reference routing table. The only improvements are minor trimming of the versioning 'trap' prose and adding an error-recovery loop after verification steps.

Suggestions

Tighten the module-versioning section: the 'The trap' paragraph and the trailing sentence 'Hand-picking and re-guessing each @vX is the churn to avoid' restate the same point; one of them can be cut.

Add a brief error-recovery step after the verification commands (e.g. what to inspect and retry when `go build ./...` or `go test ./...` fails after a version bump), which would raise workflow clarity to the top anchor.

DimensionReasoningScore

Conciseness

The body is efficient and assumes competence — it never explains what OpenTelemetry or tracing is — with dense tables and a non-obvious module-versioning gotcha. However, 'The trap' paragraph restates the versioning point twice ("Hand-picking and re-guessing each @vX is the churn to avoid") and an inline dated fact ("verified 2026-10-15") could be trimmed, matching 'efficient; minor instances of over-explanation'. Not 5 because those few tokens could be cut; not 3 because there is no genuinely unnecessary explanation.

4 / 5

Actionability

Fully executable guidance: copy-paste `go get ...@latest` commands per module group, `gh api repos/.../releases/latest -q '.tag_name'`, a version-sorted tag command, WebFetch CHANGELOG URLs, and a concrete verification path (`go mod tidy -diff`, `go build ./...`, `go test ./...`) — covering the common cases. Not 4 because commands are complete and specific with no gaps.

5 / 5

Workflow Clarity

The reference-routing table, the ordered 'read before adding dependencies' → `go get` → `go mod tidy && go build ./...` procedure, and the explicit upgrade-review verification path ('always finish with a safe local verification path... never a deployment endpoint') give a clear sequence with most checkpoints. Not 5 because there is no error-recovery feedback loop (what to do when the build or verification fails); not 3 because validation checkpoints are explicit, not implicit.

4 / 5

Progressive Disclosure

Verified against the actual bundle: all six files in the References table exist in references/, are one level deep (only lateral cross-links between sibling reference files, e.g. breaking-changes.md → performance.md), and each row carries a clear 'Use when' condition. The body keeps overview-level content (routing, versioning gotcha, sources of truth) appropriately inline. Matches 'clear overview with well-signaled one-level-deep references; easy navigation'.

5 / 5

Total

18

/

20

Passed

Description

96%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: concrete capability list in third person, an explicit 'Use when' clause, and a rich set of natural trigger phrases covering synonyms and package names. The only weakness is minor trigger overlap with closely related sibling OTel skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions — "SDK setup, API surface, breaking changes, contrib instrumentation libraries (otelhttp, otelgrpc, otelmongo), compile-time zero-code instrumentation (otelc), and performance tuning" — with named packages, in third person, giving comprehensive coverage. Not 4 because coverage is broad and every action is concrete, not just 'several specific actions with minor gaps'.

5 / 5

Completeness

Explicitly answers both: what ("SDK setup, API surface, breaking changes, contrib instrumentation libraries..., and performance tuning") and when ("Use when adding, reviewing, or configuring OpenTelemetry in a Go service. Triggers on...") with concrete trigger phrases. Not 4 because the 'when' clause is fully explicit, not merely present.

5 / 5

Trigger Term Quality

Twelve explicit natural trigger phrases ("setup otel in go", "go telemetry", "go tracing", "otelhttp", "otelgrpc", "TracerProvider go", "otelc", "zero-code go instrumentation", "go build instrumentation") plus a catch-all "any Go-related OTel question" — comprehensive coverage including synonyms, package names, and API types. Not 4 because the list goes well beyond 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

The Go scoping on nearly every trigger establishes a clear niche, but triggers like "otelconf go" and the SDK-setup capability overlap with closely related sibling OTel skills (otel-declarative-config, otel-sdk-versions) that the body cross-references — matching 'mostly distinct; minor overlap risk with closely related skills'. Not 5 because that overlap with sibling skills is real; not 3 because the Go qualifier keeps conflict risk minor rather than broad.

4 / 5

Total

19

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

ollygarden/opentelemetry-agent-skills

Path

skills/otel-go/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.