CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-monitor-opentelemetry-ts

Auto-instrument Node.js applications with distributed tracing, metrics, and logs.

Quality

72%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/azure-monitor-opentelemetry-ts/SKILL.md

The canonical home for this skill is azure-monitor-opentelemetry-ts in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

78%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.

The body is a strong, executable reference: complete copy-paste TypeScript for every feature from installation through shutdown, with the critical useAzureMonitor-before-imports ordering prominently flagged. Weaknesses are the total absence of progressive disclosure (everything inlined in one file despite none of it needing to be) and small amounts of filler ('When to Use' boilerplate, redundant 'Key Types' section). No verification step confirms telemetry is actually flowing.

DimensionReasoningScore

Conciseness

The body is code-dense with almost no conceptual padding — it assumes Claude knows OpenTelemetry and jumps straight to executable snippets ('useAzureMonitor({ azureMonitorExporterOptions: { connectionString: ... } })'). It is not a 5 because of trimmable redundancy: the 'When to Use' section is one line of pure filler ('This skill is applicable to execute the workflow or actions described in the overview'), and 'Key Types' re-lists imports already shown in earlier examples. Not a 3: the unnecessary content is minor relative to the whole.

4 / 5

Actionability

Every section provides complete, copy-paste-ready TypeScript with real imports — installation commands, the env var format, quick start, full options object, custom traces/metrics, all three manual exporters, logs ingestion with error handling, a custom span processor, sampling, and shutdown. The only placeholder is the standard idiom 'getActiveConnections()' in a gauge callback, which is expected. This matches the fully-executable, common-cases-covered anchor.

5 / 5

Workflow Clarity

The core sequence is clear and the critical ordering constraint is explicitly emphasized ('**IMPORTANT:** Call useAzureMonitor() BEFORE importing other modules'), with ESM loader and graceful-shutdown steps included and a Best Practices recap. It is not a 5 because there is no validation checkpoint (e.g., verifying telemetry arrives in Azure Monitor / Live Metrics before proceeding); not a 3 because the sequence present is well-defined with the key ordering caveat surfaced rather than implicit.

4 / 5

Progressive Disclosure

Section headers are clear and consistently organized, but there are no bundle files at all (no references/, scripts/, or assets/), so the entire ~316-line body — including manual exporter setup, logs ingestion, and span-processor detail that clearly belong in reference files — is inlined in SKILL.md. This matches the anchor for 'content that should be separate is inline' rather than the good-structure anchor 4, whose 'references mostly clear' cannot apply since no references exist.

3 / 5

Total

16

/

20

Passed

Description

55%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.

The description gives a clear, concrete 'what' but completely lacks a 'when' — there is no trigger guidance, so it can only reach the middle anchor on completeness. It also omits its own most distinctive terms (Azure Monitor, OpenTelemetry, Application Insights, telemetry), weakening both trigger matching and distinctiveness. Adding a 'Use when...' clause naming the Azure/monitoring stack would lift it substantially.

Suggestions

Add an explicit trigger clause, e.g. 'Use when instrumenting Node.js apps for Azure Monitor / Application Insights, or when the user mentions OpenTelemetry, telemetry, or connection strings.'

Include the omitted high-likelihood search terms: 'Azure Monitor', 'Application Insights', 'OpenTelemetry', 'telemetry', and 'monitoring' — currently none appear even though they are in the skill name.

State the destination of the telemetry (export to Azure Monitor/Application Insights) to distinguish this skill from generic OpenTelemetry or logging skills.

DimensionReasoningScore

Specificity

The description lists several concrete capability areas — 'Auto-instrument Node.js applications with distributed tracing, metrics, and logs' — matching the anchor for several specific actions with minor gaps. It is not a 5 because coverage is not comprehensive: the Azure Monitor export destination and custom exporter/ingestion paths from the body are absent, and not a 3 since it names more than 1-2 concrete actions.

4 / 5

Completeness

The 'what' is clear (auto-instrument Node.js apps with tracing, metrics, logs), but there is no 'Use when...' clause or equivalent trigger guidance anywhere — the judging guideline explicitly caps completeness at 3 for this. It is not a 4 or 5 because 'when' is entirely missing rather than merely implicit or under-specified.

3 / 5

Trigger Term Quality

It includes relevant keywords like 'Node.js', 'distributed tracing', 'metrics', and 'logs', but omits the terms users would most naturally say for this skill: 'OpenTelemetry', 'Azure Monitor', 'Application Insights', 'telemetry', and 'monitoring' — none of which appear despite being in the skill name. This matches the anchor for some relevant keywords missing common variations and synonyms, rather than a 4 where only a few natural terms are missing.

3 / 5

Distinctiveness Conflict Risk

'Auto-instrument Node.js applications with distributed tracing, metrics, and logs' is somewhat specific, but it would overlap with generic OpenTelemetry, observability, or Node.js logging skills because its distinguishing marker ('Azure Monitor', 'Application Insights') is absent. It is not a 4 since the overlap risk with closely related telemetry skills is more than minor, and not a 2 since it is anchored to a concrete domain (Node.js instrumentation) rather than being broadly generic.

3 / 5

Total

13

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/azure-monitor-opentelemetry-ts/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.