CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

otel-java

OpenTelemetry in Java — Javaagent zero-code instrumentation, Spring Boot Starter, manual autoconfigure SDK, declarative YAML configuration, BOM dependency management, sensitive-data capture and redaction (url.query, headers, request parameters, SQL sanitization). Use when adding, reviewing, or configuring OpenTelemetry in a Java service. Triggers on "setup otel in java", "java telemetry", "javaagent", "Spring Boot otel", "GlobalOpenTelemetry", "AutoConfiguredOpenTelemetrySdk", "TracerProvider java", "url.query redaction", "capture request headers", or any Java-related OTel question.

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

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

82%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-built entry-point skill: lean, non-stale (placeholder-templated fetch sources instead of hardcoded versions), with unambiguous routing to two real one-level-deep references. The residual gaps are the implicit tag-placeholder resolution in the fetch workflow and the duplicated Sources of Truth table between SKILL.md and the declarative-setup reference.

Suggestions

State explicitly that the two `gh api .../releases/latest` commands supply the `<selected-sdk-tag>` and `<selected-agent-tag>` placeholders used by the WebFetch rows, and that they must be run first — e.g. one sentence above the Sources of Truth table.

Deduplicate the Sources of Truth table: keep it in one location (SKILL.md or references/declarative-setup.md) and point to it from the other, rather than repeating the identical ~14-line table in both files.

Add an explicit fallback step to the Explorer navigation for when an instrumentation id is missing from index.md or the version index (e.g., check the raw ecosystem-registry or fall back to the generated docs/declarative-configuration-example.yaml).

DimensionReasoningScore

Conciseness

The body is a lean routing document with zero concept explanations or OTel primers; it assumes Claude's competence and every section is navigation or fetch guidance. Version-sensitive facts are templated with placeholders and live-fetch commands instead of hardcoded version numbers, so nothing goes stale. Matches the anchor-5 "every token earns its place" example.

5 / 5

Actionability

Exact copy-paste commands ("gh api repos/open-telemetry/opentelemetry-java/releases/latest -q '.tag_name'") and concrete WebFetch URLs cover the common cases, but the "<selected-sdk-tag>"/"<selected-agent-tag>" placeholders are never explicitly tied to the latest-release commands that populate them — the reader must infer which release stream feeds which placeholder. Not 5 because of that minor executable gap.

4 / 5

Workflow Clarity

Reference routing is an unambiguous decision table ("Use when" column), and the Explorer lookup is a numbered 2-step sequence with exact URLs. However, resolving the tag placeholders before the WebFetch steps is an implicit step rather than an explicitly ordered one. No validation cap applies since nothing is destructive or batch; not 5 because the tag-resolution ordering is left implicit.

4 / 5

Progressive Disclosure

Two real, one-level-deep, self-contained reference files are clearly signaled via a purpose table with per-file "Use when" conditions, and both referenced paths exist in the bundle. Not 5 because the Sources of Truth table is duplicated verbatim in references/declarative-setup.md — content appearing in both the overview and a reference file is a minor organization gap rather than an appropriately split structure.

4 / 5

Total

17

/

20

Passed

Description

88%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 enumerates concrete capabilities with specific config/attribute names and gives an explicit "Use when" clause plus a concrete trigger list. The only weaknesses are a few missing natural trigger synonyms and a broad catch-all that slightly raises overlap risk with sibling OTel skills.

DimensionReasoningScore

Specificity

Lists multiple concrete capabilities — "Javaagent zero-code instrumentation, Spring Boot Starter, manual autoconfigure SDK, declarative YAML configuration, BOM dependency management, sensitive-data capture and redaction (url.query, headers, request parameters, SQL sanitization)" — down to specific attribute and config names, comprehensively covering the skill's scope. Not 4: coverage is broad and every item names a concrete mechanism rather than leaving minor gaps.

5 / 5

Completeness

Clearly answers both "what" (the capability list) and "when": "Use when adding, reviewing, or configuring OpenTelemetry in a Java service. Triggers on ..." with concrete trigger phrases. Matches the anchor-5 example structure exactly; not 4 because the "when" clause is fully explicit, not merely present.

5 / 5

Trigger Term Quality

Explicit triggers include natural user phrases ("setup otel in java", "java telemetry", "javaagent", "Spring Boot otel") plus API names a developer would paste ("GlobalOpenTelemetry", "AutoConfiguredOpenTelemetrySdk", "TracerProvider java"). Not 5: common synonyms like "tracing", "distributed tracing", or "opentelemetry java" are absent from the explicit list; the "any Java-related OTel question" catch-all softens the gap but does not name them.

4 / 5

Distinctiveness Conflict Risk

The Java scoping and Java-specific class-name triggers establish a clear niche, but the "any Java-related OTel question" catch-all leaves minor overlap risk with closely related sibling OTel skills (e.g., a language-agnostic declarative-config skill would also match a Java YAML question). Not 5 for that residual overlap; not 3 because the explicit triggers are strongly Java-specific.

4 / 5

Total

18

/

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

ollygarden/opentelemetry-agent-skills

Path

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