CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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".

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

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 index-style SKILL.md: a lean routing table with per-reference use-when guidance, fully executable fetch commands, and verified one-level-deep references. The only weakness is inline time-sensitive version pins and verification dates that will age and could be trimmed or restructured.

Suggestions

Move the pinned version URLs (v1.45.1, v0.66b1) and the 'verified 2026-10-19' date out of inline tables into a maintenance/versioning note or have the fetch commands target unversioned latest URLs, so the body does not carry time-sensitive facts that age.

The 'Sources of Truth' row pointing to the otel-declarative-config skill for schema facts is the one non-executable step; a one-line note on when to consult it versus the Python-specific table would remove the ambiguity.

DimensionReasoningScore

Conciseness

The body is lean and dense — a routing table, fetch commands, and cross-references with no padding or explanation of concepts Claude already knows. However, time-sensitive version and date info ("released 1.45.1 overview; verified 2026-10-19" and pinned v1.45.1 / v0.66b1 URLs) sits inline rather than in an old-patterns/deprecated section, which the guidelines penalize. This lands above anchor 4's 'minor instances that could be trimmed' but the date-stamped version pins keep it from the 5 anchor's 'every token earns its place'.

4 / 5

Actionability

Guidance is fully executable: exact copy-paste fetch commands with URLs and JSON paths ("WebFetch https://pypi.org/pypi/opentelemetry-sdk/json (`.info.version`)"), an unambiguous task-to-reference routing table, and concrete package-name templates. The single non-executable pointer (upstream sources listed in the otel-declarative-config skill) is a cross-reference, not a gap in the commands themselves, so this matches the copy-paste-ready anchor rather than anchor 4's 'minor gaps'.

5 / 5

Workflow Clarity

This is a single-purpose routing skill under 50 lines whose single action — "Load a reference below based on the task" — is unambiguous thanks to the per-reference 'Use when' descriptions, so the simple-skill exception applies. No destructive or batch operations exist, so the validation cap does not apply; a 4 would require an unclear or ambiguous action.

5 / 5

Progressive Disclosure

The body is a pure overview with a well-signaled table of one-level-deep references (all five referenced files verified to exist in references/), each entry describing when to load it, plus sibling-skill cross-references. This is an exact match for the anchor of a clear overview with well-signaled one-level-deep references and easy navigation; score 4 would require organization gaps that are not present.

5 / 5

Total

19

/

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 description: specific, comprehensive, in third person, with an explicit Use-when clause and an extensive trigger list. The only gap is a few missing natural trigger variations around metrics and generic phrasings of the library name.

Suggestions

Add trigger phrases for the metrics pillar and generic library mentions, e.g. "python metrics", "opentelemetry python", or "instrument python app", which users commonly say but which currently have no trigger.

DimensionReasoningScore

Specificity

The description lists multiple specific, concrete capability areas with named tools — "SDK setup, declarative config, zero-code instrumentation (opentelemetry-instrument, opentelemetry-distro), contrib auto-instrumentation, manual API, performance tuning, breaking changes" — with coverage matching the skill's full scope. This fits the anchor for multiple specific concrete actions with comprehensive coverage; score 4 would require minor gaps, but the enumerated areas map one-to-one onto the skill's references.

5 / 5

Completeness

Both what (the explicit capability list) and when ("Use when configuring or troubleshooting OpenTelemetry in a Python service") are clearly answered, supplemented by concrete trigger phrases. This is an exact match for the anchor that explicitly answers both what AND when with concrete trigger phrases; a 4 would have a less explicit 'when'.

5 / 5

Trigger Term Quality

Nine trigger phrases give good coverage including natural phrasings ("setup otel in python", "python tracing", "python telemetry") and the "otel" abbreviation, but common variations such as "python metrics", "opentelemetry python", or "instrument my python app" are missing. This matches the anchor for good keyword coverage with a few natural terms missing rather than the comprehensive synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

"OpenTelemetry in Python" carves a clear niche with distinct triggers ("opentelemetry-instrument", "opentelemetry-distro", "TracerProvider python") that no generic or other-language skill would claim. The description is in third person and highly specific, matching the clear-niche anchor with minimal conflict risk; score 4 would require notable overlap with a closely related 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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

ollygarden/opentelemetry-agent-skills

Path

skills/otel-python/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.