CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

otel-semantic-conventions

OpenTelemetry Semantic Conventions expert. Use when selecting, applying, or reviewing telemetry attributes. Triggers on tasks involving attribute selection, semantic convention compliance, attribute migration, or custom attribute decisions. Covers the attribute registry, naming patterns, attribute placement, and versioning. For span names, span kinds, and span status codes, see the otel-instrumentation skill.

1.39x
Quality

84%

Does it follow best practices?

Impact

96%

1.39x

Average score across 12 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is dash0/agent-skills

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 body is a well-organized, mostly lean overview with executable correct/incorrect examples and a clear five-step attribute-selection procedure. Its main defect is that the progressive-disclosure layer is broken: all three rule files it links to (attributes, versioning, dash0) are absent from the bundle, so the detailed guidance the skill exists to provide is unreachable, and secondary inline content (registry examples, validation steps) is not present to compensate.

Suggestions

Ship the referenced bundle files (rules/attributes.md, rules/versioning.md, rules/dash0.md) or inline the essential per-domain attribute tables into SKILL.md so the detail layer is actually reachable.

Remove the redundancy: the Attribute Registry URL appears twice (intro and 'Official documentation') and step 5 repeats step 1's custom-attribute caveat — state it once.

Add an explicit validation checkpoint to the selection workflow, e.g., a final step re-verifying the chosen attribute name against the registry (and against dash0 derived attributes) before use.

DimensionReasoningScore

Conciseness

The body is mostly lean: a rules table, a five-step selection procedure, and three compact correct/incorrect examples, with no padding explaining what OpenTelemetry is. Minor trimmable redundancy keeps it below a 5: step 5 repeats step 1's caveat almost verbatim ("Only create a custom attribute if no registry entry covers the concept" vs. "only create a custom attribute when no registry entry covers the concept"), and the Attribute Registry URL appears twice (in the intro and again under 'Official documentation'). This matches the score-4 anchor ('Efficient; minor instances of over-explanation that could be trimmed') — not 3 because there is no genuinely unnecessary explanation block, and not 5 because the duplication is real.

4 / 5

Actionability

The three code examples are concrete and executable with correct/incorrect contrasts ("span.set_attribute(\"http.request.method\", \"GET\")" vs. "span.set_attribute(\"custom.http.verb\", \"GET\")"), and step 5 gives a concrete naming pattern ("org.namespace.attribute_name"). However, the actual per-domain attribute detail ("HTTP/DB/messaging/RPC attributes" per the rules table) is delegated to ./rules/attributes.md, which does not exist in the provided bundle, so the skill's core deliverable — which registry attribute to use — is not reachable. This matches the score-4 anchor ('Mostly executable guidance; concrete code or commands with minor gaps') — not 5 because the key reference material is missing, not 3 because what is inline is real, executable code rather than pseudocode.

4 / 5

Workflow Clarity

"How to select the right attribute" is a clear, well-ordered five-step sequence, and steps 1–2 ('Search the registry first', 'Check stability') function as checkpoints. It matches the score-4 anchor ('Clear sequence with most checkpoints present; minor validation gaps'): there is no explicit validation/feedback step (e.g., re-verify the chosen attribute against the registry, or how to validate during a version migration). It is not 5 because no explicit verify-and-recover loop exists, and not 3 because the sequence is complete and the checkpoints are more than implicit. The destructive/batch cap does not apply — this is a selection/review task, not a destructive operation.

4 / 5

Progressive Disclosure

The SKILL.md itself is structured well — a Rules table linking "[attributes](./rules/attributes.md)", "[versioning](./rules/versioning.md)", and "[dash0](./rules/dash0.md)" with use cases, plus clearly signaled official documentation links, all one level deep. However, none of the three referenced rule files exist in the provided bundle (no rules/, references/, scripts/, or assets/ directories are present), so every path to the skill's detail layer is broken at the first hop. Per the judging guideline to score against the actual bundle structure, clearly signaled references pointing at missing files leave navigation failing, which sits below the score-4 anchor ('minor organization gaps') and at/below the score-3 anchor ('Some structure but could be better organized'). Not a 4 or 5 because the disclosure model does not actually work when followed; not a 2 because the SKILL.md-level structure itself is well organized and the references are prominently signaled rather than buried.

3 / 5

Total

15

/

20

Passed

Description

92%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, third-person, with explicit 'Use when'/'Triggers on' clauses covering both what and when, plus explicit disambiguation from a sibling OTel skill. The only weakness is that some trigger phrasing (e.g., 'semantic convention compliance') is more formal than the vocabulary users naturally type, and common synonyms like 'otel attributes' or 'span/resource attributes' are missing.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "selecting, applying, or reviewing telemetry attributes", "attribute migration", "custom attribute decisions" — and enumerates coverage of "the attribute registry, naming patterns, attribute placement, and versioning". This is comprehensive, third-person coverage of the semconv domain with no gaps, matching the score-5 anchor ('Lists multiple specific concrete actions; comprehensive coverage'). It is not a 4 because nothing in the domain's core activities (selection, application, review, migration, naming, placement, versioning) is missing.

5 / 5

Completeness

It explicitly answers both questions: what ("OpenTelemetry Semantic Conventions expert... Covers the attribute registry, naming patterns, attribute placement, and versioning") and when ("Use when selecting, applying, or reviewing telemetry attributes. Triggers on tasks involving attribute selection, semantic convention compliance, attribute migration, or custom attribute decisions"). Both are explicit and concrete, matching the score-5 anchor. It is not a 4 because the 'when' is not merely present but spelled out with multiple concrete trigger phrases.

5 / 5

Trigger Term Quality

Keywords like "telemetry attributes", "attribute migration", and "attribute registry" are natural user phrasings, but the coverage misses common variations users would actually type: "otel attributes", "span attributes", "resource attributes", and looser phrasings like "naming convention". Phrases such as "semantic convention compliance" and "custom attribute decisions" skew formal rather than natural. This fits the score-4 anchor ('Good keyword coverage; a few natural terms missing') — not 5 because synonyms users commonly say are absent, not 3 because the core trigger vocabulary is present and relevant.

4 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche (OpenTelemetry semantic-convention attributes) and actively reduces conflict risk by deflecting the nearest neighbor: "For span names, span kinds, and span status codes, see the otel-instrumentation skill." This is distinct triggers with minimal conflict risk, matching the score-5 anchor; it is not a 4 because the boundary with the closest overlapping skill is explicitly drawn rather than merely implied.

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

relative_links

Relative link issues: 4 missing, 1 suspicious

Warning

Total

15

/

16

Passed

Repository

dash0hq/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.