otel-sdk-versions — скилл для Claude Code: что делает и как установить
Ищет актуальные релизы OpenTelemetry SDK, компонентов Collector, схем конфигурации и семантических конвенций. Пригодится при настройке телеметрии в проекте.
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-sdk-versions -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/otel-sdk-versions/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/otel-sdk-versions/
1Через Skills CLI (Vercel)
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-sdk-versions -a codex2Вручную: положить файлы
.agents/skills/otel-sdk-versions/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-sdk-versions -a cursor2Вручную: положить файлы
.cursor/skills/otel-sdk-versions/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ollygarden/opentelemetry-agent-skills otel-sdk-versions2Вручную: положить файлы
.github/skills/otel-sdk-versions/SKILL.md1Через Skills CLI (Vercel)
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-sdk-versions -a gemini-cli2Командой платформы
gemini skills install https://github.com/ollygarden/opentelemetry-agent-skills --path skills/otel-sdk-versionsВручную: положить файлы
.devin/skills/otel-sdk-versions/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-sdk-versions -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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