# postgres-query

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · ★ 7327 у репозитория
- Автор: civitai
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/civitai/civitai/tree/HEAD/apps/event-engine/.claude/skills/postgres-query/SKILL.md
- Обновлён: 2026-10-25
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/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 и настроенной переменной окружения базы данных запустить скрипт не получится.

## Требования
- Работает с: PostgreSQL

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add civitai/civitai --skill postgres-query -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/postgres-query/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/postgres-query/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add civitai/civitai --skill postgres-query -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/postgres-query/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add civitai/civitai --skill postgres-query -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/postgres-query/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install civitai/civitai apps/event-engine/.claude/skills/postgres-query
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/postgres-query/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add civitai/civitai --skill postgres-query -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/civitai/civitai --path apps/event-engine/.claude/skills/postgres-query
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/postgres-query/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add civitai/civitai --skill postgres-query -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/civitai/civitai/tree/HEAD/apps/event-engine/.claude/skills/postgres-query/SKILL.md

## Когда брать
- запустить EXPLAIN ANALYZE и проверить использование индексов в таблицах
- проверить выборку данных из реплики PostgreSQL без риска перезаписать записи
- сравнить скорость двух вариантов сложного SQL-запроса
- выгрузить результат SQL-запроса в формате JSON для дальнейшей обработки

## Примеры запросов агенту
- Проверь через EXPLAIN ANALYZE запрос к таблице User по полю username
- Выполни SQL-запрос из файла stats.sql с таймаутом 60 секунд
- Сравни производительность двух вариантов запроса выборки моделей и сохрани результаты в JSON

## Похожие
- [postgres-tuning](https://affpapa.org/nevibecode/skills/postgres-tuning.md) — скилл · 136 установок
- [postgres-expert](https://affpapa.org/nevibecode/agents/postgres-expert.md) — субагент · ★ 1029 у репозитория
- [neon-postgres](https://affpapa.org/nevibecode/skills/neondatabase-neon-postgres.md) — скилл · 315000 установок
- [postgres-patterns](https://affpapa.org/nevibecode/skills/postgres-patterns.md) — скилл · 7200 установок
- [postgres-best-practices](https://affpapa.org/nevibecode/skills/neondatabase-postgres-best-practices.md) — скилл · 2100 установок
- [design-postgres-tables](https://affpapa.org/nevibecode/skills/design-postgres-tables.md) — скилл · 680 установок

## Другие версии с тем же именем
- [postgres-query · civitai](https://affpapa.org/nevibecode/skills/civitai-postgres-query.md) — 105 установок

Из того же набора: [civitai/civitai](https://affpapa.org/nevibecode/by/civitai/civitai.md) — 11 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
