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

postgres-query · civitai, event-engine — скилл для Claude Code: что делает и как установить

Скилл postgres-query выполняет SQL-запросы к PostgreSQL, запускает EXPLAIN ANALYZE и проверяет индексы через агент в безопасном режиме чтения.

Apache-2.0 ★ 7 327 обновлён 2026-10-25

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

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

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

~/.claude/skills/postgres-query/SKILL.md

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

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

postgres-query civitai Скилл postgres-query для Claude Code выполняет запросы к PostgreSQL при отладке и профилировании базы данных. Запускает команды через скрипт с обязательным указанием контура --prod или --dev. CX Codex +1 105установок postgres-tuning oakoss Скилл postgres-tuning для Claude Code, Codex, Cursor и других агентов, который даёт инструкции по настройке производительности PostgreSQL 17/18+. Охватывает async I/O, анализ планов запросов, индексы, autovacuum, pgvector и PgBouncer. CX Codex +1 136установок postgres-expert 0xfurai Субагент postgres-expert помогает проектировать схемы PostgreSQL, оптимизировать медленные SQL-запросы и настраивать индексы под рабочую нагрузку. CX Codex ★ 1 029звёзд репо neon-postgres neondatabase Скилл neon-postgres для Claude Code помогает работать с базой Neon: подключениями, схемой и ветками. Агент подключает его при запросах к существующей базе, SQL или поиску. CX Codex +1 315 000установок postgres-patterns affaan-m Скилл postgres-patterns для Claude Code собирает практики PostgreSQL для проектирования схем и настройки запросов: индексы, типы данных, RLS и диагностика медленных запросов. CX Codex +1 7 200установок postgres-best-practices neondatabase Скилл postgres-best-practices для Claude Code помогает писать SQL, проектировать схемы и разбирать запросы в PostgreSQL. Подключается при настройке базы, оптимизации запросов и работе с миграциями. CX Codex +1 2 100установок design-postgres-tables tigerdata Скилл design-postgres-tables для Claude Code проектирует таблицы PostgreSQL: типы данных, индексы, ограничения, JSONB и партиционирование. Включается при создании или изменении схемы. CX Codex +1 680установок

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

Весь набор →
quick-mockups Скилл quick-mockups для Claude Code: генерирует от 3 до 5 параллельных вариантов интерфейса в HTML для сравнения разных сеток и подачи новой фичи. CX Codex +1 1 700установок meilisearch-admin Скилл meilisearch-admin для мониторинга Meilisearch: проверяет индексы, задачи, здоровье сервера и настройки поиска. Помогает отловить ошибки в индексировании и понять, что происходит с поиском. CX Codex +1 132установок postgres-query Скилл postgres-query для Claude Code выполняет запросы к PostgreSQL при отладке и профилировании базы данных. Запускает команды через скрипт с обязательным указанием контура --prod или --dev. CX Codex +1 105установок agent-review Скилл agent-review для Claude Code отправляет код на проверку внешнему AI-агенту. Выполняет ревью, помогает оценить архитектурные решения и получить второе мнение. CX Codex +1 3установок discord Отправляет сообщения, анонсы и эмбеды в каналы Discord через REST API. Передаёт уведомления о релизах и командную переписку из консоли. CX Codex +1 ★ 7 327звёзд репо clickhouse-query Скилл clickhouse-query гоняет ad-hoc запросы к ClickHouse прямо из чата с агентом: метрики, события, план выполнения. По умолчанию только чтение. CX Codex +1 ★ 7 327звёзд репо redis-inspect Скилл redis-inspect для Claude Code проверяет ключи, значения и TTL в основном и системном инстансах Redis. Показывает, что сейчас хранится в кэше. CX Codex +1 ★ 7 327звёзд репо browser-automation Скилл browser-automation для Claude Code запускает браузер через HTTP-сервер, сохраняет авторизацию и поддерживает несколько сессий. Проверяет пользовательские потоки и повторяемые сценарии. CX Codex +1 ★ 7 327звёзд репо

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

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