CtrlK
BlogDocsLog inGet started
Tessl Logo

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, GitHub Copilot).

93

1.36x
Quality

92%

Does it follow best practices?

Impact

94%

1.36x

Average score across 18 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Overview
Quality
Evals
Security
Files

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-organized, highly actionable OTel skill with a copy-paste baseline config, explicit validation, and strong review checklists. Its main weaknesses are mild redundancy of critical-rule emphasis and five orphaned setup reference files that the body never links to.

Suggestions

Link the orphaned setup-* references (setup-index.md or the per-platform setup-docker/ecs/kubernetes/vm.md files) from the body — e.g. add a 'Deployment setup' row to the Context Triggers table pointing to setup-index.md — so all bundle files are discoverable from the overview.

Consolidate the memory_limiter-first rule and the gRPC/HTTP preference into a single canonical location, with other sections cross-referencing it, to reduce repetition and save tokens.

Consider adding one or two file-extension triggers (e.g. '.yaml', 'collector.yaml') to the description to push trigger-term coverage to comprehensive.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — it never explains what OpenTelemetry is — but it reinforces critical rules redundantly (memory_limiter-first appears in Core Principles, Eval-Critical Minimums, Baseline defaults, and Anti-Patterns; gRPC/HTTP in two places; cardinality in four), which is minor trimmable repetition; not 5 because of that redundancy, not 3 because there is no concept-padding.

4 / 5

Actionability

Provides a copy-paste-ready baseline YAML covering traces/metrics/logs pipelines, a concrete validation command ('otelcol validate --config <path>'), specific ports (4317/4318), explicit processor ordering, and stability caveats — fully executable guidance covering common cases; not 4 because the core artifact is complete and copy-paste ready with concrete commands.

5 / 5

Workflow Clarity

Clear sequenced workflows — a 5-step Pre-Flight Checklist ('If unknown, ask first'), a 9-point Review Mode audit, an explicit validation checkpoint, an error-recovery reference, and rich checklists for complex review processes — match the 5-anchor's explicit-validation + checklist criteria; not 4 because validation is explicitly required and recovery is signaled rather than merely implied.

5 / 5

Progressive Disclosure

A well-signaled trigger→reference table routes to 14 real one-level-deep reference files with no nested indirection, but 5 of 19 bundle files (setup-docker.md, setup-ecs.md, setup-kubernetes.md, setup-vm.md, setup-index.md) are never linked from the body, so a user cannot discover them from the overview — a minor organization gap; not 5 because of the orphaned setup files, not 3 because the trigger table and one-level structure are genuinely strong.

4 / 5

Total

18

/

20

Passed

Description

92%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, specific description that clearly states both what the skill does and when to use it, with rich natural trigger terms and a distinctive OTel/AI-agent niche. The only gap is the absence of file-extension triggers, which keeps trigger-term quality just short of comprehensive.

DimensionReasoningScore

Specificity

Lists many concrete actions across the OTel domain — 'collector configuration, pipeline design, and production telemetry instrumentation' plus 'configuring collectors, designing pipelines, instrumenting applications, implementing sampling, managing cardinality, securing telemetry, writing OTTL transformations' — which is comprehensive coverage matching the 5-anchor; not 4 because the action list is broad rather than having only minor gaps.

5 / 5

Completeness

Explicitly answers 'what' ('Expert OpenTelemetry guidance for collector configuration, pipeline design, and production telemetry instrumentation') and 'when' ('Use when configuring collectors, designing pipelines… or setting up AI coding agent observability') with concrete trigger phrases, matching the 5-anchor example closely; not 4 because the 'when' clause is detailed and explicit rather than merely present.

5 / 5

Trigger Term Quality

Strong natural keywords and synonyms (opentelemetry/otel/observability/telemetry) plus named tools (Claude Code, Codex, Gemini CLI, Copilot), but the 5-anchor explicitly requires file extensions (e.g. '.pdf') and none are present, so it sits at good-but-not-comprehensive coverage; not 3 because keyword coverage is clearly strong with synonyms.

4 / 5

Distinctiveness Conflict Risk

A clear OTel niche with distinctive triggers (OTTL, tail sampling, cardinality, named AI coding agents) and minimal conflict risk; not 4 because the distinctive sub-niches (OTTL transforms, AI-agent observability) anchor it clearly apart from a generic observability skill.

5 / 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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Reviewed

Table of Contents