# clickhouse-query

Скилл clickhouse-query гоняет ad-hoc запросы к ClickHouse прямо из чата с агентом: метрики, события, план выполнения. По умолчанию только чтение.

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

## Что делает

Скилл даёт агенту один скрипт `query.mjs`, которому SQL передают строкой: `node .claude/skills/clickhouse-query/query.mjs "SELECT count() FROM views"`. Флаги закрывают обычные нужды: `--explain` показывает план, `--json` отдаёт результат структурой, `--quiet` оставляет только строки, `--file` читает запрос из файла, `--timeout` меняет лимит времени.

Запись выключена: INSERT, ALTER и DROP отклоняются, пока не добавишь `--writable`, а перед этим скилл требует спросить разрешение у пользователя. Таймаут по умолчанию 30 секунд — тяжёлая агрегация на нём и обрывается, поэтому такие запросы запускай с `--timeout 60` или больше.

Внутри есть памятка по таблицам (`views`, `modelEvents`, `modelVersionEvents`, `userActivities`, `images`, `reactions`, `reports`, `entityMetricEvents`) и по репликам: прод живёт на реплика-кластере, поэтому системные таблицы вроде `system.query_log` читаются через `clusterAllReplicas(default, system.query_log)`. Обычный SELECT вернёт только тот узел, к которому подключён скрипт.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add civitai/civitai --skill clickhouse-query -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add civitai/civitai --skill clickhouse-query -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add civitai/civitai --skill clickhouse-query -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install civitai/civitai apps/event-engine/.claude/skills/clickhouse-query
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add civitai/civitai --skill clickhouse-query -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/civitai/civitai --path apps/event-engine/.claude/skills/clickhouse-query
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add civitai/civitai --skill clickhouse-query -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/civitai/civitai/tree/HEAD/apps/event-engine/.claude/skills/clickhouse-query/SKILL.md

## Когда брать
- посчитать просмотры и события в `views` за последнюю неделю
- посмотреть план выполнения до того, как запрос уедет в прод
- найти самые дорогие по памяти SELECT за сутки по всем репликам
- выгрузить агрегат в JSON и отдать его в обработку
- проверить, что трекинг событий пишет нужные строки

## Примеры запросов агенту
- Посчитай строки в `views` за последние 7 дней и верни результат в JSON.
- Покажи план запроса `SELECT * FROM views WHERE userId = 1` через `--explain`.
- Достань из `system.query_log` самые тяжёлые по памяти SELECT за сутки, читая все реплики.

## Похожие
- [clickhouse-best-practices](https://affpapa.org/nevibecode/skills/clickhouse-best-practices.md) — скилл · 23400 установок
- [clickhouse-js-node-coding](https://affpapa.org/nevibecode/skills/clickhouse-js-node-coding.md) — скилл · 7300 установок
- [clickhouse-architect](https://affpapa.org/nevibecode/skills/clickhouse-architect.md) — скилл · 157 установок
- [clickhouse-cloud-management](https://affpapa.org/nevibecode/skills/clickhouse-cloud-management.md) — скилл · 126 установок
- [hypequery ClickHouse](https://affpapa.org/nevibecode/mcp/hypequery-clickhouse.md) — MCP-сервер · ★ 106 у репозитория
- [clickhouse-io](https://affpapa.org/nevibecode/skills/clickhouse-io.md) — скилл · 6200 установок

Из того же набора: [civitai/civitai](https://affpapa.org/nevibecode/by/civitai/civitai.md) — 11 карточек

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

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