# opik-instrument

Скилл opik-instrument для Claude Code добавляет трассировку Opik в существующее приложение и проверяет, что след попал в Opik. Запускается по просьбе инструментировать код или трассировать агента.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 123 установки · ★ 8 у репозитория
- Автор: comet-ml
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/comet-ml/opik-skills/tree/HEAD/skills/opik-instrument/SKILL.md
- Обновлён: 2026-10-25
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/opik-instrument

## Что делает

Скилл добавляет в приложение минимальную трассировку Opik, запускает безопасный пример работы и проверяет, что след появился в Opik. В конце он возвращает ссылку на трассу. Для проекта на Python или TypeScript он определяет язык и LLM-фреймворк, затем выбирает интеграцию фреймворка или добавляет ручные спаны для непокрытых операций.

Перед изменениями скилл проверяет конфигурацию командой `opik healthcheck`. Если конфигурации нет, запускает `opik configure` для Python или `npx opik-ts configure` для TypeScript. Пакет Opik устанавливается через менеджер проекта; lockfile сохраняется. Для поиска интеграций используется соседний скилл `opik` с файлом `references/integrations.md`, а если файла нет — документация Opik. Нужен проект на Python или TypeScript; если безопасный запуск требует ключа провайдера LLM, например `OPENAI_API_KEY`, без него проверка останавливается.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add comet-ml/opik-skills --skill opik-instrument -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/opik-instrument/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/opik-instrument/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add comet-ml/opik-skills --skill opik-instrument -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/opik-instrument/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add comet-ml/opik-skills --skill opik-instrument -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/opik-instrument/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install comet-ml/opik-skills skills/opik-instrument
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/opik-instrument/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add comet-ml/opik-skills --skill opik-instrument -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/comet-ml/opik-skills --path skills/opik-instrument
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/opik-instrument/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add comet-ml/opik-skills --skill opik-instrument -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/comet-ml/opik-skills/tree/HEAD/skills/opik-instrument/SKILL.md

## Когда брать
- добавить трассировку Opik в существующее приложение
- подключить нативную интеграцию для LLM-фреймворка
- проверить, что тестовый запуск создал трассу в Opik
- найти операцию, которую нужно покрыть ручным спаном

## Примеры запросов агенту
- Добавь трассировку Opik в это приложение и проверь тестовый запуск.
- Инструментируй агента в `src/agent.py` и верни ссылку на трассу.
- Подключи наблюдаемость к приложению на TypeScript через Opik.

## Похожие
- [opik](https://affpapa.org/nevibecode/skills/akillness-opik.md) — скилл · 146 установок
- [instrument-events](https://affpapa.org/nevibecode/skills/instrument-events.md) — скилл · 65900 установок
- [launchdarkly-metric-instrument](https://affpapa.org/nevibecode/skills/launchdarkly-metric-instrument.md) — скилл · 3300 установок
- [instrument-data-to-allotrope](https://affpapa.org/nevibecode/skills/instrument-data-to-allotrope.md) — скилл · 2500 установок
- [sentry-instrument](https://affpapa.org/nevibecode/skills/sentry-instrument.md) — скилл · 2000 установок
- [Comet Opik](https://affpapa.org/nevibecode/agents/comet-opik.md) — субагент · ★ 41430 у репозитория

Из того же набора: [comet-ml/opik-skills](https://affpapa.org/nevibecode/by/comet-ml/opik-skills.md) — 5 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
