sql-queries · phuryn — скилл для Claude Code: что делает и как установить
Генерирует SQL-запросы по описанию на естественном языке с учётом схемы базы. Помогает аналитикам и разработчикам собирать отчёты и переводить бизнес-задачи в код.
npx skills add phuryn/pm-skills --skill sql-queries -a claude-codeЧто делает sql-queries
Скилл превращает текстовые требования в готовые SQL-запросы под нужный диалект. Он поддерживает BigQuery, PostgreSQL, MySQL, Snowflake и SQL Server. Сначала ассистент разбирает схему. Он читает загруженный файл .sql, документацию или текстовое описание диаграммы, находя таблицы, внешние ключи и типы полей.
Дальше агент уточняет фильтры, группировки и диалект, а затем пишет код с комментариями к сложной логике. Для больших таблиц скилл предлагает партиционирование и индексы. Он умеет генерировать тестовые данные для проверки результата. Если схему не передать, генератор опирается только на слова в промпте, из-за чего легко ошибиться в именах колонок.
Какие задачи решает
- сформировать SQL-запрос по описанию бизнес-логики
- разобрать схему базы данных из файла
.sqlили описания диаграммы - составить аналитический запрос для BigQuery или Snowflake
- создать тестовые данные и скрипт для валидации расчётов
Примеры запросов агенту
- Вот файл `database_schema.sql`. Напиши запрос, который найдёт пользователей, зарегистрированных за последние 30 дней с минимум 5 сессиями.
- Таблица `users` с полями id, email, created_at и таблица `sessions` с user_id, timestamp, duration. Посчитай среднюю длительность сессии на пользователя за январь 2026 года.
- Напиши запрос для BigQuery, чтобы рассчитать выручку по регионам и тарифам клиентов с динамикой год к году.
Как установить sql-queries
1Через Skills CLI (Vercel)
npx skills add phuryn/pm-skills --skill sql-queries -a claude-code2Вручную: положить файлы
~/.claude/skills/sql-queries/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/sql-queries/
1Через Skills CLI (Vercel)
npx skills add phuryn/pm-skills --skill sql-queries -a codex2Вручную: положить файлы
.agents/skills/sql-queries/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add phuryn/pm-skills --skill sql-queries -a cursor2Вручную: положить файлы
.cursor/skills/sql-queries/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install phuryn/pm-skills sql-queries2Вручную: положить файлы
.github/skills/sql-queries/SKILL.md1Через Skills CLI (Vercel)
npx skills add phuryn/pm-skills --skill sql-queries -a gemini-cli2Командой платформы
gemini skills install https://github.com/phuryn/pm-skills --path pm-data-analytics/skills/sql-queriesВручную: положить файлы
.devin/skills/sql-queries/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add phuryn/pm-skills --skill sql-queries -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора61
Весь набор →Другие версии sql-queries
Похожие
Вопросы о sql-queries
Как установить sql-queries в Claude Code?
Выполните команду npx skills add phuryn/pm-skills --skill sql-queries -a claude-code в терминале.
Какие диалекты SQL поддерживает скилл?
Скилл работает с BigQuery, PostgreSQL, MySQL, Snowflake и SQL Server, подстраивая синтаксис под выбранную СУБД.
Как передать схему базы данных?
Загрузите файл схемы .sql, покажите техническую документацию или опишите структуру таблиц и связей текстом прямо в сообщении.
Исходный текст
SKILL.md · MIT
--- name: sql-queries description: "Generate SQL queries from natural language descriptions. Supports BigQuery, PostgreSQL, MySQL, and other dialects. Reads database schemas from uploaded diagrams or documentation. Use when writing SQL, building data reports, exploring databases, or translating business questions into queries." --- # SQL Query Generator ## Purpose Transform natural language requirements into optimized SQL queries across multiple database platforms. This skill helps product managers, analysts, and engineers generate accurate queries without manual syntax work. ## How It Works ### Step 1: Understand Your Database Schema - If you provide a schema file (SQL, documentation, or diagram description), I will read and analyze it - Extract table names, column definitions, data types, and relationships - Identify primary keys, foreign keys, and indexing strategies ### Step 2: Process Your Request - Clarify the exact data you need to retrieve or analyze - Confirm the SQL dialect (BigQuery, PostgreSQL, MySQL, Snowflake, etc.) - Ask for any additional requirements (filters, aggregations, sorting) ### Step 3: Generate Optimized Query - Write efficient SQL that leverages your database structure - Include comments explaining complex logic - Add performance considerations for large datasets - Provide alternative approaches if applicable ### Step 4: Explain and Test - Explain the query logic in plain English - Suggest how to test or validate results - Offer tips for performance optimization - If you want, generate a test script or sample data ## Usage Examples **Example 1: Query from Schema File** ``` Upload your database_schema.sql file and say: "Generate a query to find users who signed up in the last 30 days and had at least 5 active sessions" ``` **Example 2: Query from Diagram Description** ``` "Here's my database: Users table (id, email, created_at), Sessions table (id, user_id, timestamp, duration). Generate a query for average session duration per user in January 2026." ``` **Example 3: Complex Analysis Query** ``` "Create a BigQuery query to analyze our revenue by region and customer tier, including year-over-year growth rates." ``` ## Key Capabilities - **Multi-Dialect Support**: Works with BigQuery, PostgreSQL, MySQL, Snowflake, SQL Server - **File Reading**: Reads schema files, SQL dumps, and data documentation - **Query Optimization**: Suggests indexes, partitioning, and performance improvements - **Explanation**: Breaks down queries for learning and documentation - **Testing**: Can generate test queries and sample data scripts - **Script Execution**: Create executable SQL scripts for your database ## Tips for Best Results 1. **Provide context**: Share your database schema or structure 2. **Be specific**: Clearly describe what data you need and any filters 3. **Mention database**: Specify which SQL dialect you're using 4. **Include constraints**: Mention data volume, time ranges, and performance needs 5. **Request format**: Ask for the query result format if you need specific output ## Output Format You'll receive: - **SQL Query**: Production-ready SQL code with comments - **Explanation**: What the query does and how it works - **Performance Notes**: Optimization tips and considerations - **Test Script** (if requested): Sample data and validation queries --- ### Further Reading - [The Product Analytics Playbook: AARRR, HEART, Cohorts & Funnels for PMs](https://www.productcompass.pm/p/the-product-analytics-playbook-aarrr) - [How to Become a Technology-Literate PM](https://www.productcompass.pm/p/how-to-become-a-technology-literate)
© phuryn · MIT · phuryn/pm-skills