CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

otel-semantic-conventions

OpenTelemetry semantic convention lookup and naming guidance. Use when selecting released semantic convention groups, attributes, or span naming rules, when checking semantic convention compliance, or checking which semantic-conventions version a language SDK's semconv package exposes.

71

Quality

89%

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

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.

An efficient, highly actionable skill body: exact executable commands, a clear five-step workflow, and well-signaled references that all resolve to real one-level-deep bundle files. The only weaknesses are minor — inline time-sensitive version/date details and a validation loop scoped to script maintenance rather than task output.

DimensionReasoningScore

Conciseness

Lean and imperative throughout — no background concepts explained, every bullet instructs — but the time-sensitive details ('no tagged release as of 2026-10-19', 'after v1.42.0') sit inline in the workflow rather than in a deprecated/old-patterns section, a minor instance of content that could be trimmed or relocated.

4 / 5

Actionability

Fully executable, copy-paste-ready commands with exact arguments for every common case ('--groups', 'http', 'http spans', 'http http.request.method'), plus env-var setup, a test-script invocation, and concrete decision rules for naming and attribute selection.

5 / 5

Workflow Clarity

Five clearly sequenced steps with an explicit output-specification step ('include the group name, released version, and source URL'), but the only feedback loop ('after changing the parser, run ... test script') covers script maintenance rather than validating the task result mid-flow — a minor validation gap.

4 / 5

Progressive Disclosure

A 42-line overview body that clearly signals one-level-deep references ('see references/semconv-selection.md', 'to target a version ... see references/sdk-semconv-packages.md'); all referenced bundle files exist and the references point only to scripts and external URLs, with detail appropriately split out of SKILL.md.

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 with an explicit 'Use when...' clause covering three concrete trigger scenarios and a clear, distinctive niche. The main improvement opportunity is slightly more concrete phrasing of the core capability and a few additional natural synonyms.

DimensionReasoningScore

Specificity

Enumerates several concrete tasks — 'selecting released semantic convention groups, attributes, or span naming rules', 'checking semantic convention compliance', 'checking which semantic-conventions version a language SDK's semconv package exposes' — though the core 'what' ('semantic convention lookup and naming guidance') is slightly generic rather than a fully comprehensive concrete action list.

4 / 5

Completeness

Clearly answers both: the 'what' ('OpenTelemetry semantic convention lookup and naming guidance') and an explicit 'Use when...' with three concrete trigger clauses, matching the both-what-and-when-with-trigger-phrases anchor exactly.

5 / 5

Trigger Term Quality

Good coverage of natural terms users in this domain would say ('semantic convention', 'attributes', 'span naming rules', 'compliance', 'semconv package', 'SDK'), but misses common variations such as 'otel' or 'instrumentation naming', so it falls just short of the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

Clear niche (OpenTelemetry semantic conventions) with distinct, domain-specific triggers ('semconv package', 'span naming rules', 'semantic convention compliance'), making conflict with other skills unlikely.

5 / 5

Total

18

/

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

Path

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