скилл CX Codex

otel-js — скилл для Claude Code: OpenTelemetry в Node.js

Q: Как установить otel-js в Claude Code?

Выполните `npx skills add ollygarden/opentelemetry-agent-skills --skill otel-js -a claude-code`, после чего файл скилла окажется по пути `~/.claude/skills/otel-js/SKILL.md`.

Q: Нужны ли другие скиллы вместе с otel-js?

Он ссылается на `otel-declarative-config` для схемы YAML, `otel-sdk-versions` для выбора версии SDK и `otel-semantic-conventions` для семантических конвенций. Без первого детали конфигурации агент не закроет.

Помогает агенту настроить OpenTelemetry в сервисе на Node.js, JavaScript или TypeScript. Пригодится, когда нужно добавить трассировку или разобраться с NodeSDK.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓

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

Открыть на GitHub

Что делает otel-js

Скилл даёт агенту точку входа в механику OpenTelemetry для Node.js. Внутри один справочник — references/declarative-setup.md, он раскрывает настройку SDK через декларативный YAML: переменную OTEL_CONFIG_FILE, пакеты @opentelemetry/configuration и @opentelemetry/sdk-node, порядок импортов в ESM и CJS, переход на 2.0. Справочник самодостаточный, поэтому агент подгружает его под конкретную задачу.

Второй блок — таблица источников, откуда агент берёт факты. Версии пакетов он смотрит через npm view для @opentelemetry/configuration, @opentelemetry/sdk-node и @opentelemetry/auto-instrumentations-node. Статус релизов, ломающие изменения, механику preload в ESM и CJS, точку входа автоинструментации и гайд по миграции 2.x → 3.x агент тянет из файлов репозитория opentelemetry-js по прямым адресам.

Скилл ссылается на соседние: otel-declarative-config для схемы YAML, otel-sdk-versions для выбора версии SDK, otel-semantic-conventions для семантических конвенций. Ставьте его рядом с ними, иначе часть вопросов агент закроет наугад. Схема YAML описана в другом скилле, и без него детали конфигурации придётся искать самому.

Какие задачи решает

подключить NodeSDK к сервису на Node.js
перевести конфигурацию OTel на декларативный YAML
разобраться с порядком импортов в ESM и CJS
выбрать версию @opentelemetry/sdk-node и автоинструментаций
пройти миграцию с 2.x на 3.x

Примеры запросов агенту

Настрой OpenTelemetry в этом Node.js-сервисе через NodeSDK
Переведи конфигурацию OTel на декларативный YAML с OTEL_CONFIG_FILE
Проверь порядок импортов OTel для ESM в этом проекте

Как установить otel-js

1Через Skills CLI (Vercel)

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

2Вручную: положить файлы

~/.claude/skills/otel-js/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/otel-js/

1Через Skills CLI (Vercel)

npx skills add ollygarden/opentelemetry-agent-skills --skill otel-js -a codex

2Вручную: положить файлы

.agents/skills/otel-js/SKILL.md

Для всех проектов — ~/.agents/skills/

1Через Skills CLI (Vercel)

npx skills add ollygarden/opentelemetry-agent-skills --skill otel-js -a cursor

2Вручную: положить файлы

.cursor/skills/otel-js/SKILL.md

Cursor читает и .agents/skills/, и .claude/skills/

1GitHub CLI

gh skill install ollygarden/opentelemetry-agent-skills otel-js

2Вручную: положить файлы

.github/skills/otel-js/SKILL.md

1Через Skills CLI (Vercel)

npx skills add ollygarden/opentelemetry-agent-skills --skill otel-js -a gemini-cli

2Командой платформы

gemini skills install https://github.com/ollygarden/opentelemetry-agent-skills --path skills/otel-js

Вручную: положить файлы

.devin/skills/otel-js/SKILL.md

Старый путь .windsurf/skills/ тоже читается

Через Skills CLI (Vercel)

npx skills add ollygarden/opentelemetry-agent-skills --skill otel-js -a opencode

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о otel-js

Как установить otel-js в Claude Code?

Выполните npx skills add ollygarden/opentelemetry-agent-skills --skill otel-js -a claude-code, после чего файл скилла окажется по пути ~/.claude/skills/otel-js/SKILL.md.

Что делает otel-js?

Даёт агенту справочник по OpenTelemetry в Node.js: настройка SDK через декларативный YAML, автоинструментации, различия импортов в ESM и CJS. Агент подгружает его, когда вы добавляете или проверяете трассировку в сервисе.

Нужны ли другие скиллы вместе с otel-js?

Он ссылается на otel-declarative-config для схемы YAML, otel-sdk-versions для выбора версии SDK и otel-semantic-conventions для семантических конвенций. Без первого детали конфигурации агент не закроет.

Исходный текст

SKILL.md · Apache-2.0

---
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

| File | Use when |
|---|---|
| [`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. |

## Sources of Truth

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

| Fact | Fetch |
|---|---|
| Latest `@opentelemetry/configuration` | `npm view @opentelemetry/configuration version` |
| Latest `@opentelemetry/sdk-node` | `npm view @opentelemetry/sdk-node version` |
| Latest `@opentelemetry/auto-instrumentations-node` | `npm view @opentelemetry/auto-instrumentations-node version` |
| Released package status / breaking changes (`3.0.0` / `0.300.0`, verified 2026-10-21) | `WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v3.0.0/experimental/packages/configuration/README.md` and `WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v3.0.0/experimental/packages/opentelemetry-sdk-node/README.md` |
| Experimental CHANGELOG through `0.300.0` | `WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v3.0.0/experimental/CHANGELOG.md` |
| ESM / CJS preload mechanics at `3.0.0` | `WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v3.0.0/doc/esm-support.md` |
| Auto-instrumentations register entry point at `0.80.0` | `WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js-contrib/auto-instrumentations-node-v0.80.0/packages/auto-instrumentations-node/README.md` |
| 2.x → 3.x migration (removed packages, Node.js floor) | `WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v3.0.0/doc/3.x/migration-guide.md` |
| Node.js getting-started docs | `WebFetch 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.

Из того же набора7

otel-component-telemetry Сканирует один компонент OpenTelemetry на закреплённых версиях и записывает его спаны, метрики и логи в файлы изменений. CX Codex +1 ★ 116звёзд репо otel-telemetrygen Собирает безопасные команды telemetrygen с привязкой к версии, чтобы гнать синтетические OTLP-трейсы, метрики и логи в коллектор. CX Codex +1 ★ 116звёзд репо otel-semantic-conventions Скилл подтягивает вышедшие семантические конвенции OpenTelemetry: имена групп, атрибуты и правила именования спанов. Пригодится, когда агент придумывает ключи вместо готовых. CX Codex +1 ★ 116звёзд репо otel-python Скилл для настройки и отладки OpenTelemetry в Python-сервисах: SDK, декларативный конфиг, автоинструментация без правок кода. CX Codex +1 ★ 116звёзд репо otel-dotnet Скилл по OpenTelemetry в .NET и ASP.NET Core: настройка SDK через DI, инструментирование, zero-code агент, аудит ломающих изменений. CX Codex +1 ★ 116звёзд репо otel-collector-builder Скилл для сборки собственных дистрибутивов OpenTelemetry Collector через OCB. Пригодится, когда стандартные otelcol и otelcol-contrib не подходят. CX Codex +1 ★ 116звёзд репо