OpenTelemetry in Node.js / JavaScript / TypeScript — NodeSDK, declarative YAML configuration, auto-instrumentations, ESM vs CJS import patterns.

Apache-2.0Auto-check passedDevOps & Cloud

Install Otel JS

skills CLI
$ npx skills add ollygarden/opentelemetry-agent-skills --skill otel-js -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ollygarden/opentelemetry-agent-skills otel-js --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ollygarden/opentelemetry-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/otel-js .claude/skills/otel-js && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
otel-js
GitHub stars
106
Token cost
~655 tokens
SKILL.md length
143 words
Files
2 (incl. references)
Skills in repo
19
Repo updated
First seen
Licence
Apache-2.0

At a glance

OpenTelemetry in Node.js / JavaScript / TypeScript — NodeSDK, declarative YAML configuration, auto-instrumentations, ESM vs CJS import patterns.

  • Configuring OpenTelemetry in a Node.js service
  • SKILL.md covers References, Sources of Truth and Cross-References
  • Calls npm; reaches raw.githubusercontent.com and opentelemetry.io
  • Setup otel in node

What it does

Otel JS is an agent skill from ollygarden/opentelemetry-agent-skills. OpenTelemetry in Node.js / JavaScript / TypeScript — NodeSDK, declarative YAML configuration, auto-instrumentations, ESM vs CJS import patterns. Use when adding, reviewing, or configuring OpenTelemetry in a Node.js service. Triggers on "setup otel in node", "js telemetry", "node tracing setup", "NodeSDK", "auto instrumentation node", "TracerProvider node", or any Node.js-related OTel question.

