К основному содержанию
скилл CX Codex

otel-sdk-versions — скилл для Claude Code: что делает и как установить

Ищет актуальные релизы OpenTelemetry SDK, компонентов Collector, схем конфигурации и семантических конвенций. Пригодится при настройке телеметрии в проекте.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-sdk-versions -a claude-code
Открыть на GitHub

Что делает otel-sdk-versions

Скилл предоставляет агенту регламент подбора версий библиотек OpenTelemetry. Источником данных служит локальная таблица references/generated/otel-version-index.md. Она содержит релизы основных SDK для разных языков, а также компоненты Collector (core, contrib, дистрибутивы, builder), декларативные схемы конфигурации, семантические конвенции и Weaver.

Если агент работает в офлайн-режиме, он обязан указывать дату фиксации версий из таблицы и предупреждать о возможном наличии более свежих релизов. Регламент запрещает переносить номер версии основного пакета на вспомогательные модули: экспортеры и инструментации агент должен проверять отдельно по источникам их релизов.

Скилл не рассчитан на подготовку манифестов сборщика Collector и не оценивает риски миграции между версиями. Если нужного языка или пакета нет в базовой таблице, агент сообщает об этом ограничении и переходит к официальной документации проекта.

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

  • подобрать совместимую версию SDK OpenTelemetry для языка проекта
  • найти актуальный релиз компонентов OpenTelemetry Collector
  • отыскать ссылки на документацию по настройке и примеры кода
  • проверить зависимости вспомогательных пакетов телеметрии

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

  • Подскажи последнюю совместимую версию OpenTelemetry Go SDK и экспортеров
  • Какая версия OpenTelemetry Collector contrib сейчас поддерживается?
  • Найди документацию по настройке и примеры для Python OpenTelemetry SDK

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

1Через Skills CLI (Vercel)

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

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

~/.claude/skills/otel-sdk-versions/SKILL.md

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

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

Вопросы о otel-sdk-versions

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

Выполните команду npx skills add ollygarden/opentelemetry-agent-skills --skill otel-sdk-versions -a claude-code. Файл навыка запишется в ~/.claude/skills/otel-sdk-versions/SKILL.md.

Что делает otel-sdk-versions?

Он направляет агента по шагам выбора версий OpenTelemetry SDK, семантических конвенций, Weaver и Collector на базе индексной таблицы references/generated/otel-version-index.md.

Для каких задач этот скилл не подходит?

Он не предназначен для составления манифестов сборки Collector и для оценки рисков миграции между релизами.

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

SKILL.md · Apache-2.0
---
name: otel-sdk-versions
description: OpenTelemetry release version lookup for SDKs across languages and for the Collector (core, contrib, distributions, builder/OCB), the declarative configuration schema, semantic conventions, and Weaver. Use when choosing the latest compatible released OpenTelemetry SDK, package, or component version, when asked what the latest release of one of these is, and when locating setup docs or examples. Not for Collector build manifests or upgrade-risk assessment.
---

# OpenTelemetry SDK Versions

## Workflow

1. Open `references/generated/otel-version-index.md`.
- the SDKs table has one primary SDK package per language; the Components table covers the Collector (core, contrib, distributions, builder), the configuration schema, semantic conventions, and Weaver
- use the bundled tables as the default source of truth for what they cover
- its "Versions last changed" date is the last day any row changed
- offline, give each version with that date: "`<version>` as of `<date>`; a newer release may exist". Never call it the current latest

2. Choose the version deliberately.
- prefer the latest released version when it is compatible with the project
- if the latest release is not compatible, choose the latest compatible version and state the compatibility reason explicitly
- reuse that decision for the rest of the task unless the language, package, or constraints change

3. Resolve companion packages from the release source.
- if the task requires additional packages from the same ecosystem (exporters, instrumentations, resource detectors, Collector components), look up their versions from the release source — do not infer or reuse the primary package version
- sub-packages within the same project often share a version line but not always; confirm each package individually
- Collector components in one build must match the core release line its builder uses, which can trail core; see `otel-collector-builder` for manifest pinning

4. Use the linked follow-up sources when needed.
- use the Release Source or Release column to confirm the package, repo, or release notes
- use the Setup Docs column for SDK setup guidance
- use the Examples column for implementation references when examples are available

5. Handle gaps explicitly.
- if the requested language, package, or component is not in the bundled index, say that the index does not cover it
- then fall back to the official release source and official docs for that package
- do not assume an unreleased, prerelease, or incompatible version is acceptable without saying so

© ollygarden · Apache-2.0 · ollygarden/opentelemetry-agent-skills

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
wizard Matt Pocock Скилл создаёт интерактивный bash-скрипт для ручных шагов: настройки сервисов, секретов CI и разовых миграций. 553 369установок hyperframes-cli heygen-com Управляет проектами HyperFrames через терминал: собирает таймлайн, проверяет контраст кадров, запускает предпросмотр и рендерит видео локально или в облаке. CX Codex +1 1 300 000установок setup-pre-commit Matt Pocock Скилл настраивает pre-commit для JavaScript-репозитория: Husky запускает форматирование, проверку типов и тесты перед коммитом. 489 289установок using-git-worktrees Jesse Vincent Готовит изолированное рабочее дерево перед доработкой или выполнением плана. Проверяет текущий репозиторий, выбирает нативные средства платформы либо Git. CX Codex 217 153установок finishing-a-development-branch Jesse Vincent Скилл проверяет тесты и помогает выбрать, как завершить работу в ветке: слить её, открыть Pull Request или оставить как есть. CX Codex 214 439установок orca-cli stablyai Скилл даёт агенту доступ к worktree, терминалам, артефактам и встроенному браузеру Orca через CLI. Пригодится, когда работа идёт в окружении Orca. CX Codex +1 354 000установок

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

otel-telemetrygen Собирает безопасные команды telemetrygen с привязкой к версии, чтобы гнать синтетические OTLP-трейсы, метрики и логи в коллектор. CX Codex +1 ★ 116звёзд репо otel-telemetry-emissions Справочник телеметрии OpenTelemetry по конкретным версиям компонентов. Помогает проверить спаны, метрики, логи и атрибуты перед обновлением SDK или коллектора. CX Codex +1 ★ 116звёзд репо otel-span-events-to-logs-migration Помогает перенести события и исключения OpenTelemetry со Span Events на Logs API, сохранив связь записей с активным спаном. Пригодится для миграции и проверки старых вызовов. CX Codex +1 ★ 116звёзд репо otel-semantic-conventions Скилл подтягивает вышедшие семантические конвенции OpenTelemetry: имена групп, атрибуты и правила именования спанов. Пригодится, когда агент придумывает ключи вместо готовых. CX Codex +1 ★ 116звёзд репо otel-ruby Помогает агенту настраивать и проверять OpenTelemetry в Ruby-приложениях. Пригодится для трассировки, метрик, логов и инструментирования Rails и других библиотек. CX Codex +1 ★ 116звёзд репо otel-python Скилл для настройки и отладки OpenTelemetry в Python-сервисах: SDK, декларативный конфиг, автоинструментация без правок кода. CX Codex +1 ★ 116звёзд репо otel-profiles Помогает развернуть eBPF-профилировщик OpenTelemetry на Linux, в Docker и Kubernetes, настроить пайплайн profiles и отправку данных во внешние бэкенды вроде Pyroscope. CX Codex +1 ★ 116звёзд репо otel-ottl Скилл помогает писать выражения на OpenTelemetry Transformation Language (OTTL) для трансформирования и фильтрации телеметрии в Collector. CX Codex +1 ★ 116звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой