# text-to-sql

Скилл text-to-sql переводит просьбу на обычном языке в SQL-запрос: сверяется со схемой базы, подставляет плейсхолдеры и проверяет синтаксис перед выдачей.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 158 установок · ★ 45 у репозитория
- Автор: oimiragieo
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/oimiragieo/agent-studio/tree/HEAD/.claude/skills/text-to-sql/SKILL.md
- Обновлён: 2026-07-14
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/text-to-sql

## Что делает

Скилл разбирает формулировку запроса, сверяет имена таблиц и колонок со схемой, собирает SQL и проверяет его синтаксис. Отдельного скрипта внутри нет — это набор инструкций для агента, который работает в контексте модели `sonnet` и читает файлы через `Read`, `Write`, `Grep` и `Glob`.

Схему базы придётся дать самому: идентификаторы проверяются по тому, что вы положили в контекст, и без этого сверять нечего. Значения подставляются через плейсхолдеры (`?` или `$N`), а к `SELECT` по умолчанию добавляется `LIMIT 100`. Операции `DROP`, `DELETE`, `TRUNCATE` и `UPDATE` не пройдут без вашего подтверждения.

Для оценки качества в репозитории есть прогон через promptfoo: конфиг вроде `text_to_sql_config.yaml` и команда `npx promptfoo@latest eval -c text_to_sql_config.yaml`. Скилл советует подкидывать примеры похожих запросов, а сложные разбирать по шагам.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add oimiragieo/agent-studio --skill text-to-sql -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add oimiragieo/agent-studio --skill text-to-sql -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add oimiragieo/agent-studio --skill text-to-sql -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install oimiragieo/agent-studio .claude/skills/text-to-sql
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add oimiragieo/agent-studio --skill text-to-sql -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/oimiragieo/agent-studio --path .claude/skills/text-to-sql
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add oimiragieo/agent-studio --skill text-to-sql -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/oimiragieo/agent-studio/tree/HEAD/.claude/skills/text-to-sql/SKILL.md

## Когда брать
- собрать SQL-запрос по описанию задачи на русском
- посчитать выручку по продуктам, сджойнив `orders` и `products`
- найти дубликаты записей в таблице
- проверить синтаксис запроса до запуска на рабочей базе
- сравнить варианты промптов через promptfoo

## Примеры запросов агенту
- Сгенерируй SQL: все пользователи, которые зарегистрировались за последний месяц.
- Нужен запрос с джойном `orders` и `products` — выручка по каждому продукту за Q4.
- Найди дубликаты в таблице `users`, поставь `LIMIT` и объясни логику запроса.

## Похожие
- [sql-pro](https://affpapa.org/nevibecode/skills/httpsgithubcomjeffallan-sql-pro.md) — скилл · 6900 установок
- [sql-best-practices](https://affpapa.org/nevibecode/skills/sql-best-practices.md) — скилл · 845 установок
- [sql-database-assistant](https://affpapa.org/nevibecode/skills/borghei-sql-database-assistant.md) — скилл · 100 установок
- [sql-object-impact-analysis](https://affpapa.org/nevibecode/skills/sql-object-impact-analysis.md) — скилл · 26 установок
- [SQL Query Builder & Optimiser](https://affpapa.org/nevibecode/prompts/sql-query-builder-optimiser.md) — промпт · ★ 178201 у репозитория
- [sql-expert](https://affpapa.org/nevibecode/agents/sql-expert.md) — субагент · ★ 1029 у репозитория

Из того же набора: [oimiragieo/agent-studio](https://affpapa.org/nevibecode/by/oimiragieo/agent-studio.md) — 8 карточек

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