Its SKILL.md is about 660 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/declarative-setup.md`).

It sits in DevOps & Cloud, covering Observability. It works with OpenTelemetry, Node.js, JavaScript and TypeScript. The repository describes itself as: Vendor-neutral OpenTelemetry skills for AI coding agents like Claude Code, Cursor, and Codex, grounded in upstream sources. The licence is Apache-2.0.

When your agent uses it

  • Configuring OpenTelemetry in a Node.js service
  • Setup otel in node
  • Node tracing setup
  • Auto instrumentation node

Example prompts

  • “setup otel in node”
  • “js telemetry”
  • “node tracing setup”
  • “/otel-js”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit 12296db. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • raw.githubusercontent.com
    • opentelemetry.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Otel JS loads about 655 tokens when it runs, and up to ~2.4k if it reads all its reference files. Until then it costs about 101 tokens; SKILL.md has 143 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~101
When it runs · the whole SKILL.md, loaded when a task matches
~655
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ollygarden/opentelemetry-agent-skills at commit 12296db, republished under its Apache-2.0 licence (© ollygarden). 143 words, ~655 tokens.

Download SKILL.mdSave it as .claude/skills/otel-js/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
otel-js
description
OpenTelemetry in Node.js / JavaScript / TypeScript — NodeSDK, declarative YAML configuration, auto-instrumentations, ESM vs CJS import patterns. Use when adding, reviewing, or configuring OpenTelemetry in a Node.js service. Triggers on "setup otel in node", "js telemetry", "node tracing setup", "NodeSDK", "auto instrumentation node", "TracerProvider node", or any Node.js-related OTel question.

OpenTelemetry in Node.js

Entry point for OpenTelemetry mechanics in Node.js / JavaScript / TypeScript services. Load a reference below based on the task; each reference is self-contained.

References

FileUse when
references/declarative-setup.mdConfiguring the SDK via declarative YAML: OTEL_CONFIG_FILE, @opentelemetry/configuration, @opentelemetry/sdk-node, ESM/CJS import order, v2.0 migration.

Sources of Truth

For YAML schema details, fetch the upstream sources listed in the otel-declarative-config skill. For Node.js-specific facts:

FactFetch
Latest @opentelemetry/configurationnpm view @opentelemetry/configuration version
Latest @opentelemetry/sdk-nodenpm view @opentelemetry/sdk-node version
Latest @opentelemetry/auto-instrumentations-nodenpm view @opentelemetry/auto-instrumentations-node version
Released package status / breaking changes (2.11.0 / 0.222.0)WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v2.11.0/experimental/packages/configuration/README.md and WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v2.11.0/experimental/packages/opentelemetry-sdk-node/README.md
Experimental CHANGELOG through 0.222.0WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v2.11.0/experimental/CHANGELOG.md
ESM / CJS preload mechanics at 2.11.0WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v2.11.0/doc/esm-support.md
Auto-instrumentations register entry point at 0.80.0WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js-contrib/auto-instrumentations-node-v0.80.0/packages/auto-instrumentations-node/README.md
Node.js getting-started docsWebFetch https://opentelemetry.io/docs/languages/js/getting-started/nodejs/

Cross-References

  • Schema-level facts: otel-declarative-config skill (language-agnostic YAML schema sources).
  • SDK version selection across languages: otel-sdk-versions skill.
  • Semantic conventions lookup: otel-semantic-conventions skill.

© ollygarden, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/otel-js of ollygarden/opentelemetry-agent-skills.

  • SKILL.md
  • references/declarative-setup.md

Open the folder on GitHubat commit 12296db

Compare with similar skills

Otel JS next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Otel JS compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Otel JS this skillollygarden/opentelemetry-agent-skills106—~655Automated safety check: PassApache-2.0
Azure Monitor Opentelemetry TSmicrosoft/skills3.1k5 repos~2.2kAutomated safety check: PassMIT
Logfire Instrumentationbasicmachines-co/basic-memory4.1k—~2.3kAutomated safety check: PassAGPL-3.0
Applicationinsights Web TSmicrosoft/skills3.1k2 repos~5.2kAutomated safety check: PassMIT
Sls Dashboard Builderalibaba/loongsuite-pilot201—~1.8kAutomated safety check: PassApache-2.0
Bungalfrevn/apollo237—~2kAutomated safety check: NotesMIT

Similar skills

  • Official

    Instrument applications with Azure Monitor and OpenTelemetry for JavaScript (@azure/monitor-opentelemetry).

    3.1k GitHub starsUsed in 5 repos~2.2k tokens
    DevOps & CloudAuto-check passed
  • Logfire Instrumentation

    basicmachines-co/basic-memory

    Adds Pydantic Logfire tracing, logging and metrics to Python, JavaScript or TypeScript and Rust projects, with the correct setup order and library extras.

    4.1k GitHub stars~2.3k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Official

    Instrument browser/web apps with the Application Insights JavaScript SDK (@microsoft/applicationinsights-web).

    3.1k GitHub starsUsed in 2 repos~5.2k tokens
    DevOps & CloudAuto-check passed
  • Sls Dashboard Builder

    alibaba/loongsuite-pilot

    当任务需要创建、修改、扩展或重组阿里云 SLS 的 dashboard JSON 或可导入的大盘配置时使用;尤其适用于线上大盘、强对比的分析看板、已校验的查询包,或需要专业中文标签与指标定义的运维向大盘。

    201 GitHub stars~1.8k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Bun

    galfrevn/apollo

    A skill your agent uses when building, running, testing, or bundling JavaScript/TypeScript applications.

    237 GitHub stars~2k tokensUpdated 1 mo ago
    Testing & QAAuto-check: notes
  • Bun

    bastani-inc/atomic

    A skill your agent uses when building, testing, and deploying JavaScript/TypeScript applications.

    855 GitHub stars~2.8k tokensUpdated today
    Testing & QAAuto-check passed

More from ollygarden/opentelemetry-agent-skills

All 19 skills in this repo
  • Otel Collector Builder

    ollygarden/opentelemetry-agent-skills

    Build custom OpenTelemetry Collector distributions with OCB (OpenTelemetry Collector Builder).

    106 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Otel Go

    ollygarden/opentelemetry-agent-skills

    OpenTelemetry in Go — SDK setup, API surface, breaking changes, contrib instrumentation libraries (otelhttp, otelgrpc, otelmongo), compile-time zero-code instrumentation (otelc), and performance…

    106 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Otel Ottl

    ollygarden/opentelemetry-agent-skills

    OpenTelemetry Transformation Language (OTTL) expert for writing and debugging telemetry transformations in the OpenTelemetry Collector.

    106 GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Otel Span Events To Logs Migration

    ollygarden/opentelemetry-agent-skills

    Migrate OpenTelemetry Span Events (AddEvent, RecordException, and language equivalents) to the Logs API following the accepted OTEP 4430 migration plan.

    106 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Otel Telemetrygen

    ollygarden/opentelemetry-agent-skills

    Build safe, version-pinned telemetrygen commands for synthetic OTLP traces, metrics, and logs.

    106 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Otel Upgrade

    ollygarden/opentelemetry-agent-skills

    Assess OpenTelemetry package and Collector upgrades across ecosystems.

    106 GitHub stars~1.1k tokensUpdated today
    Auto-check passed

Categories

Questions about Otel JS

What does Otel JS do?

OpenTelemetry in Node.js / JavaScript / TypeScript — NodeSDK, declarative YAML configuration, auto-instrumentations, ESM vs CJS import patterns. Otel JS is an agent skill from ollygarden/opentelemetry-agent-skills.js / JavaScript / TypeScript — NodeSDK, declarative YAML configuration, auto-instrumentations, ESM vs CJS import patterns.

When should I use Otel JS?

Otel JS fits situations like: configuring OpenTelemetry in a Node.js service; setup otel in node; Node tracing setup; auto instrumentation node.

How do I install Otel JS in Claude Code?

Run `npx skills add ollygarden/opentelemetry-agent-skills --skill otel-js -a claude-code`. Or copy the skill folder (skills/otel-js in ollygarden/opentelemetry-agent-skills) into .claude/skills/otel-js in your project. Claude Code loads it when a task matches its description.

How do I install Otel JS in Codex?

Run `npx skills add ollygarden/opentelemetry-agent-skills --skill otel-js -a codex`. Or copy the skill folder (skills/otel-js in ollygarden/opentelemetry-agent-skills) into .agents/skills/otel-js in your project. Codex loads it when a task matches its description.

Can I use Otel JS in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ollygarden/opentelemetry-agent-skills --skill otel-js -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/otel-js, .gemini/skills/otel-js, .github/skills/otel-js and .opencode/skills/otel-js in your project.

What does Otel JS need to run?

Going by SKILL.md and its folder, Otel JS needs the command-line tools its instructions call (npm). Our summary lists: Node.js.

Does Otel JS access the network?

SKILL.md names 2 domains. In commands or code: raw.githubusercontent.com and opentelemetry.io; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Otel JS safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Otel JS use?

Otel JS is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Otel JS use?

About 655 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.8k tokens, read only when the agent opens those files.

What are the alternatives to Otel JS?

Skills that share tags, products or a category with Otel JS: Azure Monitor Opentelemetry TS (microsoft/skills, 3.1k stars), Logfire Instrumentation (basicmachines-co/basic-memory, 4.1k stars), Applicationinsights Web TS (microsoft/skills, 3.1k stars) and Sls Dashboard Builder (alibaba/loongsuite-pilot, 201 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Otel JS?

ollygarden (a GitHub organization) maintains it in ollygarden/opentelemetry-agent-skills, which has 106 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 10, 2026.

Source: ollygarden/opentelemetry-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.