CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

otel

OpenTelemetry guidance for VS Code agent experiences. Use when changing Agent Host telemetry, local Copilot Chat telemetry, provider-native spans or metrics, OTel settings and managed policy, trace persistence/export, or monitoring documentation.

Quality

93%

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

The canonical home for this skill is otel in microsoft/vscode

SKILL.md
Quality
Evals
Security

Quality

Content

100%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 an exemplary procedural skill: it assumes Claude's competence, provides exact identifiers and copy-paste validation commands, sequences multi-step changes with explicit checkpoints, and deliberately keeps exhaustive reference material in one-level-deep authoritative documents instead of duplicating it. No dimension shows a meaningful weakness.

DimensionReasoningScore

Conciseness

The body teaches nothing Claude already knows: it never explains what OpenTelemetry or telemetry is, and every line carries project-specific facts (setting prefixes, file paths, precedence rules, protocol boundaries). It matches the lean anchor where every token earns its place; anchor 4's 'minor instances of over-explanation' do not appear.

5 / 5

Actionability

Guidance is fully executable: exact function and file identifiers ('buildAgentHostOTelEnv()' in 'common/agentService.ts', 'resolveOTelConfig()' in 'extensions/copilot/src/platform/otel/common/otelConfig.ts', 'truncateForOTel'), exact setting prefixes ('chat.agentHost.otel.*'), and copy-paste validation commands ('./scripts/test-integration.sh --run src/vs/platform/agentHost/test/node/otel/agentHostOTelService.integrationTest.ts', 'npx tsc --noEmit --project tsconfig.json') covering the common cases.

5 / 5

Workflow Clarity

Multi-step processes are explicitly sequenced (numbered runtime-version discipline, configuration checklists for both surfaces) with an explicit Validation section, a documentation verification checklist ('every relative link resolves; setting and command IDs exist in source; ...'), and error-recovery guidance ('If executable source and documentation disagree, verify with tests and call out the discrepancy'). This matches the clear-sequence-with-explicit-validation anchor.

5 / 5

Progressive Disclosure

No bundle files exist, and the skill enforces an appropriate split: 'Keep this skill procedural. Do not duplicate complete settings, environment-variable, attribute, event, or metric tables here', delegating exhaustive material one level deep to clearly signaled authoritative documents (src/vs/platform/agentHost/OTEL.md, extensions/copilot/docs/monitoring/agent_monitoring.md, the runtime's docs/developer-docs/monitor.md). Sections are well-organized and easy to navigate.

5 / 5

Total

20

/

20

Passed

Description

86%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 with an explicit, concrete 'Use when' trigger clause, good synonym coverage, and a clearly distinct niche. The main weakness is the what-clause: 'OpenTelemetry guidance' names the domain without stating the concrete actions the skill performs (e.g., navigating ownership, updating settings, validating changes).

Suggestions

Replace the generic 'OpenTelemetry guidance' what-clause with concrete action verbs, e.g. 'Navigate and change Agent Host and local Copilot Chat OTel pipelines: update settings and managed policy, route provider-native spans and metrics, and validate telemetry changes.'

Add one or two common variations of the trigger vocabulary such as 'tracing' or 'observability' to widen natural-term coverage.

DimensionReasoningScore

Specificity

The what-clause 'OpenTelemetry guidance for VS Code agent experiences' is generic, but the trigger clause enumerates six concrete change areas ('Agent Host telemetry, local Copilot Chat telemetry, provider-native spans or metrics, OTel settings and managed policy, trace persistence/export, or monitoring documentation'), matching 'several specific actions; minor gaps'. It is not 3 (well beyond 1-2 areas) and not 5 (the what lacks concrete action verbs like extract/fill/merge).

4 / 5

Completeness

Both parts are present: a domain-level what ('OpenTelemetry guidance for VS Code agent experiences') and an explicit 'Use when changing...' clause with concrete triggers. Not 3 because the when is explicit rather than weakly implied; not 5 because the what states a domain ('guidance') rather than concrete actions.

4 / 5

Trigger Term Quality

Natural vocabulary a contributor would actually say is comprehensively covered with the synonym pair 'OpenTelemetry'/'OTel' plus 'telemetry', 'spans', 'metrics', 'trace persistence/export', and 'monitoring'. It matches the comprehensive-with-synonyms anchor rather than 4, since no common variations for this niche are missing.

5 / 5

Distinctiveness Conflict Risk

Triggers are tightly scoped to a clear niche ('Agent Host telemetry', 'local Copilot Chat telemetry', 'provider-native spans or metrics') with minimal overlap risk against other skills. Anchor 5's clear-niche-with-distinct-triggers description fits exactly.

5 / 5

Total

18

/

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

relative_links

Relative link issues: 2 suspicious

Warning

Total

15

/

16

Passed

Repository

posit-dev/positron

Path

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