$npx -y skills add ollygarden/opentelemetry-agent-skills --skill otel-jsOpenTelemetry 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
| 1 | # OpenTelemetry in Node.js |
| 2 | |
| 3 | Entry point for OpenTelemetry mechanics in Node.js / JavaScript / TypeScript services. |
| 4 | Load a reference below based on the task; each reference is self-contained. |
| 5 | |
| 6 | ## References |
| 7 | |
| 8 | | File | Use when | |
| 9 | |---|---| |
| 10 | | [`references/declarative-setup.md`](references/declarative-setup.md) | Configuring the SDK via declarative YAML: `OTEL_CONFIG_FILE`, `@opentelemetry/configuration`, `@opentelemetry/sdk-node`, ESM/CJS import order, v2.0 migration. | |
| 11 | |
| 12 | ## Sources of Truth |
| 13 | |
| 14 | For YAML schema details, fetch the upstream sources listed in the `otel-declarative-config` skill. |
| 15 | For Node.js-specific facts: |
| 16 | |
| 17 | | Fact | Fetch | |
| 18 | |---|---| |
| 19 | | Latest `@opentelemetry/configuration` | `npm view @opentelemetry/configuration version` | |
| 20 | | Latest `@opentelemetry/sdk-node` | `npm view @opentelemetry/sdk-node version` | |
| 21 | | Latest `@opentelemetry/auto-instrumentations-node` | `npm view @opentelemetry/auto-instrumentations-node version` | |
| 22 | | Package status / breaking changes | `WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/main/experimental/packages/configuration/README.md` and `WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/main/experimental/packages/opentelemetry-sdk-node/README.md` | |
| 23 | | `sdk-node` CHANGELOG (experimental packages) | `WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/main/experimental/CHANGELOG.md` | |
| 24 | | ESM / CJS preload mechanics | `WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/main/doc/esm-support.md` | |
| 25 | | Auto-instrumentations register entry point | `WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js-contrib/main/packages/auto-instrumentations-node/README.md` | |
| 26 | | Node.js getting-started docs | `WebFetch https://opentelemetry.io/docs/languages/js/getting-started/nodejs/` | |
| 27 | |
| 28 | ## Cross-References |
| 29 | |
| 30 | - Schema-level facts: `otel-declarative-config` skill (language-agnostic YAML schema sources). |
| 31 | - SDK version selection across languages: `otel-sdk-versions` skill. |
| 32 | - Semantic conventions lookup: `otel-semantic-conventions` skill. |