CtrlK
BlogDocsLog inGet started
Tessl Logo

otel

OpenTelemetry instrumentation for the Copilot Chat extension — covers the four agent execution paths, the IOTelService abstraction, span/metric/event conventions, and the relationship between code and the user/developer monitoring docs. Use when adding/changing OTel spans, metrics, or events; instrumenting a new agent surface; touching the Copilot CLI bridge or Claude span emission; or updating `extensions/copilot/docs/monitoring/agent_monitoring*.md`.

72

Quality

90%

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

88%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 unusually strong codebase skill body: it is project-specific and competence-assuming, gives fully executable code and commands, and closes every workflow with explicit validation steps. Its weaknesses are mild — small internal redundancies and a monolithic single-file layout where the file map and attribute tables could be split into reference files to reduce baseline token load.

Suggestions

Split bulk reference material out of the always-loaded body into references/ files — e.g. references/file-map.md for the §3 canonical map and references/conventions.md for the span/metric/event and attribute-namespace tables — keeping only the rules and checklists inline.

Remove the §3 duplicate/correction entry for inMemoryOTelService.ts ("← actually under node/"), and consolidate the attribute-namespace guidance that currently appears in both §3a and the §5 table into one place.

Add a natural-language trigger synonym ("telemetry", "tracing") to the description so the skill surfaces for users who say those words instead of "OTel".

DimensionReasoningScore

Conciseness

The body is dense and assumes competence — no generic "what is OpenTelemetry" explanation, everything is project-specific facts (canonical file map, constants, conventions, checklists), and the token-to-information ratio is high. Minor trimmable instances keep it below 5: the §3 file map lists inMemoryOTelService.ts under common/ with a correction note instead of just listing it once under node/, and the attribute-namespace guidance appears in both §3a and the §5 table. It is well above the 3 anchor ("some unnecessary explanation") — this is efficient with small redundancies, matching the 4 anchor.

4 / 5

Actionability

Fully executable guidance throughout: a copy-paste startActiveSpan pattern with status/error handling, trace-propagation and content-capture code snippets, exact constant names (GenAiOperationName.EXECUTE_TOOL, EXPORTABLE_OPERATION_NAMES), exact file paths for every rule, and runnable validation commands ("npx tsc --noEmit --project tsconfig.json", "npm test -- --grep \"OTel\\|Bridge\""). The anti-patterns section is equally concrete about what to reject.

5 / 5

Workflow Clarity

Four separate sequenced checklists (add span/attribute, add metric/event, instrument new agent surface, change the CLI bridge) each name exact files and tests to touch, and §8 provides explicit validation steps (typecheck, targeted unit tests, manual Aspire Dashboard and Debug Panel sanity checks) before a PR. Validation checkpoints are embedded in the workflows themselves ("document it in agent_monitoring.md", "add a unit test in ...spec.ts"), matching the checklists-with-explicit-validation anchor.

5 / 5

Progressive Disclosure

Good structure: ten numbered sections with clear headers, and every pointer to material outside the skill is a clearly-signaled one-level link into the repo's authoritative docs and source files. However, no bundle files exist at all (references/, scripts/, assets/ are absent), and the ~270-line body inlines bulk reference material — the full canonical file map, the attribute-namespace tables, and the span/metric/event conventions could live in reference files to lighten the always-loaded context. That monolithic-but-well-organized shape sits between the 3 and 5 anchors, matching "good structure, most content appropriately placed, minor organization gaps".

4 / 5

Total

18

/

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: it states concrete scope in third person, names the exact subsystems and file paths involved, and provides an explicit multi-trigger "Use when" clause. The only gap is missing natural synonyms like "telemetry" and "tracing" that a user might say instead of "OTel instrumentation".

DimensionReasoningScore

Specificity

The description enumerates multiple concrete capabilities: "covers the four agent execution paths, the IOTelService abstraction, span/metric/event conventions, and the relationship between code and the user/developer monitoring docs". Each is a specific, verifiable scope item rather than vague filler, matching the comprehensive-coverage anchor.

5 / 5

Completeness

It explicitly answers both questions: the first sentence states what the skill covers, and the second gives a concrete "Use when..." clause with four distinct triggers including a specific doc path. This matches the 5 anchor's structure (clear what + explicit when with concrete trigger phrases).

5 / 5

Trigger Term Quality

Good keyword coverage with natural terms users would say: "adding/changing OTel spans, metrics, or events", "instrumenting a new agent surface", "Copilot CLI bridge", "monitoring" docs, plus a concrete file path trigger. A few common synonyms are missing — "telemetry" and "tracing"/"traces" never appear in the description itself, so it falls between the good (4) and comprehensive (5) anchors, closer to 4.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche — OpenTelemetry instrumentation specifically for the Copilot Chat extension, naming project-specific surfaces (IOTelService, Copilot CLI bridge, agent_monitoring*.md docs). No generic skill would trigger on these terms; conflict risk is minimal.

5 / 5

Total

19

/

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: 13 suspicious

Warning

Total

15

/

16

Passed

Repository
posit-dev/positron
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.