CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

otel-ruby

OpenTelemetry in Ruby — SDK setup, manual tracing, experimental metrics and logs, Bundler integration, contrib instrumentation for Rails/Rack/Sinatra/Sidekiq and other gems, propagation, performance, and upgrades. Use when adding, reviewing, configuring, or troubleshooting OpenTelemetry in a Ruby or Rails service. Triggers on "setup otel in ruby", "ruby telemetry", "Rails OpenTelemetry", "OpenTelemetry::SDK.configure", "opentelemetry-instrumentation-all", "Ruby tracing", "Rack otel", "Sidekiq otel", or any Ruby-related OTel question.

Quality

94%

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

92%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 exemplary router/index skill: lean routing table with per-task file guidance, concrete verification commands for every version-sensitive fact, and one-level-deep references that all resolve. The only real cost is the dense dated version-snapshot paragraph, which is time-sensitive information sitting outside any 'old patterns' framing.

Suggestions

Move the version snapshot into its own short section (e.g. '## Audit anchor') or trim it to gem names plus the lookup commands, so the dated numbers read as a checkpoint rather than body content.

Consider dropping the cross-referenced declarative-config parenthetical ("targets schema v1.0.0-rc.3; owner: ...") from the snapshot paragraph — it belongs in that sibling skill, and it adds tokens here without changing what the agent does next.

DimensionReasoningScore

Conciseness

The body is lean — a routing table, a stability caveat, lookup commands, and cross-references with no explanation of concepts Claude already knows. The "Released snapshot verified 2026-10-25" paragraph packs ~15 specific version numbers and a date; it is mitigated ("Treat this as an audit anchor, not a version-alignment rule") but is the one block of time-sensitive detail that could be trimmed or relocated. Not 5 because of that dense version block; not 3 because everything else earns its tokens.

4 / 5

Actionability

Concrete copy-paste commands are given for every fact ("gh api repos/open-telemetry/opentelemetry-ruby/releases --paginate", "gem specification <gem> dependencies --remote --yaml"), and the reference table maps each task to a specific file. Not 4 because the guidance is fully executable — routing decisions and fact lookups both have exact commands or file targets.

5 / 5

Workflow Clarity

The single action is unambiguous and stated up front ("Load only the reference that matches the task; each reference is self-contained"), and the table makes reference selection deterministic; version questions are routed to the lookup commands with the snapshot framed as an audit anchor. Not 4 because there are no gaps or ambiguity in what to do first, and no risky operations lack validation.

5 / 5

Progressive Disclosure

A clear overview with a well-signaled table of one-level-deep references (all five files verified to exist, and none of them nest further references), with the 453 lines of detail appropriately split out of SKILL.md. Not 4 because navigation is fully deterministic via the "Use when" column and links; cross-skill pointers are clearly labeled as such.

5 / 5

Total

19

/

20

Passed

Description

96%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: concrete capability list, explicit "Use when" guidance, natural trigger phrases with synonyms and gem identifiers, and clear Ruby-only scoping in third person. The only weakness is the broad "any Ruby-related OTel question" catch-all, which slightly blurs boundaries against the sibling OTel skill family.

DimensionReasoningScore

Specificity

The description enumerates concrete capability areas — "SDK setup, manual tracing, experimental metrics and logs, Bundler integration, contrib instrumentation for Rails/Rack/Sinatra/Sidekiq and other gems, propagation, performance, and upgrades" — plus explicit actions ("adding, reviewing, configuring, or troubleshooting"), giving comprehensive coverage of the niche. Not 4 because coverage extends across every major task in the domain with no meaningful gaps.

5 / 5

Completeness

Explicitly answers what ("SDK setup, manual tracing, ... propagation, performance, and upgrades") and when ("Use when adding, reviewing, configuring, or troubleshooting OpenTelemetry in a Ruby or Rails service") with concrete trigger phrases. Not 4 because both halves are explicit and specific, matching the top anchor's structure.

5 / 5

Trigger Term Quality

Eight explicit natural trigger phrases ("setup otel in ruby", "ruby telemetry", "Rails OpenTelemetry", "Rack otel", "Sidekiq otel") plus synonyms (otel/OTel/OpenTelemetry, Ruby/Rails) and concrete identifiers ("OpenTelemetry::SDK.configure", "opentelemetry-instrumentation-all"). Not 4 because both everyday phrasings and technical identifiers users would actually type are present.

5 / 5

Distinctiveness Conflict Risk

The Ruby/Rails scoping and gem-name triggers ("opentelemetry-instrumentation-all", "Rack otel", "Sidekiq otel") carve a clear niche, but the open-ended catch-all "or any Ruby-related OTel question" plus breadth over metrics, logs, and performance creates minor overlap risk with closely related sibling OTel skills (e.g., collector or semantic-convention questions that mention Ruby). Not 5 because of that catch-all; not 3 because the explicit triggers are unmistakably Ruby-specific.

4 / 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: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

ollygarden/opentelemetry-agent-skills

Path

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