скилл CX Codex

postgres-best-practices — скилл для Claude Code: правила работы

Q: Как установить postgres-best-practices в Claude?

Выполните `npx skills add neondatabase/postgres-skills --skill postgres-best-practices -a claude-code`. Скилл появится в `~/.claude/skills/postgres-best-practices/SKILL.md`.

Скилл с гайдлайнами по Postgres: проектирование схем, индексы, оптимизация запросов, миграции и типичные ошибки. Пригодится, когда агент пишет SQL или настраивает базу.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓

npx skills add neondatabase/postgres-skills --skill postgres-best-practices -a claude-code

Открыть на GitHub

Что делает postgres-best-practices

Скилл подключает к агенту набор справочников по PostgreSQL 14–18. Внутри — файлы references/ по темам: проектирование схем, индексы, оптимизация запросов, паттерны запросов, диагностика производительности, логическая репликация, hot standby, уровни изоляции транзакций, бэкап и восстановление, роли и права, массовая загрузка данных, пулинг соединений и апгрейд мажорных версий. Агент открывает нужный файл, когда задача совпадает с его темой.

Фичи конкретных версий помечены тегами вроде [PG15+] и [PG18+], а примеры, зависящие от окружения, указывают нужные привилегии, расширения или многонодовую конфигурацию. Так что перед запуском такого примера стоит проверить, что у вас есть права и расширения, о которых там сказано.

Скилл ставится одной командой через npx skills add и раскладывается в папку скиллов вашей платформы. Работает в Claude, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode.

Какие задачи решает

спроектировать схему таблиц под конкретную нагрузку
выбрать тип индекса под частые запросы
разобрать план EXPLAIN ANALYZE и найти узкое место
настроить пулинг соединений через PgBouncer
спланировать апгрейд мажорной версии Postgres

Примеры запросов агенту

посмотри в скилле postgres-best-practices, какой индекс подойдёт для этого запроса
проверь мою схему таблиц по гайдлайнам postgres-best-practices
как в postgres-best-practices описана настройка PgBouncer для этого сервиса

Как установить postgres-best-practices

1Через Skills CLI (Vercel)

npx skills add neondatabase/postgres-skills --skill postgres-best-practices -a claude-code

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

~/.claude/skills/postgres-best-practices/SKILL.md

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

1Через Skills CLI (Vercel)

npx skills add neondatabase/postgres-skills --skill postgres-best-practices -a codex

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

.agents/skills/postgres-best-practices/SKILL.md

Для всех проектов — ~/.agents/skills/

1Через Skills CLI (Vercel)

npx skills add neondatabase/postgres-skills --skill postgres-best-practices -a cursor

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

.cursor/skills/postgres-best-practices/SKILL.md

Cursor читает и .agents/skills/, и .claude/skills/

1GitHub CLI

gh skill install neondatabase/postgres-skills postgres-best-practices

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

.github/skills/postgres-best-practices/SKILL.md

1Через Skills CLI (Vercel)

npx skills add neondatabase/postgres-skills --skill postgres-best-practices -a gemini-cli

2Командой платформы

gemini skills install https://github.com/neondatabase/postgres-skills --path skills/postgres-best-practices

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

.devin/skills/postgres-best-practices/SKILL.md

Старый путь .windsurf/skills/ тоже читается

Через Skills CLI (Vercel)

npx skills add neondatabase/postgres-skills --skill postgres-best-practices -a opencode

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о postgres-best-practices

Как установить postgres-best-practices в Claude?

Выполните npx skills add neondatabase/postgres-skills --skill postgres-best-practices -a claude-code. Скилл появится в ~/.claude/skills/postgres-best-practices/SKILL.md.

Что делает postgres-best-practices?

Даёт агенту справочники по проектированию схем, индексам, оптимизации запросов, миграциям и типичным ошибкам Postgres. Агент обращается к ним, когда пишет SQL или настраивает базу.

Какие версии PostgreSQL поддерживаются?

Скилл покрывает PostgreSQL 14–18. Возможности конкретных версий помечены тегами вроде [PG15+], а примеры, зависящие от окружения, указывают нужные привилегии и расширения.

Исходный текст

SKILL.md · Apache-2.0

---
name: postgres-best-practices
description: Best practices and guidelines for working with Postgres. Covers schema design, indexing strategies, query optimization, migrations, and common pitfalls. Use when writing SQL, designing database schemas, optimizing queries, or setting up a Postgres database.
---

# Postgres Best Practices

Guidelines and best practices for working with Postgres, covering schema design, indexing, query optimization, and common pitfalls.

## Supported Versions

This skill covers PostgreSQL 14 through 18. Version-specific features are tagged (e.g., `[PG15+]`, `[PG18+]`); environment-dependent examples identify required privileges, extensions, or multi-node setup.

PostgreSQL provides 5 years of support per major version. Always run the latest minor release.

| Version | Initial Release    | End of Life        |
| ------- | ------------------ | ------------------ |
| 18      | September 2025     | November 2030      |
| 17      | September 2024     | November 2029      |
| 16      | September 2023     | November 2028      |
| 15      | October 2022       | November 2027      |
| 14      | September 2021     | November 2026      |

Source: [postgresql.org/support/versioning](https://www.postgresql.org/support/versioning/)

## References

| Area                    | Resource                                | When to Use                                                        |
| ----------------------- | --------------------------------------- | ------------------------------------------------------------------ |
| Schema Design           | `references/schema-design.md`           | Designing tables, choosing data types, normalizing, partitioning   |
| Indexing                | `references/indexing.md`                | Choosing index types, composite indexes, partial/covering indexes  |
| Query Optimization      | `references/query-optimization.md`      | Reading EXPLAIN ANALYZE, fixing bottlenecks, planner tuning        |
| Query Patterns          | `references/query-patterns.md`          | CTEs, window functions, lateral joins, UPSERT, JSONB, anti-patterns|
| Performance Diagnostics | `references/performance-diagnostics.md` | pg_stat views, lock analysis, VACUUM, connection management        |
| Logical Replication     | `references/logical-replication.md`     | Pub/sub replication, live migrations, CDC                          |
| Hot Standby             | `references/hot-standby.md`             | Streaming replication, read replicas, failover                     |
| Transaction Isolation   | `references/transaction-isolation.md`   | Isolation levels, lost updates, serialization failures, retry logic |
| Backup & Restore        | `references/backup-restore.md`          | pg_dump/pg_restore, pg_basebackup, PITR, recovery                 |
| Security & Roles        | `references/security-roles.md`          | Privileges, RLS, pg_hba.conf, authentication, SSL                 |
| Bulk Data Loading       | `references/bulk-loading.md`            | COPY patterns, ETL staging, optimizing large loads, batch ops      |
| Connection Pooling      | `references/connection-pooling.md`      | PgBouncer config, pool modes, prepared statements, sizing          |
| Major Version Upgrades  | `references/major-version-upgrades.md`  | pg_upgrade, logical replication migration, pre/post checklists     |