К основному содержанию
скилл CX Codex

text-to-sql — скилл для Claude Code: что делает и как установить

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

лицензия не указана 158 установок ★ 45 обновлён 2026-07-14

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oimiragieo/agent-studio --skill text-to-sql -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/text-to-sql/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/text-to-sql/

По шагам, с командами для каждой платформы: Как установить скилл в 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 выполняются только после подтверждения.

Похожие скиллы

Все скиллы по теме «Данные и базы» →
sql-pro https://github.com/Jeffallan Скилл sql-pro оптимизирует медленные SQL-запросы, проектирует схемы баз данных и устраняет проблемы производительности. Пригодится при разборе планов EXPLAIN и миграции диалектов. CX Codex +1 6 900установок sql-best-practices Mindrally Скилл sql-best-practices для Claude Code задаёт правила форматирования SQL, индексации, явных JOIN и защиты от SQL-инъекций при работе с базой данных. CX Codex +1 845установок sql-database-assistant borghei Скилл sql-database-assistant для Claude Code запускает статический анализ SQL-запросов, собирает документацию схемы из DDL и генерирует файлы миграций со скриптами отката. CX Codex +1 100установок sql-object-impact-analysis официальный github Скилл sql-object-impact-analysis находит зависимости таблиц, колонок и процедур в SQL-коде и бэкенде перед их удалением или изменением. Помогает оценить зону поражения в легаси-проектах. CX Codex +1 26установок SQL Query Builder & Optimiser sivasaiyadav8143 Промпт SQL Query Builder & Optimiser ведёт модель по семи шагам: от брифа по запросу до готового SQL с индексами и разбором плана выполнения. GP ChatGPT ★ 178 201звёзд репо sql-expert 0xfurai Субагент sql-expert для Claude Code разбирает сложные SQL-запросы, планы выполнения, индексы и транзакции. Оптимизирует запросы и помогает проектировать схемы. CX Codex ★ 1 029звёзд репо

Из того же набора8

pyqt6-ui-development-rules Скилл pyqt6-ui-development-rules задаёт правила для PyQt6-интерфейсов: разделение логики и UI, сигналы и слоты, фоновые задачи и компоновка. Пригодится при разработке и рефакторинге desktop-приложений. CX Codex +1 1 200установок slack-notifications Скилл slack-notifications для Claude Code связывает агента со Slack: отправляет сообщения, работает с каналами, пользователями, файлами и реакциями. Отправляет уведомления и оповещения о сбоях. CX Codex +1 289установок context-compressor Скилл context-compressor сжимает большие текстовые файлы, истории чатов и RAG-загрузки перед отправкой модели, сохраняя доказательства для правильного ответа. Помогает, когда контекст раздут, а платёж щипает. CX Codex +1 274установок diagram-generator Скилл diagram-generator собирает диаграммы архитектуры, схемы БД и потоки данных в синтаксисе Mermaid, а готовую картинку может отдать одним HTML-файлом. CX Codex +1 146установок docker-compose Запускает и настраивает многоконтейнерные окружения через Docker Compose V2 прямо в чате с агентом. Пригодится при локальной разработке и отладке сервисов. CX Codex +1 145установок code-analyzer Скилл code-analyzer считает цикломатическую сложность, LOC, индекс поддерживаемости и дубли, а потом показывает, какие файлы брать в работу первыми. CX Codex +1 138установок interactive-requirements-gathering Скилл interactive-requirements-gathering для Claude Code ведёт агента через анкету по требованиям: задаёт по одному вопросу, предлагает варианты A–E и сохраняет ответы. Собирает ТЗ до первой строки кода. CX Codex +1 103установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой