# alembic

Скилл ведёт миграции Alembic в проектах на SQLAlchemy: от alembic init до выката в прод и отката. Пригодится, когда схема поддержки меняется часто.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 644 установки · ★ 62
- Автор: Customer Support Tech Enablement Team
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/manutej/luxor-claude-marketplace/tree/HEAD/plugins/luxor-database-pro/skills/alembic/SKILL.md
- Обновлён: 2026-06-13
- HTML: https://affpapa.org/nevibecode/skills/alembic

## Что делает

Скилл описывает полный цикл работы с Alembic: создание ревизий вручную и через `--autogenerate`, миграции данных при смене схемы, порядок выката на dev, staging и прод. Внутри — примеры кода для `env.py`, чтение `DATABASE_URL` из переменных окружения, добавление колонок и индексов в таблицу `tickets`.

Отдельный раздел — про автогенерацию. Агент напомнит, что её результат нужно проверять глазами: переименование колонки выглядит как удаление плюс создание, смена типа требует конвертации данных, сложные ограничения и миграции данных в автогенерат не попадают. Это повод не запускать `alembic upgrade head` сразу после генерации.

Для работы нужны `alembic>=1.13.0`, `sqlalchemy>=2.0.0`, `psycopg2-binary>=2.9.0` и `pytest>=7.0.0`. Скилл заточен под PostgreSQL и системы поддержки: тикеты, оценки клиентов, версионирование схемы. Если у вас другая СУБД, примеры подключения придётся переписать.

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

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill alembic -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill alembic -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill alembic -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install manutej/luxor-claude-marketplace alembic
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill alembic -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/manutej/luxor-claude-marketplace --path plugins/luxor-database-pro/skills/alembic
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill alembic -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/manutej/luxor-claude-marketplace/tree/HEAD/plugins/luxor-database-pro/skills/alembic/SKILL.md

## Когда брать
- создать ревизию Alembic под новую колонку в таблице тикетов
- перенести данные при смене типа или значений поля
- откатить неудачную миграцию в проде
- настроить чтение строки подключения из переменных окружения
- проверить автогенерат перед выкатом

## Примеры запросов агенту
- создай миграцию Alembic для колонки priority в таблице tickets
- напиши миграцию данных: перевести старые статусы тикетов в новый enum
- проверь автогенерированную ревизию и скажи, что в ней пропущено

## Похожие
- [neon-postgres](https://affpapa.org/nevibecode/skills/neondatabase-neon-postgres.md) — скилл · 281100 установок
- [databases](https://affpapa.org/nevibecode/skills/databases.md) — скилл · 435 установок
- [neon-postgres-branches](https://affpapa.org/nevibecode/skills/neon-postgres-branches.md) — скилл · 31200 установок
- [database-migrations](https://affpapa.org/nevibecode/skills/database-migrations.md) — скилл · 5200 установок
- [planetscale-schema-recommendations-agent-loop](https://affpapa.org/nevibecode/skills/planetscale-schema-recommendations-agent-loop.md) — скилл · 1800 установок

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

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