CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

75

Quality

94%

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 dense, well-engineered skill body: an unambiguous routing workflow with verification and fallback, a fact-rich component index, and a disciplined authoring recipe for extensions. Its weaknesses are token weight in index-row summaries that belong in per-component detail files, and a progressive-disclosure structure whose referenced bundle files are absent.

Suggestions

Trim the Component index summaries to one-line routing facts and move version-history and config-detail items (rename chronology, gate names like `pkg.exporterhelper.queueBatchEnabled`) into each component's quirks.md/configuration.md, keeping the index the pure routing aid the skill itself prescribes.

Ship the referenced `components/<type>/` bundle (README plus configuration.md, quirks.md, verification.md, advanced.md) so the Details-index navigation resolves; without these files the index rows and verification recipes are unverifiable.

Consider moving the 'Adding a new component to this skill' maintainer recipe into a separate file (e.g. components/README.md), since it is authoring-time guidance rather than answer-time context and competes for the always-loaded token budget.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence — no generic OTel/YAML exposition — and every line carries skill-specific facts ("Default endpoint is `localhost`, not `0.0.0.0`"). However, index-row summaries duplicate detail the skill's own philosophy reserves for detail files (e.g. "v0.158 replaced `extract_parameters` / `params_attribute` with `masking_rules`…", "`sending_queue.batch` is opt-in unless the `pkg.exporterhelper.queueBatchEnabled` gate is enabled"), so minor trimming is possible. Fits the 4 anchor (efficient, minor over-explanation to trim); not 5 because those summaries exceed a pure routing aid, and not 3 because nothing is padded or already-known.

4 / 5

Actionability

Concrete and executable throughout: exact paths to read ("read `components/<type>/README.md` first"), a copy-paste named-instances YAML block, explicit fallback ("fall back to the upstream component README under `processor/<name>/`…"), and runnable commands ("`otelcol-contrib --config <file>.yaml`"). Matches the 5 anchor (specific guidance covering the common cases); not 4 because no significant execution gap exists in what is written.

5 / 5

Workflow Clarity

The 5-step Workflow is clearly sequenced with an explicit validation step ("**Verify.** Run the component page's **Verification** recipe") and error-recovery paths ("**If the component is not indexed**, say so explicitly and fall back…"), plus a 3-step Verification harness procedure. Matches the 5 anchor (explicit validation, feedback guidance); not 4 because checkpoints are present at every risky decision point.

5 / 5

Progressive Disclosure

The design is exemplary one-level-deep disclosure — lean per-component READMEs with a Details index ("`configuration.md` for versioned keys… `quirks.md` for stability…") and a clear routing table — but the referenced `components/<type>/` files (README, configuration.md, quirks.md, verification.md) are not present in the bundle, so the navigation chain cannot actually resolve. Fits the 4 anchor (good structure, minor organization gaps); not 5 because well-signaled references must lead somewhere real, and not 3 because the in-skill structure itself is clearly signaled and appropriately split.

4 / 5

Total

18

/

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.

The description is a model example: third-person, explicit what-and-when, dense with the exact natural trigger terms of the OpenTelemetry Collector domain, and cleanly scoped to component-level configuration. No fluff or over-claims.

DimensionReasoningScore

Specificity

"Authoring, reviewing, or debugging Collector YAML" names three concrete actions, and "config keys, defaults, validation rules, signal support, stability levels, and component-level gotchas" enumerates comprehensive coverage areas. This matches the 5 anchor (multiple specific concrete actions, comprehensive) and not 4, since no meaningful capability area of the niche is missing.

5 / 5

Completeness

What is explicit ("OpenTelemetry Collector component configuration" with enumerated coverage) and when is doubly explicit: "Use when authoring, reviewing, or debugging Collector YAML for a specific receiver…" and "Triggers on Collector component questions including…". Matches the 5 anchor; not 4 because the 'when' clause is already concrete rather than merely present.

5 / 5

Trigger Term Quality

Natural terms an OTel user would say appear in both singular and plural trigger form: "receiver, processor, exporter, connector, or extension" plus "receivers, processors, exporters, connectors, extensions, component renames, signal support, and pipeline wiring" and "Collector YAML". Matches the 5 anchor's comprehensive synonym coverage; not 4 because the full role vocabulary of the domain is present.

5 / 5

Distinctiveness Conflict Risk

"OpenTelemetry Collector" plus the component-role vocabulary carves a clear niche unlikely to fire for unrelated skills. Matches the 5 anchor (clear niche, distinct triggers, minimal conflict risk); not 4 because the domain name and trigger terms are unambiguous.

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 missing

Warning

Total

15

/

16

Passed

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