CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

183-java-observability-tracing-opentelemetry

Use when you need to implement or improve distributed tracing with OpenTelemetry in Java — including trace/span modeling, context propagation, semantic conventions, span attributes/events/status, sampling strategy, baggage usage, privacy safeguards, and backend integration with OTLP collectors. This should trigger for requests such as Improve tracing; Apply OpenTelemetry tracing; Add distributed tracing; Refactor tracing instrumentation; Instrument Java services with OpenTelemetry spans. Part of Plinth Toolkit

70

Quality

88%

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

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

A well-structured overview skill: lean constraints, a coherent four-step workflow with validation, and exemplary progressive disclosure to a real single reference file. The main weakness is actionability — the body's steps are directive-level with only one concrete command, leaving executable specifics entirely to the reference file — plus minor redundancy from repeating the description's trigger list in the body.

Suggestions

Inline one minimal, executable OpenTelemetry Java snippet in the 'Instrument and propagate context' step (e.g., wrapping an HTTP client or executor task with a span and W3C trace-context propagation), so the core workflow step is actionable without opening the reference.

Drop or compress the 'When to use this skill' section — it repeats the frontmatter description's trigger phrases verbatim and duplicates information Claude already receives from the description.

Add an explicit feedback loop to the workflow or VERIFY constraint: what to inspect and fix when `mvn clean verify` fails after tracing changes, then re-verify before proceeding.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no basic OpenTelemetry explanations, and constraints are stated as terse imperatives ('PROPAGATION FIRST', 'NO SENSITIVE DATA'). Not score 5 because the 'When to use this skill' section repeats the description's trigger list verbatim, and the 'What is covered' bullets partially restate the description. Not score 3: there is no concept over-explanation or padding.

4 / 5

Actionability

There is some concrete guidance — the explicit 'VERIFY: Run `./mvnw clean verify` or `mvn clean verify`' command and named constraints — but the workflow steps remain directive-level ('Record status/errors/events consistently', 'configure sampling/exporters') with no inline code or specific API/dependency detail; the executable detail lives entirely in the reference file. Fits the score-3 anchor 'some concrete guidance but incomplete; missing key details' better than score 4's 'mostly executable guidance'.

3 / 5

Workflow Clarity

A clear four-step sequence (define trace model → instrument and propagate → harden spans/sampling → validate end-to-end) with a validation checkpoint present (the VERIFY constraint and step 4). Not score 5: there is no feedback loop describing what to do when verification fails, and checkpoints are named rather than embedded as explicit retry steps. Not score 3: validation is explicitly present, and tracing instrumentation is not a destructive/batch operation that would cap the score.

4 / 5

Progressive Disclosure

The body is a concise overview that delegates all detailed guidance to a single, clearly signaled, one-level-deep reference — 'For detailed guidance, examples, and constraints, see [references/183-java-observability-tracing-opentelemetry.md]' — and the referenced file exists and contains no nested references. Matches the anchor for a clear overview with well-signaled one-level-deep references and easy navigation.

5 / 5

Total

16

/

20

Passed

Description

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

An exemplary description: it states concrete capabilities comprehensively, gives explicit 'Use when' guidance plus a list of natural trigger phrases, and occupies a distinct niche (Java/OpenTelemetry tracing). Third-person voice is used throughout and no section is padded or vague.

DimensionReasoningScore

Specificity

Enumerates multiple concrete capabilities — 'trace/span modeling, context propagation, semantic conventions, span attributes/events/status, sampling strategy, baggage usage, privacy safeguards, and backend integration with OTLP collectors' — covering the domain comprehensively with no significant gaps. Matches the anchor for comprehensive, specific concrete actions rather than the score-4 anchor with 'minor gaps in coverage'.

5 / 5

Completeness

Explicitly answers both 'what' (the enumerated capability list: span modeling, context propagation, sampling, privacy, OTLP integration) and 'when' ('Use when you need to implement or improve distributed tracing with OpenTelemetry in Java' plus 'This should trigger for requests such as...'). Matches the anchor for clearly and explicitly answering both with concrete trigger phrases.

5 / 5

Trigger Term Quality

Explicitly lists natural user phrasings — 'Improve tracing; Apply OpenTelemetry tracing; Add distributed tracing; Refactor tracing instrumentation; Instrument Java services with OpenTelemetry spans' — covering synonyms (tracing, distributed tracing, instrumentation, spans, OpenTelemetry) a user would naturally say. Not score 4: no meaningful natural terms are missing for this domain.

5 / 5

Distinctiveness Conflict Risk

A clear niche — Java + OpenTelemetry + distributed tracing — with distinct, specific triggers; overlap risk is limited to closely adjacent observability skills at most. 'Part of Plinth Toolkit' further disambiguates it from unrelated tracing skills. Matches the clear-niche/minimal-conflict anchor rather than the score-4 anchor with notable overlap risk.

5 / 5

Total

20

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

jabrena/plinth

Path

skills/183-java-observability-tracing-opentelemetry/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.