CtrlK
BlogDocsLog inGet started
Tessl Logo

otel-instrumentation

Configures trace spans, defines custom metrics, sets up log exporters, and optimizes sampling strategies for OpenTelemetry instrumentation. Use when instrumenting applications with traces, metrics, or logs. Triggers on requests for observability, telemetry, tracing, metrics collection, logging integration, or OTel setup.

98

1.38x
Quality

100%

Does it follow best practices?

Impact

94%

1.38x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a high-quality skill that serves as an effective navigation hub for OpenTelemetry instrumentation. It balances conciseness with actionability by providing a complete executable example and clear workflow while delegating language-specific and topic-specific details to well-organized referenced files. The key principles section adds genuine decision-making value (signal density heuristic, sampling strategy) that Claude wouldn't inherently know about the user's preferred approach.

DimensionReasoningScore

Conciseness

The content is lean and efficient. It doesn't explain what OpenTelemetry is or how tracing works conceptually — it assumes Claude already knows. The table is a compact navigation aid, the code example is purposeful, and the key principles section adds genuinely useful decision-making heuristics (signal density, sampling strategy) without padding.

3 / 3

Actionability

The getting-started section provides a clear 5-step process with specific file references. The Node.js code example is fully executable, copy-paste ready, and demonstrates proper span lifecycle including error handling, attributes, status setting, and exception recording. The sampling guidance gives a concrete directive (use AlwaysOn) with a clear architecture diagram.

3 / 3

Workflow Clarity

The 5-step getting-started workflow is clearly sequenced from SDK selection through validation. It includes an explicit validation step (step 5) referencing a dedicated validation checklist, and the sensitive-data step (step 4) acts as a safety checkpoint before export. The sequence is logical and covers the full instrumentation lifecycle.

3 / 3

Progressive Disclosure

The SKILL.md is an excellent overview/navigation hub. It provides a concise table linking to 20 topic-specific rule files organized by concern (platforms, SDKs, cross-cutting concerns). References are one level deep and clearly signaled. The inline content is minimal — just enough to orient and demonstrate — with details delegated to referenced files.

3 / 3

Total

12

/

12

Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an excellent skill description that hits all the marks. It provides specific concrete actions, comprehensive trigger terms covering both formal and abbreviated terminology, explicit 'Use when' and 'Triggers on' clauses, and a clearly defined niche around OpenTelemetry instrumentation that distinguishes it from general observability or logging skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'Configures trace spans', 'defines custom metrics', 'sets up log exporters', and 'optimizes sampling strategies'. These are clearly defined, actionable capabilities within the OpenTelemetry domain.

3 / 3

Completeness

Clearly answers both 'what' (configures trace spans, defines custom metrics, sets up log exporters, optimizes sampling strategies) and 'when' with explicit trigger guidance ('Use when instrumenting applications...' and 'Triggers on requests for...').

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'observability', 'telemetry', 'tracing', 'metrics collection', 'logging integration', 'OTel setup', 'traces', 'metrics', 'logs'. Includes both formal terms and the common abbreviation 'OTel'.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche around OpenTelemetry instrumentation. The specific mention of OTel, trace spans, sampling strategies, and log exporters makes it very unlikely to conflict with general logging or monitoring skills.

3 / 3

Total

12

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
dash0hq/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.