# cel-programs

Скилл для работы с CEL и mito в интеграциях, которые собирают данные из API: шаблоны cel.yml.hbs, манифесты, отладка через mock.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 504 установки · ★ 16
- Автор: elastic
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/elastic/integration-skills/tree/HEAD/skills/cel-programs/SKILL.md
- Обновлён: 2026-10-16
- HTML: https://affpapa.org/nevibecode/skills/cel-programs

## Что делает

Скилл ведёт агента по всем задачам, связанным с input-типом `cel`: написание CEL-программ с пагинацией, курсорами и авторизацией, шаблоны `cel.yml.hbs`, настройка манифестов датастримов, ответы на вопросы про CEL и mito. Загружать его стоит, когда в датастриме используется `cel`.

Главное внутри — обязательный порядок работы: mock → mito → шаблон. Сначала пишется конфиг мока в `_dev/deploy/docker/files/config-<stream>.yml`, потом поднимается локальный http-server на `:8090`, затем CEL-программа проверяется как отдельный `.cel` файл с `state.json` через `mito -data state.json -log_requests program.cel`. Только после успешной проверки выражение переносится в `program: |` шаблона. Автор советует не писать больше 10–15 новых строк CEL за раз и собирать программу фазами: скелет, обработка ошибок, события, пагинация, курсор.

Есть и грабли, о которых скилл предупреждает отдельно: в пакетах типа `integration` нельзя задавать `data_stream.dataset` — framework сам маршрутизирует документы, а ручная настройка ломает маршрут и даёт «0 hits» в системных тестах. Для пакетов типа `input` это поле, наоборот, нужно. Скилл не заменяет профильные: дизайн ingest-пайплайнов, маппинг полей ECS, скаффолдинг пакета и запуск системных тестов на стеке Elastic — это другие скиллы.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add elastic/integration-skills --skill cel-programs -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add elastic/integration-skills --skill cel-programs -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add elastic/integration-skills --skill cel-programs -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install elastic/integration-skills cel-programs
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add elastic/integration-skills --skill cel-programs -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/elastic/integration-skills --path skills/cel-programs
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add elastic/integration-skills --skill cel-programs -a opencode
```

### Claude.ai

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

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

## Когда брать
- написать CEL-программу с пагинацией и курсором для сбора данных из API
- собрать шаблон `cel.yml.hbs` с переменными Handlebars и блоком `state`
- отладить CEL локально через mito, не дёргая реальный API
- поднять мок API для системных тестов датастрима
- разобраться, почему документы падают не в тот индекс при `data_stream.dataset`

## Примеры запросов агенту
- помоги написать CEL-программу для нового датастрима, начни со скелета
- проверь мой `program.cel` через mito с этим `state.json`
- настрой `cel.yml.hbs` и манифест для стрима с пагинацией по курсору

## Похожие
- [api-connector-builder](https://affpapa.org/nevibecode/skills/api-connector-builder.md) — скилл · 4500 установок
- [notion-api](https://affpapa.org/nevibecode/skills/notion-api.md) — скилл · 94900 установок
- [Webhook Automation](https://affpapa.org/nevibecode/skills/webhook-automation.md) — скилл · 4600 установок
- [configuring-exports](https://affpapa.org/nevibecode/skills/configuring-exports.md) — скилл · 3000 установок
- [building-tools](https://affpapa.org/nevibecode/skills/building-tools.md) — скилл · 2900 установок
- [plan-zoom-product](https://affpapa.org/nevibecode/skills/anthropics-plan-zoom-product.md) — скилл · 2100 установок

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

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

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