CtrlK
BlogDocsLog inGet started
Tessl Logo

otel-python

OpenTelemetry in Python — SDK setup, declarative config, zero-code instrumentation (opentelemetry-instrument, opentelemetry-distro), contrib auto-instrumentation, manual API, performance tuning, breaking changes. Use when configuring or troubleshooting OpenTelemetry in a Python service. Triggers on "setup otel in python", "python telemetry", "python tracing", "opentelemetry-instrument", "opentelemetry-distro", "TracerProvider python", "MeterProvider python", "FastAPI/Flask/Django otel", "python logging bridge".

76

Quality

94%

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

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.

An exemplary router-style SKILL.md: lean, fully actionable fetch commands, unambiguous reference dispatch, and a clean one-level bundle with a sources-of-truth table for freshness. The only deduction is pinned version numbers in the Sources of Truth table, which will drift stale over time.

DimensionReasoningScore

Conciseness

The body is lean with zero concept explanations and every row earning its place (e.g., "Load a reference below based on the task; each reference is self-contained"), but the Sources of Truth table pins time-sensitive version numbers ("released 1.45.0" twice, "SDK CHANGELOG through 1.45.0", "Contrib CHANGELOG through 0.66b0") outside any old-patterns/deprecated section, which the rubric penalizes. Not level 3 because there is no unnecessary explanation or padding anywhere — the only deduction is the version pins, confined to a lookup table.

4 / 5

Actionability

Every entry is a concrete, copy-paste-ready command: exact WebFetch URLs with the JSON field to read ("WebFetch https://pypi.org/pypi/opentelemetry-sdk/json (.info.version)"), package-name templates ("opentelemetry-instrumentation-<pkg>"), and linked reference files. Fully executable guidance with no vague directions.

5 / 5

Workflow Clarity

The single action — select the correct reference — is unambiguous via the per-file "Use when" column covering config, API, instrumentation, performance, and breaking-change audits. This is a single-purpose router with no destructive or batch operations, so the simple-skill exception applies and the unambiguous dispatch merits 5.

5 / 5

Progressive Disclosure

A clear overview with well-signaled one-level-deep references: all five linked files exist (192–542 lines each), each row states when to load it, and cross-links inside the references are lateral peer pointers (e.g., breaking-changes.md → api.md) rather than nested chains. Content is appropriately split with easy navigation; verified against the actual bundle structure.

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.

A model description: third-person voice, a comprehensive concrete capability list, and an explicit use-when clause with natural trigger phrases that mirror the rubric's good examples. The only weakness is minor trigger overlap with closely related sibling otel skills around declarative config.

DimensionReasoningScore

Specificity

"SDK setup, declarative config, zero-code instrumentation (opentelemetry-instrument, opentelemetry-distro), contrib auto-instrumentation, manual API, performance tuning, breaking changes" lists multiple specific concrete capabilities with named tools, comprehensively covering the skill's surface. Not level 4 because coverage matches the full reference set (all five reference files map to a named capability) rather than having minor gaps.

5 / 5

Completeness

Both questions are explicitly answered: the what is the enumerated capability list, and the when is "Use when configuring or troubleshooting OpenTelemetry in a Python service. Triggers on ..." with concrete trigger phrases. This matches the anchor-5 example structure exactly; the when is explicit, not weakly implied, so it cannot be level 3 or 4.

5 / 5

Trigger Term Quality

Explicit trigger phrases — "setup otel in python", "python telemetry", "python tracing", "opentelemetry-instrument", "opentelemetry-distro", "TracerProvider python", "FastAPI/Flask/Django otel", "python logging bridge" — cover natural phrasings plus synonyms ("otel", "OpenTelemetry", "telemetry"), tool names, and framework names users would actually say. Not level 4 because no common natural variation is obviously missing.

5 / 5

Distinctiveness Conflict Risk

The Python-OpenTelemetry niche with distinct triggers ("opentelemetry-distro", "TracerProvider python", "FastAPI/Flask/Django otel") is mostly distinct, but "declarative config" and "python telemetry"/"python tracing" overlap with the sibling otel-declarative-config skill and generic telemetry/tracing queries. Fits "mostly distinct; minor overlap risk with closely related skills" rather than level 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.

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.