text-to-sql — скилл для Claude Code: что делает и как установить
Скилл text-to-sql переводит просьбу на обычном языке в SQL-запрос: сверяется со схемой базы, подставляет плейсхолдеры и проверяет синтаксис перед выдачей.
лицензия не указана 158 установок ★ 45 обновлён 2026-07-14
npx skills add oimiragieo/agent-studio --skill text-to-sql -a claude-codeЧто делает 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. Скилл советует подкидывать примеры похожих запросов, а сложные разбирать по шагам.
Какие задачи решает
- собрать SQL-запрос по описанию задачи на русском
- посчитать выручку по продуктам, сджойнив
ordersиproducts - найти дубликаты записей в таблице
- проверить синтаксис запроса до запуска на рабочей базе
- сравнить варианты промптов через promptfoo
Примеры запросов агенту
- Сгенерируй SQL: все пользователи, которые зарегистрировались за последний месяц.
- Нужен запрос с джойном
ordersиproducts— выручка по каждому продукту за Q4. - Найди дубликаты в таблице
users, поставьLIMITи объясни логику запроса.
Как установить text-to-sql
1Через Skills CLI (Vercel)
npx skills add oimiragieo/agent-studio --skill text-to-sql -a claude-code2Вручную: положить файлы
~/.claude/skills/text-to-sql/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/text-to-sql/
1Через Skills CLI (Vercel)
npx skills add oimiragieo/agent-studio --skill text-to-sql -a codex2Вручную: положить файлы
.agents/skills/text-to-sql/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add oimiragieo/agent-studio --skill text-to-sql -a cursor2Вручную: положить файлы
.cursor/skills/text-to-sql/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install oimiragieo/agent-studio .claude/skills/text-to-sql2Вручную: положить файлы
.github/skills/text-to-sql/SKILL.md1Через Skills CLI (Vercel)
npx skills add oimiragieo/agent-studio --skill text-to-sql -a gemini-cli2Командой платформы
gemini skills install https://github.com/oimiragieo/agent-studio --path .claude/skills/text-to-sqlВручную: положить файлы
.devin/skills/text-to-sql/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add oimiragieo/agent-studio --skill text-to-sql -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о text-to-sql
Как установить text-to-sql в Claude Code?
Выполните npx skills add oimiragieo/agent-studio --skill text-to-sql -a claude-code. Файл скилла появится по пути ~/.claude/skills/text-to-sql/SKILL.md.
Что делает text-to-sql?
Переводит вопрос на естественном языке в SQL-запрос, сверяя имена таблиц и колонок со схемой базы, и отдаёт запрос с плейсхолдерами вместо подставленных значений.
Какие ограничения у скилла?
Без схемы в контексте проверять идентификаторы не с чем. К SELECT добавляется LIMIT 100, а DROP, DELETE, TRUNCATE и UPDATE выполняются только после подтверждения.