# dbhub

Учит агента сначала изучить схему базы, а потом писать SQL. Пригодится, когда нужно найти таблицу или вытащить данные, не угадывая имена колонок.

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

## Что делает

Скилл описывает работу с базой через MCP-сервер DBHub. По умолчанию сервер даёт два инструмента: `search_objects` для разведки структуры и `execute_sql` для запуска запросов. Ещё два включаются опционально — `explain_sql` показывает план запроса без его выполнения, а `health_check` отдаёт состояние пула соединений и долю попаданий в кэш. Второй работает только на PostgreSQL, MySQL, MariaDB, SQL Server и Oracle.

Главное правило — сначала смотреть, потом запрашивать. Скилл ведёт по шагам: список схем, поиск таблиц по маске через SQL LIKE, разбор колонок и индексов, и только затем точный SELECT. Параметр `detail_level` задаёт объём ответа: `names` для беглого обзора, `summary` с числом строк и комментариями, `full` с типами и определениями. Советует начинать с `names` и углубляться только там, где нужно.

Если баз несколько, DBHub регистрирует отдельные инструменты на каждый источник — например, `search_objects_prod_pg` и `execute_sql_staging_mysql`. Значит, обращаться надо к тому, что соответствует нужному окружению. При ошибке в имени таблицы или колонки скилл велит вернуться к разведке, а не подбирать варианты наугад. Отдельно стоит учесть режим доступа: если база открыта только на чтение, пройдут лишь SELECT.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install bytebase/dbhub dbhub
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

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

## Примеры запросов агенту
- посмотри, какие таблицы есть в базе, и найди среди них таблицу заказов
- покажи колонки таблицы users и напиши запрос на выборку за последний месяц
- проверь план этого запроса, прежде чем его выполнять

## Похожие
- [planetscale-mcp-agent-operating-model](https://affpapa.org/nevibecode/skills/planetscale-mcp-agent-operating-model.md) — скилл · 2400 установок
- [planetscale-pscale-cli-automation](https://affpapa.org/nevibecode/skills/planetscale-pscale-cli-automation.md) — скилл · 1700 установок
- [attach-db](https://affpapa.org/nevibecode/skills/attach-db.md) — скилл · 1000 установок
- [migrate-create](https://affpapa.org/nevibecode/skills/migrate-create.md) — скилл · 729 установок
- [database-design](https://affpapa.org/nevibecode/skills/moizibnyousaf-database-design.md) — скилл · 604 установки
- [mysql](https://affpapa.org/nevibecode/skills/sanjay3290-mysql.md) — скилл · 420 установок

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

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

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