CtrlK
BlogDocsLog inGet started
Tessl Logo

otel-sdk-versions

OpenTelemetry SDK and package version lookup across languages. Use when choosing the latest compatible released OpenTelemetry SDK or package version and locating setup docs or examples.

70

Quality

86%

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

85%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 lean, well-structured lookup skill: a clear 5-step workflow with explicit edge-case handling for incompatibility, companion packages, and missing entries, backed by a single verified one-level-deep generated reference holding the time-sensitive version table. Minor improvements possible: trim step 4's column restatements and specify the lookup mechanism for companion packages not in the index.

DimensionReasoningScore

Conciseness

The body is lean and imperative with no concept explanations ("Open `references/generated/otel-version-index.md`", "prefer the latest released version when it is compatible"). Minor over-explanation: step 4's sub-bullets restate what the index column headers already say ("use the Setup Docs column for SDK setup guidance"), and the opening line duplicates the frontmatter description. Anchor 4 rather than 5 due to these trimmable tokens, not 3 because there is no real padding.

4 / 5

Actionability

Concrete guidance throughout: an exact reference path (verified to exist), explicit decision rules ("if the latest release is not compatible, choose the latest compatible version and state the compatibility reason explicitly"), and explicit gap fallback ("fall back to the official release source and official docs"). Minor gap: companion-package lookup says "look up their versions from the release source" without the specific mechanism for packages absent from the index. Mostly executable with a minor gap fits anchor 4; not 3 since nothing is vague or pseudocode.

4 / 5

Workflow Clarity

Five clearly sequenced steps with explicit branches for incompatibility ("state the compatibility reason explicitly"), companion packages, and missing entries ("Handle gaps explicitly"). This is a single-purpose lookup skill with no destructive or batch operations, so no validation cap applies, and the workflow is unambiguous — matching anchor 5 under the simple-skill guidance.

5 / 5

Progressive Disclosure

SKILL.md is a concise overview pointing to a single well-signaled reference, `references/generated/otel-version-index.md`, which exists, is one level deep, and contains exactly the Release Source / Setup Docs / Examples columns the body cites. Time-sensitive version data is correctly kept in the generated reference rather than inlined. This matches anchor 5's clear overview with well-signaled one-level-deep references.

5 / 5

Total

18

/

20

Passed

Description

87%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 that explicitly states both what (OTel SDK/package version lookup) and when (choosing a compatible released version, locating setup docs/examples) in third person with natural trigger terms. Minor gaps: no synonyms/abbreviations ("otel", "instrumentation") and the companion-package capability from the body is not surfaced.

DimensionReasoningScore

Specificity

Lists several concrete actions — "version lookup across languages", "choosing the latest compatible released ... version", "locating setup docs or examples" — matching the anchor for several specific actions with minor gaps (companion-package resolution and fallback handling are not surfaced). It is not 3 because it names more than 1-2 actions, and not 5 because coverage is not comprehensive.

4 / 5

Completeness

Explicitly answers both: what = "OpenTelemetry SDK and package version lookup across languages", and when = "Use when choosing the latest compatible released OpenTelemetry SDK or package version and locating setup docs or examples" with concrete trigger phrases. Matches the anchor-5 example structure; not 4 because the when-clause is explicit and specific rather than weakly implied.

5 / 5

Trigger Term Quality

Natural domain phrases users would say are present ("OpenTelemetry SDK", "package version", "latest compatible released", "setup docs"), but common variations like "otel", "instrumentation", or "upgrade" are missing. Good coverage with a few natural terms missing fits anchor 4; not 5 since synonyms/abbreviations are not covered, not 3 since the key natural terms are all there.

4 / 5

Distinctiveness Conflict Risk

A clear niche (OpenTelemetry version lookup) with distinct triggers and third-person voice, unlikely to fire for unrelated or even adjacent OTel skills. Fits anchor 5's clear niche with minimal conflict risk; not 4 because the scope is tightly constrained to version selection and doc lookup.

5 / 5

Total

18

/

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 deeper-than-1-level

Warning

Total

15

/

16

Passed

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.