CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

otel-collector

Expert guidance for configuring and deploying the OpenTelemetry Collector. Use when setting up a Collector pipeline, configuring receivers, exporters, or processors, deploying a Collector to Kubernetes or Docker, or forwarding telemetry to Dash0. Triggers on requests involving collector, pipeline, OTLP receiver, exporter, or Dash0 collector setup.

Quality

88%

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.

The SKILL.md body is well-crafted: an executable quick-start config, non-obvious expert rules (component naming, version requirements, queue persistence), and a workflow with explicit validation and verification checkpoints. Its main defects are the redundant dual navigation tables and, critically, that every referenced rule file is missing from the bundle, leaving the disclosed detail layer unreachable.

Suggestions

Ship the referenced bundle files: all twelve ./rules/*.md links (receivers, exporters, processors, pipelines, deployment and its four sub-files, sampling, red-metrics, custom-distributions) currently point to files that do not exist in the bundle — either include them or inline the critical guidance.

Merge the 'Rules' and 'Quick reference' tables into one navigation section; they map the same files twice and cost ~20 lines of token budget without adding new information.

Add an explicit error-recovery note after the 'Validate locally' step (e.g., what to check when `otelcol validate` fails) to complete the feedback loop.

DimensionReasoningScore

Conciseness

The body is dense and earns its tokens — the Quick Start YAML, processor-ordering rules, canonical-vs-deprecated component names, and version pinning with exact error messages are non-obvious, high-value content. It falls short of lean/5 because the ~23-row "Quick reference" table substantially duplicates the "Rules" table (both navigate to the same rule files), and a few key-principle justifications could be trimmed.

4 / 5

Actionability

The Quick Start is a complete, copy-paste-ready YAML config for the most common case (OTLP in → memory_limiter → OTLP/gRPC to Dash0 with persistent queue), followed by concrete commands: `otelcol validate --config=config.yaml`, the `debug` exporter verification step, and a specific image version to pin (v0.163.1). This matches the fully-executable anchor covering common cases.

5 / 5

Workflow Clarity

The "Configuration workflow" gives a clear four-step sequence with two explicit checkpoints: validate locally before deploying (step 2) and verify telemetry flow with the debug exporter before going to production (step 4, including removing it afterward). This matches the anchor for a clear sequence with explicit validation steps; a 4 would require a missing checkpoint, which is not the case.

5 / 5

Progressive Disclosure

The structure and signaling are excellent — a Rules table, a task-oriented Quick reference, and one-level-deep links (including an anchor link `processors.md#sensitive-data-redaction`) — but none of the twelve referenced `./rules/*.md` files exist in the bundle (no rules/, references/, scripts/, or assets/ directories are present), so the navigation does not resolve to real content. Per the judging guideline to score against the actual bundle structure, this lands at the midpoint: good structure, but the progressive-disclosure system is non-functional as shipped.

3 / 5

Total

17

/

20

Passed

Description

88%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: it states concrete capabilities in third person, has an explicit and specific "Use when..." clause plus a dedicated triggers sentence, and is firmly positioned in the OTel Collector/Dash0 niche. Its only weaknesses are a few missing natural trigger variants and slightly generic words like "pipeline" among the triggers.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "setting up a Collector pipeline, configuring receivers, exporters, or processors, deploying a Collector to Kubernetes or Docker, or forwarding telemetry to Dash0" — covering configuration, deployment, and export comprehensively, matching the anchor for multiple specific concrete actions. It exceeds the score-4 anchor because no meaningful capability area of the skill (receivers, processors, exporters, pipelines, deployment targets, Dash0 export) is left unmentioned.

5 / 5

Completeness

It explicitly answers both questions: the "what" ("Expert guidance for configuring and deploying the OpenTelemetry Collector") and a full "Use when..." clause with concrete triggers, plus an explicit "Triggers on requests involving collector, pipeline, OTLP receiver, exporter, or Dash0 collector setup" sentence. This matches the score-5 anchor exactly; score 4 would require the "when" to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Trigger terms are natural and well-covered: "collector", "pipeline", "OTLP receiver", "exporter", "Dash0 collector setup", "Kubernetes", "Docker", "OpenTelemetry Collector" — phrases a user would plausibly say. It falls short of the score-5 anchor because a few natural variants are missing, e.g. "otel"/"OTel", "telemetry pipeline", or "observability" phrasing.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — OpenTelemetry Collector configuration/deployment with Dash0 export — anchored by distinctive terms like "OTLP receiver" and "Dash0". However, bare trigger words "collector", "pipeline", and "exporter" are generic and could also fire on CI/CD pipeline or data-pipeline requests, giving minor overlap risk with closely related skills, which matches the score-4 anchor rather than the minimal-conflict score-5 anchor.

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

relative_links

Relative link issues: 40 missing, 15 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

dash0hq/agent-skills

Path

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