alembic — скилл для Claude Code: миграции базы данных
Скилл ведёт миграции Alembic в проектах на SQLAlchemy: от alembic init до выката в прод и отката. Пригодится, когда схема поддержки меняется часто.
npx skills add manutej/luxor-claude-marketplace --skill alembic -a claude-codeЧто делает 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 и системы поддержки: тикеты, оценки клиентов, версионирование схемы. Если у вас другая СУБД, примеры подключения придётся переписать.
Какие задачи решает
- создать ревизию Alembic под новую колонку в таблице тикетов
- перенести данные при смене типа или значений поля
- откатить неудачную миграцию в проде
- настроить чтение строки подключения из переменных окружения
- проверить автогенерат перед выкатом
Примеры запросов агенту
- создай миграцию Alembic для колонки priority в таблице tickets
- напиши миграцию данных: перевести старые статусы тикетов в новый enum
- проверь автогенерированную ревизию и скажи, что в ней пропущено
Как установить alembic
1Через Skills CLI (Vercel)
npx skills add manutej/luxor-claude-marketplace --skill alembic -a claude-code2Вручную: положить файлы
~/.claude/skills/alembic/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/alembic/
1Через Skills CLI (Vercel)
npx skills add manutej/luxor-claude-marketplace --skill alembic -a codex2Вручную: положить файлы
.agents/skills/alembic/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add manutej/luxor-claude-marketplace --skill alembic -a cursor2Вручную: положить файлы
.cursor/skills/alembic/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install manutej/luxor-claude-marketplace alembic2Вручную: положить файлы
.github/skills/alembic/SKILL.md1Через Skills CLI (Vercel)
npx skills add manutej/luxor-claude-marketplace --skill alembic -a gemini-cli2Командой платформы
gemini skills install https://github.com/manutej/luxor-claude-marketplace --path plugins/luxor-database-pro/skills/alembicВручную: положить файлы
.devin/skills/alembic/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add manutej/luxor-claude-marketplace --skill alembic -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о alembic
Как установить alembic в Claude?
Выполните npx skills add manutej/luxor-claude-marketplace --skill alembic -a claude-code. После этого скилл лежит в ~/.claude/skills/alembic/SKILL.md.
Что делает скилл alembic?
Помогает агенту писать и проверять миграции Alembic: ревизии, миграции данных, откаты, выкат в прод. Ориентирован на PostgreSQL и системы поддержки.
Что нужно для работы скилла?
Пакеты alembic>=1.13.0, sqlalchemy>=2.0.0, psycopg2-binary>=2.9.0 и pytest>=7.0.0. Примеры подключения рассчитаны на PostgreSQL.
