CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

otel-collector

OpenTelemetry Collector component configuration. Use when authoring, reviewing, or debugging Collector YAML for a specific receiver, processor, exporter, connector, or extension — config keys, defaults, validation rules, signal support, stability levels, and component-level gotchas. Triggers on Collector component questions including receivers, processors, exporters, connectors, extensions, component renames, signal support, and pipeline wiring.

74

Quality

93%

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

88%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 well-engineered reference skill: a concrete read-first workflow with explicit verification, dense versioned facts Claude cannot recall from memory, and a clean lean-README-plus-detail-files disclosure design. Weaknesses are minor: some guidance is duplicated between the index table and the conventions sections, and the component detail files the whole workflow depends on were absent from the bundle as reviewed.

Suggestions

Deduplicate the exporter sending-queue guidance: the `sending_queue.batch` opt-in / `pkg.exporterhelper.queueBatchEnabled` gate note appears in both the `otlp_grpc` index row and the "Pipeline placement" section — keep it in one place and cross-reference.

Ship and verify the `components/<type>/` detail files (`configuration.md`, `verification.md`, `quirks.md`, ...): none were present in the reviewed bundle, so the workflow's core step ("always read `components/<type>/README.md` first") currently points at files that could not be confirmed to exist.

DimensionReasoningScore

Conciseness

Overall lean and information-dense — the component index rows carry versioned facts ("Renamed from `logdedup` in v0.151.0; alias preserved", "v0.158 replaced `extract_parameters` ... with `masking_rules`") that Claude cannot know, and version-sensitive facts are consolidated under sections like "Recent renames". Minor duplication keeps it below the top anchor: the `otlp_grpc` sending-queue/batching guidance ("`sending_queue.batch` ... opt-in unless the `pkg.exporterhelper.queueBatchEnabled` gate is enabled") appears in both the index row and again in "Pipeline placement", and the `memory_limiter` guidance is likewise restated.

4 / 5

Actionability

Guidance is fully concrete and executable: exact file paths and reading order ("always read `components/<type>/README.md` first ... read `configuration.md` for versioned keys ... `quirks.md` for stability"), a concrete fallback ("fall back to the upstream component README under `processor/<name>/` ... in opentelemetry-collector-contrib"), a copy-paste-ready named-instances YAML example, and runnable verification commands ("`otelcol-contrib --config <file>.yaml`" with OCB as the fallback). Specific examples cover the common cases for an instruction/reference skill.

5 / 5

Workflow Clarity

A clear 5-step sequence (identify component → load component page → fallback if not indexed → apply conventions → verify) with an explicit validation checkpoint ("Run the component page's Verification recipe — `telemetrygen` ... plus a `debug` or `file` exporter — to confirm the component behaves as the docs claim") and error-recovery paths (what to do when the component is not indexed, and building a custom collector with OCB when it is not in a distribution). Includes a caveat against copying minimal-repro configs to production.

5 / 5

Progressive Disclosure

The structure is exemplary — a lean routing index in SKILL.md, one-level-deep references to per-component detail files ("`configuration.md` — config keys, defaults, validation", "`quirks.md` — gotchas, stability caveats"), and a documented on-demand reading model. However, the referenced `components/<type>/` files are not present in the reviewed bundle (no `components/`, `references/`, `scripts/`, or `assets/` directories exist), so the Details-index navigation could not be verified against actual files — more than a purely organizational gap, but well above the 'references not clearly signaled' anchor.

4 / 5

Total

18

/

20

Passed

Description

96%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 capability list, explicit "Use when" trigger clause with natural component-kind keywords, and third-person voice. The only weakness is minor overlap risk with sibling OTel skills (OTTL, pipeline design) that the description leaves unbounded.

DimensionReasoningScore

Specificity

Lists multiple concrete actions and artifacts: "authoring, reviewing, or debugging Collector YAML for a specific receiver, processor, exporter, connector, or extension" with a concrete capability surface — "config keys, defaults, validation rules, signal support, stability levels, and component-level gotchas". Matches the anchor for comprehensive, specific concrete actions; nothing is vague or padded.

5 / 5

Completeness

Explicitly answers both: what — "OpenTelemetry Collector component configuration ... config keys, defaults, validation rules, signal support, stability levels"; and when — "Use when authoring, reviewing, or debugging Collector YAML" plus a second explicit trigger sentence ("Triggers on Collector component questions including ..."). Matches the anchor requiring both what and when with concrete trigger phrases; third-person voice is used throughout.

5 / 5

Trigger Term Quality

"Collector YAML", "receivers, processors, exporters, connectors, extensions", "component renames", "signal support", and "pipeline wiring" are exactly the natural terms a Collector user would say, covering the component kinds in both singular and plural. Comprehensive natural-term coverage; no generic filler.

5 / 5

Distinctiveness Conflict Risk

The niche is clear (per-component Collector configuration) with kind-specific triggers, so it is well above the 'somewhat specific' anchor. However, "processors" and "pipeline wiring" as triggers overlap with closely related skills in the same family (e.g. `otel-ottl` for transform/filter OTTL conditions, pipeline-design skills), and the description itself does not carve out those boundaries — a minor overlap risk rather than minimal.

4 / 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: 1 missing

Warning

Total

15

/

16

Passed

Repository

ollygarden/opentelemetry-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.