CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

otel-ottl

OpenTelemetry Transformation Language (OTTL) expert for writing and debugging telemetry transformations in the OpenTelemetry Collector. Use when authoring or reviewing `transform`, `filter`, `tail_sampling` processor configs or `routing` connector configs, debugging OTTL syntax or semantics, transforming traces, metrics, logs, or profiles, or converting data-processing requirements into OTTL statements.

76

Quality

96%

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

93%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 tightly written, knowledge-dense skill: concise, highly actionable, with a clear five-step workflow ending in explicit verification and excellent one-level-deep reference structure. The only notable gap is that the workflow's verification step lacks an explicit fix-and-re-verify feedback loop.

Suggestions

Close the feedback loop in Workflow step 5: state what to do when the file-exporter output doesn't match expectations (revise the statement, re-run telemetrygen, re-inspect) rather than only describing the verification itself.

Reference the quick-reference's safe skeletons and troubleshooting flow from the Workflow's error-behavior step, so a failed end-to-end verification has a pointed next step inside the skill bundle.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious, version-specific knowledge (error-mode semantics, feature-gate history, YAML `$${1}` escaping, RE2 repetition limits, path spellings) and never explains concepts Claude already knows, e.g. it never describes what OpenTelemetry is. Every section carries earned tokens; the one grounding sentence ('OTTL transforms or selects telemetry inside Collector components') is a single line.

5 / 5

Actionability

Guidance is concrete and executable throughout: exact function identifiers (`set`, `delete_key`, `ParseJSON`, `Decode(value, "base64")`, `truncate_all`), exact paths (`span.cache["parsed"]`, `otelcol.client.metadata["X-Tenant"][0]`), exact error-mode values (`ignore`/`silent`/`propagate`), a copy-paste OTTL statement, and a precise YAML-quoting example (`'set(log.attributes["a"], {"foo": "bar"})'`). Per the scoring notes for instruction-only skills, this concrete guidance matches the fully-actionable anchor.

5 / 5

Workflow Clarity

The five-step workflow is clearly sequenced with an explicit final validation step ('Verify end to end... send known telemetry and inspect file-exporter output') and an inline decision rule ('If an identifier is absent, treat it as unsupported'). It falls short of the 5 anchor only because the error-recovery feedback loop is implicit — step 5 says to verify but not what to do when output doesn't match (fix and re-verify).

4 / 5

Progressive Disclosure

The body is a concise overview pointing to three one-level-deep reference files, each described with its contents ('Contexts — exact paths, hierarchy, enums, and request metadata'), and instructs reading only the relevant section. All three referenced files exist, are well-organized with headers, and the deep link `references/functions.md#feature-gates-verified-2026-10-15` resolves to a real heading; always-needed traps stay inline while catalogs are split out.

5 / 5

Total

19

/

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 exemplary description: it states concrete capabilities, includes an explicit 'Use when...' trigger clause with the domain's natural terminology, and occupies a distinct niche (OTTL in the OpenTelemetry Collector). It closely matches the rubric's good-overall pattern with no vague padding or over-claims.

DimensionReasoningScore

Specificity

Multiple concrete actions are enumerated — 'writing and debugging telemetry transformations', 'authoring or reviewing `transform`, `filter`, `tail_sampling` processor configs or `routing` connector configs', 'debugging OTTL syntax or semantics', 'transforming traces, metrics, logs, or profiles', and 'converting data-processing requirements into OTTL statements' — giving comprehensive coverage of the skill's capabilities, matching the 5 anchor rather than the 4 anchor's 'minor gaps'.

5 / 5

Completeness

Both halves are explicit: 'what' is stated concretely (expert for writing and debugging telemetry transformations, converting requirements into OTTL statements) and 'when' opens with a literal 'Use when...' clause listing concrete triggers (authoring/reviewing the named configs, debugging OTTL syntax or semantics, transforming the four signal types).

5 / 5

Trigger Term Quality

It covers the natural vocabulary of this domain comprehensively: the language name and acronym ('OpenTelemetry Transformation Language (OTTL)'), the exact component names users say ('transform', 'filter', 'tail_sampling', 'routing'), the signal types ('traces, metrics, logs, or profiles'), and both 'syntax or semantics' debugging. A user needing this skill would naturally use these terms.

5 / 5

Distinctiveness Conflict Risk

OTTL authoring/debugging is a clear niche with triggers scoped to four named Collector components, so it is unlikely to fire for unrelated skills. Overlap with a general Collector-configuration skill is possible but minor since the description anchors on the transformation language and its specific components.

5 / 5

Total

20

/

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: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

ollygarden/opentelemetry-agent-skills

Path

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