# database-schema-designer

Скилл database-schema-designer для Claude Code превращает требования к продукту в нормализованную реляционную схему: таблицы, ORM-модели, RLS, индексы и миграции. Запускается на шести платформах, среди которых Codex, Cursor и Gemini CLI.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 183 установки · ★ 1183 у репозитория
- Автор: borghei
- Лицензия: LicenseRef-MIT-Commons-Clause · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/database-schema-designer/SKILL.md
- Обновлён: 2026-11-08
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/borghei-database-schema-designer

## Что делает

Скилл проектирует схемы для PostgreSQL, MySQL и SQLite, а результат отдаёт в формате Drizzle, Prisma, TypeORM или Alembic. По описанию сущностей и связей он строит таблицы, добавляет `id`, `created_at`, `updated_at` и, если нужно, `deleted_at`, `organization_id` и `version`. Для первичных ключей использует UUIDv7 или CUID2, чтобы B-tree вставки оставались локальными.

Отдельная часть — безопасность. Скилл генерирует Row-Level Security для изоляции тенантов, шифрование PII на уровне колонок и аудит с JSON-снимками «до/после». Миграции продумываются с rollback-сценариями и паттернами zero-downtime для больших таблиц.

Внутри три Python-скрипта: `schema_validator.py` проверяет схему на пропущенные FK-индексы и частичные индексы для soft delete, `migration_diffr.py` строит forward и rollback SQL между двумя версиями DDL, `erd_generator.py` рисует Mermaid ERD. Для первого нужен Python 3 и готовый `.sql`-файл.

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

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill database-schema-designer -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill database-schema-designer -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill database-schema-designer -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install borghei/Claude-Skills engineering/database-schema-designer/SKILL.md
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill database-schema-designer -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/database-schema-designer
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill database-schema-designer -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/database-schema-designer/SKILL.md

## Когда брать
- спроектировать схему по требованиям на естественном языке
- добавить RLS и мультиарендность в существующие таблицы
- спланировать миграцию с откатом для крупной таблицы
- проверить, не пропущены ли FK-индексы
- сгенерировать ERD в Mermaid

## Примеры запросов агенту
- Спроектируй таблицы для заказов, товаров и покупателей с мягким удалением
- Проверь схему `assets/schema.sql` скриптом `schema_validator.py` и покажи ошибки
- Построй миграцию между `schema_v1.sql` и `schema_v2.sql` вместе с откатом

## Похожие
- [database-migration-management](https://affpapa.org/nevibecode/skills/database-migration-management.md) — скилл · 505 установок
- [planetscale-schema-recommendations-agent-loop](https://affpapa.org/nevibecode/skills/planetscale-schema-recommendations-agent-loop.md) — скилл · 2000 установок
- [database-design](https://affpapa.org/nevibecode/skills/moizibnyousaf-database-design.md) — скилл · 624 установки
- [database-expert](https://affpapa.org/nevibecode/agents/database-expert.md) — субагент · ★ 763 у репозитория
- [database-schema-design](https://affpapa.org/nevibecode/skills/database-schema-design.md) — скилл · 599 установок
- [relational-database-mcp-cloudbase](https://affpapa.org/nevibecode/skills/relational-database-mcp-cloudbase.md) — скилл · 962 установки

## Другие версии с тем же именем
- [database-schema-designer · softaworks](https://affpapa.org/nevibecode/skills/softaworks-database-schema-designer.md) — 4400 установок
- [database-schema-designer · alirezarezvani](https://affpapa.org/nevibecode/skills/database-schema-designer.md) — 692 установки
- [database-schema-designer · onewave-ai](https://affpapa.org/nevibecode/skills/onewave-ai-database-schema-designer.md) — 432 установки

Из того же набора: [borghei/claude-skills](https://affpapa.org/nevibecode/by/borghei/claude-skills.md) — 120 карточек

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