postgres-query · civitai, event-engine — скилл для Claude Code: что делает и как установить
Скилл postgres-query выполняет SQL-запросы к PostgreSQL, запускает EXPLAIN ANALYZE и проверяет индексы через агент в безопасном режиме чтения.
Apache-2.0 ★ 7 327 обновлён 2026-10-25
npx skills add civitai/civitai --skill postgres-query -a claude-codeЧто делает postgres-query
Скилл даёт агенту команду на запуск встроенного скрипта node .claude/skills/postgres-query/query.mjs для тестирования и профилирования PostgreSQL. По умолчанию скрипт подключается через переменную DATABASE_REPLICA_URL только на чтение, блокируя операции INSERT, UPDATE, DELETE и DROP.
Запросы на запись требуют флага --writable, который переключает соединение на основную базу данных, причём агент обязан запросить прямое подтверждение у пользователя. Для анализа производительности есть флаг --explain: он запускает EXPLAIN ANALYZE и помогает заметить Seq Scan на больших таблицах вместо сканирования по индексам. Также поддерживаются чтение SQL из файла через -f, вывод в формате JSON и настройка таймаута флагом -t с базовым значением 30 секунд.
Без установленного Node.js и настроенной переменной окружения базы данных запустить скрипт не получится.
Какие задачи решает
- запустить EXPLAIN ANALYZE и проверить использование индексов в таблицах
- проверить выборку данных из реплики PostgreSQL без риска перезаписать записи
- сравнить скорость двух вариантов сложного SQL-запроса
- выгрузить результат SQL-запроса в формате JSON для дальнейшей обработки
Примеры запросов агенту
- Проверь через EXPLAIN ANALYZE запрос к таблице User по полю username
- Выполни SQL-запрос из файла stats.sql с таймаутом 60 секунд
- Сравни производительность двух вариантов запроса выборки моделей и сохрани результаты в JSON
Как установить postgres-query
1Через Skills CLI (Vercel)
npx skills add civitai/civitai --skill postgres-query -a claude-code2Вручную: положить файлы
~/.claude/skills/postgres-query/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/postgres-query/
1Через Skills CLI (Vercel)
npx skills add civitai/civitai --skill postgres-query -a codex2Вручную: положить файлы
.agents/skills/postgres-query/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add civitai/civitai --skill postgres-query -a cursor2Вручную: положить файлы
.cursor/skills/postgres-query/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install civitai/civitai apps/event-engine/.claude/skills/postgres-query2Вручную: положить файлы
.github/skills/postgres-query/SKILL.md1Через Skills CLI (Vercel)
npx skills add civitai/civitai --skill postgres-query -a gemini-cli2Командой платформы
gemini skills install https://github.com/civitai/civitai --path apps/event-engine/.claude/skills/postgres-queryВручную: положить файлы
.devin/skills/postgres-query/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add civitai/civitai --skill postgres-query -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о postgres-query
Как установить postgres-query в Claude Code?
Выполните команду npx skills add civitai/civitai --skill postgres-query -a claude-code в терминале.
Что делает скилл postgres-query?
Он предоставляет скрипт на Node.js для выполнения запросов к PostgreSQL, замера их скорости через EXPLAIN ANALYZE и отладки работы индексов.
Как скилл защищает базу от случайного изменения данных?
По умолчанию подключение использует DATABASE_REPLICA_URL и запрещает команды изменения данных; запись разрешена только с флагом --writable после подтверждения пользователем.
Исходный текст
SKILL.md · Apache-2.0
--- name: postgres-query description: Run PostgreSQL queries for testing, debugging, and performance analysis. Use when you need to query the database directly, run EXPLAIN ANALYZE, compare query results, or test SQL optimizations. Always uses read-only connections unless explicitly directed otherwise. --- # PostgreSQL Query Testing Use this skill to run ad-hoc PostgreSQL queries for testing, debugging, and performance analysis. ## Running Queries Use the included query script: ```bash node .claude/skills/postgres-query/query.mjs "SELECT * FROM \"User\" LIMIT 5" ``` ### Options | Flag | Description | |------|-------------| | `--explain` | Run EXPLAIN ANALYZE on the query | | `--writable` | Use primary database instead of read replica (requires user permission) | | `--timeout <s>`, `-t` | Query timeout in seconds (default: 30) | | `--file`, `-f` | Read query from a file | | `--json` | Output results as JSON | | `--quiet`, `-q` | Minimal output, only results | ### Examples ```bash # Simple query node .claude/skills/postgres-query/query.mjs "SELECT id, username FROM \"User\" LIMIT 5" # Check query performance node .claude/skills/postgres-query/query.mjs --explain "SELECT * FROM \"Model\" WHERE id = 1" # Override default 30s timeout for longer queries node .claude/skills/postgres-query/query.mjs --timeout 60 "SELECT ... (complex query)" # Query from file node .claude/skills/postgres-query/query.mjs -f my-query.sql # JSON output for processing node .claude/skills/postgres-query/query.mjs --json "SELECT id, username FROM \"User\" LIMIT 3" ``` ## Safety Features 1. **Read-only by default**: Uses `DATABASE_REPLICA_URL` to prevent accidental writes 2. **Write protection**: Blocks INSERT/UPDATE/DELETE/DROP unless `--writable` flag is used 3. **Explicit permission required**: Before using `--writable`, you MUST ask the user for permission ## When to Use --writable Only use the `--writable` flag when: - The user explicitly requests write access - You need to test write operations - You're verifying transaction behavior **IMPORTANT**: Always ask the user for permission before running with `--writable`. ## Comparing Query Performance To compare two query approaches: ```bash # Run first approach node .claude/skills/postgres-query/query.mjs --explain "SELECT ... (approach 1)" # Run second approach node .claude/skills/postgres-query/query.mjs --explain "SELECT ... (approach 2)" # Compare actual results node .claude/skills/postgres-query/query.mjs --json "SELECT ... (approach 1)" > /tmp/q1.json node .claude/skills/postgres-query/query.mjs --json "SELECT ... (approach 2)" > /tmp/q2.json ``` ## Verifying Index Usage Run with `--explain` and look for: - **Good**: "Index Scan", "Bitmap Index Scan", "Index Only Scan" - **Bad**: "Seq Scan" on large tables (indicates missing or unused index) ```bash node .claude/skills/postgres-query/query.mjs --explain "SELECT * FROM \"Account\" WHERE provider = 'discord'" ```
© civitai · Apache-2.0 · civitai/civitai
Похожие скиллы
Все скиллы по теме «Данные и базы» →Сначала — postgres-query от других авторов.