CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

o11y-dev/opentelemetry-skill

Expert OpenTelemetry guidance for collector configuration, pipeline design, and production telemetry instrumentation across Kubernetes, ECS, serverless, and standalone deployments. Use when configuring collectors, designing pipelines, instrumenting applications, implementing sampling, managing cardinality, securing telemetry, writing OTTL transformations, or setting up AI coding agent observability (Claude Code, Codex, Gemini CLI, Antigravity, GitHub Copilot).

97

1.07x
Quality

95%

Does it follow best practices?

Impact

98%

1.07x

Average score across 27 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Overview
Quality
Evals
Security
Files

Quality

Content

92%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 skill body: dense directive guardrails, a validation-first workflow with feedback loops, and an excellent trigger-table index into a complete one-level-deep reference bundle. The only deduction is for inline version-pinned statements that belong in the compatibility reference.

DimensionReasoningScore

Conciseness

The body is lean and directive-only — no explanation of concepts Claude already knows — but it pins specific version numbers inline ("tail_sampling is Beta in Collector 0.160", plus SDK 1.44/1.45 and OTel JS 3.0 mentions) outside any deprecated/old-patterns section, which the time-sensitive guideline penalizes. This fits the score-4 anchor ("efficient; minor instances that could be trimmed" — e.g., moving the 0.160 stability pin into compatibility.md) rather than score 5's every-token-earns-its-place.

4 / 5

Actionability

Guidance is concrete and executable throughout: "run `otelcol validate --config <path>`", "default to OTLP gRPC (4317)", "put `memory_limiter` first in every pipeline", "CLAUDE_CODE_ENABLE_TELEMETRY=1", "routing_key: traceID", "clusterIP: None". Specific commands, ports, config keys, and env vars cover the common cases, matching the score-5 anchor.

5 / 5

Workflow Clarity

The 5-step workflow includes an explicit validation checkpoint with a feedback loop ("Fix reported failures and repeat the affected check; if blocked, report the exact failure and remaining verification") and separates config validity from observed end-to-end delivery in step 5, matching the score-5 anchor's sequence-with-explicit-validation-and-error-recovery.

5 / 5

Progressive Disclosure

The trigger table maps keywords to all 21 references, each verified to exist and one level deep (the only cross-pointer found is a sibling link in ai-agents.md to security.md). Content is appropriately split between overview guardrails and detailed references, matching the score-5 anchor's clear overview with well-signaled one-level-deep references and easy navigation.

5 / 5

Total

19

/

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.

An exemplary description: concrete actions, an explicit 'Use for...' trigger clause, and dense keyword coverage including synonyms, file patterns, and named products. The only weakness is a slight risk of triggering on generic Kubernetes/Helm or AI-agent requests that aren't observability-related.

DimensionReasoningScore

Specificity

The description lists four concrete actions — "Build OpenTelemetry collector configs, instrument services, transform telemetry with OTTL, and debug missing traces, metrics, or logs" — which comprehensively cover the skill's surface (build, instrument, transform, debug). It clearly matches the score-5 anchor ("multiple specific concrete actions; comprehensive coverage") and exceeds the score-4 anchor, which requires minor coverage gaps.

5 / 5

Completeness

It opens with a clear what-statement and follows with an explicit "Use for..." clause listing concrete triggers, matching the score-5 anchor example structure exactly. The score-4 anchor ("'when' could be more explicit or specific") does not apply since the when-clause enumerates specific scenarios.

5 / 5

Trigger Term Quality

Trigger coverage includes synonyms ("OTel/otelcol"), file patterns ("values.yaml"), domain phrases ("OTLP export, sampling, cardinality, TLS/PII controls, collector health and alerts"), and named products ("Claude Code, Codex, Gemini CLI, Antigravity, GitHub Copilot, Cursor") — comprehensive natural terms including synonyms and file extensions, matching the score-5 anchor rather than the score-4 anchor ("a few natural terms missing").

5 / 5

Distinctiveness Conflict Risk

The OpenTelemetry niche is clear with distinct triggers, but "Kubernetes/Helm values.yaml deployments" in the when-clause could pull this skill for a generic Helm chart request, and the AI-agent product names overlap with general AI-agent tooling requests — minor overlap risk with closely related skills, fitting the score-4 anchor rather than score 5's "minimal conflict risk".

4 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Reviewed

Table of Contents