CtrlK
BlogDocsLog inGet started
Tessl Logo

kopai/otel-instrumentation

Instrument applications with OpenTelemetry SDK and validate telemetry using Kopai. Use when setting up observability, adding tracing/logging/metrics, testing instrumentation, debugging missing telemetry data, or when traces/logs/metrics aren't appearing after setup. Also use when users say things like "my traces aren't showing up", "I don't see any data", or "how do I add observability to my app".

80

Quality

100%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

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 well-crafted skill that balances brevity with completeness. It provides an immediately actionable quick reference and example while deferring language-specific and troubleshooting details to clearly organized rule files. The workflow includes proper validation and error recovery steps, making it robust for real-world use.

DimensionReasoningScore

Conciseness

The content is lean and efficient. It avoids explaining what OpenTelemetry is or how SDKs work conceptually. Every section serves a purpose — quick reference, workflow, example, and rule references. No unnecessary padding.

3 / 3

Actionability

Provides fully executable commands (npx, npm install, node --import), a complete copy-paste-ready Node.js instrumentation example, and specific environment variable configurations. The quick reference section alone is immediately actionable.

3 / 3

Workflow Clarity

The 5-step workflow is clearly sequenced with explicit validation at step 4, including a feedback loop (if empty: check endpoint/port, wait and retry) and escalation to troubleshooting rules in step 5. This covers error recovery well for an instrumentation setup task.

3 / 3

Progressive Disclosure

Excellent structure: concise overview with quick reference and one working example inline, then clearly signaled one-level-deep references to rules/<rule-name>.md files organized by priority (CRITICAL/HIGH/MEDIUM) and separate reference files for CLI, docs, and examples.

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 specifies concrete capabilities (instrumenting with OpenTelemetry, validating with Kopai), provides comprehensive trigger terms covering both technical vocabulary and natural user language, and includes an explicit 'Use when...' clause with diverse scenarios. The mention of specific tools (OpenTelemetry, Kopai) gives it a clear, distinctive niche.

DimensionReasoningScore

Specificity

Lists multiple concrete actions: 'Instrument applications with OpenTelemetry SDK', 'validate telemetry using Kopai', 'adding tracing/logging/metrics', 'testing instrumentation', 'debugging missing telemetry data'. These are specific, actionable capabilities.

3 / 3

Completeness

Clearly answers both 'what' (instrument with OpenTelemetry SDK, validate telemetry with Kopai) and 'when' with an explicit 'Use when...' clause covering multiple trigger scenarios, plus natural language examples of user requests.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'observability', 'tracing', 'logging', 'metrics', 'traces', 'logs', 'my traces aren't showing up', 'I don't see any data', 'add observability to my app', 'OpenTelemetry', 'instrumentation'. Includes both technical terms and natural language phrases users would actually type.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche: OpenTelemetry SDK instrumentation and Kopai validation. The combination of specific tools (OpenTelemetry, Kopai) and domain (observability/telemetry) makes it very unlikely to conflict with other 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.

Reviewed

Table of Contents