# query

Скилл для работы с семантическим слоем Honeydew: задаёт вопросы к данным, ведёт многошаговые разборы и выполняет структурированные запросы.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 43
- Автор: honeydew-ai
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins/tree/HEAD/skills/query/SKILL.md
- Обновлён: 2026-08-30
- HTML: https://affpapa.org/nevibecode/skills/honeydew-ai-query

## Что делает

Скилл `query` подключает агента к семантическому слою Honeydew и даёт два способа ответить на вопрос о данных. Глубокий анализ идёт через `initiate_analysis` и `monitor_analysis` — это путь по умолчанию, потому что только он применяет контекстный слой: инструкции и знания организации о том, какие поля и определения верны для конкретного вопроса. Структурированный запрос через `get_data_from_fields` или `get_sql_from_fields` выполняет уже готовую спецификацию: вы назвали поля сами, их отдал прошлый анализ, или спецификацию вы как раз проверяете. Детерминированно, но без проверки, что спецификация правильная.

Кроме этого скилл закрывает разбор прошлых прогонов: `get_analysis_step_details` объясняет, как посчитан конкретный шаг анализа, `list_analysis_chats` и `get_stored_conversation` дают доступ к прошлым диалогам, `list_query_history` показывает, что и из какого клиента запускалось.

Запросы выполняются в рамках рабочей области и ветки текущей сессии. Проверить контекст можно через `get_session_workspace_and_branch`, а выбрать — через `list_workspaces`, `list_workspace_branches` и `set_session_workspace_and_branch`. Если ветка не задана, запрос запускать не в чем: сначала выбираете её. Для поиска моделей и полей есть отдельный скилл `model-exploration`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add honeydew-ai/honeydew-ai-coding-agents-plugins --skill query -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add honeydew-ai/honeydew-ai-coding-agents-plugins --skill query -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add honeydew-ai/honeydew-ai-coding-agents-plugins --skill query -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install honeydew-ai/honeydew-ai-coding-agents-plugins query
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add honeydew-ai/honeydew-ai-coding-agents-plugins --skill query -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins --path skills/query
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add honeydew-ai/honeydew-ai-coding-agents-plugins --skill query -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins/tree/HEAD/skills/query/SKILL.md

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

## Примеры запросов агенту
- Почему в третьем квартале просела выручка? Разбери по шагам.
- Покажи `detailed_listings.price` в разрезе `detailed_listings.room_type`.
- Дай SQL для этого запроса, но не выполняй его.

## Похожие
- [answering-natural-language-questions-with-dbt](https://affpapa.org/nevibecode/skills/answering-natural-language-questions-with-dbt.md) — скилл · 1000 установок
- [alibabacloud-sls-query](https://affpapa.org/nevibecode/skills/alibabacloud-sls-query.md) — скилл · 2000 установок
- [logfire-query](https://affpapa.org/nevibecode/skills/logfire-query.md) — скилл · 1900 установок
- [planetscale-query-insights-and-tags](https://affpapa.org/nevibecode/skills/planetscale-query-insights-and-tags.md) — скилл · 1800 установок
- [database-query-optimization](https://affpapa.org/nevibecode/skills/database-query-optimization.md) — скилл · 586 установок
- [sql-query-optimization](https://affpapa.org/nevibecode/skills/sql-query-optimization.md) — скилл · 520 установок

## Другие версии с тем же именем
- [query · duckdb](https://affpapa.org/nevibecode/skills/query.md) — 1400 установок
- [query · neolabhq](https://affpapa.org/nevibecode/skills/neolabhq-query.md) — 1100 установок

Из того же набора: [honeydew-ai/honeydew-ai-coding-agents-plugins](https://affpapa.org/nevibecode/by/honeydew-ai/honeydew-ai-coding-agents-plugins.md) — 6 карточек

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

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