Полная документация ниже — автоматически из репозитория nickonai/ru-deploy-skill (ветка main). Оригинальные материалы проекта распространяются на условиях его лицензии.

ru-deploy

Скилл (Agent Skill) для переезда проекта с Lovable на российский сервер Cloud.ru — со своим доменом, бесплатным HTTPS, почтой и платежами. Всё в России, по 152-ФЗ.

Вы сделали сайт в Lovable (Vite + React + Supabase), но из России он работает нестабильно: фронтенд, база и AI-функции живут за рубежом. ru-deploy — это набор инструкций и скриптов для ИИ-агента (Claude Code или Codex), который сам проводит вас по всему переезду: поднимает self-hosted Supabase на виртуалке Cloud.ru, подключает домен и HTTPS, настраивает почту для сброса пароля и платежи YooKassa.

Принцип простой: агент делает сложное, вы — простое. Вам не нужно знать ssh, Docker или YAML. Вы регистрируетесь на Cloud.ru, нажимаете кнопки в личном кабинете, копируете пару ключей — остальное агент делает за вас.

⚠️ Статус: ранняя версия. Лицензия MIT — пользуйтесь, форкайте, присылайте улучшения.

Что вы получите

• 🇷🇺 Сайт на своём домене, на сервере в России (Cloud.ru free tier подходит).
• 🗄️ Своя база, авторизация, хранилище, edge-функции — self-hosted Supabase.
• 🔒 Бесплатный HTTPS (Let’s Encrypt через Caddy) — настраивается автоматически.
• ✉️ Почта (сброс пароля, подтверждение email) через российский SMTP.
• 💳 Платежи YooKassa с защитой вебхука.
• 🤖 Понятный «шов» для AI-функции, если она была (GigaChat / YandexGPT).

Что вам понадобится

• Проект на Lovable (или экспортированный из него репозиторий) у вас на компьютере.
• Аккаунт на Cloud.ru. Сама free-tier виртуалка бесплатна, но публичный IP — нет (~146 ₽/мес). При привязке банковской карты Cloud.ru даёт 4000 ₽ бонусами на 60 дней — их хватает оплатить IP примерно на 2 месяца, так что первый запуск фактически бесплатный.
• При создании виртуалки вы сами задаёте логин и пароль — запомните их, агент попросит IP, логин и пароль, чтобы заходить на сервер (он хранит их в локальном файле .ru-deploy/credentials.env, который не попадает в git).
• Домен — необязательно покупать. По умолчанию используется бесплатный <IP-сервера>.sslip.io (ничего регистрировать не нужно). Хотите «красивое» имя — можно подключить свой .ru за ~189 ₽/год. Подробно — в инструкции по домену.
• Утилита sshpass на вашем компьютере (агент подскажет установку: macOS — brew install hudochenkov/sshpass/sshpass, Windows — через WSL, Linux — apt install sshpass). Нужна, чтобы агент заходил на сервер по паролю.
• Установленный Claude Code или Codex (см. ниже).

Установка скилла

ru-deploy — это Agent Skill: папка с SKILL.md, references/ и assets/. Установить можно в Claude Code или в Codex.

Сам скилл лежит в этом репозитории в папке skills/ru-deploy/. Устанавливается копированием именно этой папки в каталог скиллов агента (README.md и LICENSE из корня копировать не нужно).

Вариант 1. Claude Code

Личный скилл (доступен во всех ваших проектах):

git clone https://github.com/nickonai/ru-deploy-skill.git /tmp/ru-deploy
cp -r /tmp/ru-deploy/skills/ru-deploy ~/.claude/skills/ru-deploy

Либо для конкретного проекта — скопируйте папку в .claude/skills/ru-deploy внутри репозитория проекта (так скилл коммитится вместе с проектом и доступен команде):

cp -r /tmp/ru-deploy/skills/ru-deploy .claude/skills/ru-deploy

После этого SKILL.md должен лежать прямо по пути ~/.claude/skills/ru-deploy/SKILL.md. Перезапустите Claude Code — скилл подхватится автоматически. Проверьте: спросите «какие у тебя есть скиллы» или начните с триггера ниже.

Вариант 2. Codex

Codex читает те же скиллы. Скопируйте ту же папку в каталог скиллов Codex:

git clone https://github.com/nickonai/ru-deploy-skill.git /tmp/ru-deploy
cp -r /tmp/ru-deploy/skills/ru-deploy ~/.codex/skills/ru-deploy

Codex CLI также находит скилл в ~/.agents/skills/ru-deploy и в .agents/skills/ru-deploy внутри проекта (проверено на Codex CLI 0.166 командой codex debug prompt-input, без вызова модели). Структура SKILL.md + references/ + assets/ одинаковая; если ваша сборка использует другой каталог, положите папку туда.

Скрипты из assets/ и тексты из references/ не зависят от агента — работают и там, и там.

Как пользоваться

1. Откройте свой Lovable-проект в редакторе с установленным агентом (Claude Code или Codex).

2. Напишите агенту простыми словами, например:

   Перенеси мой проект с Lovable на российский сервер Cloud.ru

   или один из триггеров: ru-deploy, «задеплоить lovable на российский сервер», «мой проект с lovable не работает в России», «свой сервер для lovable проекта».

3. Агент сам осмотрит проект и проведёт вас по шагам. От вас потребуется только:

   • зарегистрироваться на Cloud.ru и создать виртуалку (агент подскажет конфигурацию);
   • получить домен и указать его на сервер (агент даст точную инструкцию; можно бесплатный);
   • скопировать пару ключей из личных кабинетов (Cloud.ru, при необходимости YooKassa / SMTP).

   Всё остальное — установка backend, HTTPS, заливка фронта, настройка функций — агент делает сам.

4. Работа идёт стадиями с остановками: перед каждой стадией агент простыми словами объясняет, что будет делать, спрашивает ваше разрешение, выполняет, показывает результат — и только потом переходит к следующей. Никакого «убежал и всё сделал сам без объяснений». Стадии: осмотр → сервер и доступ → backend → сайт → (почта/платежи/AI, если нужны) → финальная проверка.

Совет: если чего-то не поняли — так и напишите агенту «объясни проще». Скилл специально написан без жаргона и ведёт по одному шагу за раз.

Что внутри (для разработчиков)

ru-deploy/                            # репозиторий
├── README.md                         # этот файл
├── LICENSE                           # MIT
└── skills/
    └── ru-deploy/                    # ← сам скилл (копируется в каталог скиллов агента)
        ├── SKILL.md                  # точка входа: протокол стадий, карта стадий, ворота подтверждения, правила безопасности
        ├── references/               # подробные справочники (агент читает по необходимости)
        │   ├── access.md             #   доступы, sshpass, первый вход по SSH
        │   ├── steps-a-b-inspect-server.md      # стадии A-B: осмотр, сервер (шаги 0-1)
        │   ├── steps-c-backend.md               # стадия C: backend, миграции, функции (шаги 2-4)
        │   ├── steps-d-frontend-domain.md       # стадия D: фронт и смена домена (шаги 5-6)
        │   ├── steps-e-g-mail-payments-ai.md    # стадии E-G: почта, платежи, AI (шаги 7-9)
        │   ├── operations.md         #   итоговая проверка, статус продакшена, место на диске
        │   ├── cloudru-setup.md      #   виртуалка, домен, DNS, HTTPS (+ бесплатный домен)
        │   ├── backend-supabase.md   #   self-hosted Supabase, миграции, edge-функции
        │   ├── email-smtp.md         #   почта/SMTP, SPF/DKIM/DMARC, русские шаблоны писем
        │   ├── payments-yookassa.md  #   платежи YooKassa + защита вебхука
        │   ├── ai-provider.md        #   замена AI на GigaChat / YandexGPT
        │   └── troubleshooting.md    #   типовые ошибки + финальная проверка
        └── assets/                   # скрипты и шаблоны (запускает агент)
            ├── server-setup.sh       #   установка Supabase + Caddy на сервере одним скриптом
            ├── deploy.sh             #   сборка/заливка фронта и edge-функций
            ├── gen-keys.py           #   генерация всех ключей Supabase
            ├── Caddyfile             #   конфиг Caddy (раздача фронта + reverse proxy + HTTPS)
            ├── env.example           #   пример переменных окружения (только плейсхолдеры)
            └── email-templates/      #   русские HTML-шаблоны писем

Безопасность

• Скилл никогда не коммитит и не показывает секреты — все ключи живут только на сервере, в репозитории только плейсхолдеры (assets/env.example).
• Наружу на сервере открываются только порты 22/80/443; API Supabase ходит через Caddy.
• Для платежей YooKassa скилл добавляет перепроверку статуса через API — чтобы нельзя было подделать «оплачено» (см. payments-yookassa.md).

Вклад в проект

PR и issue приветствуются. Скилл должен оставаться понятным новичку: простой язык, один шаг за раз, агент делает тяжёлую работу сам. Если добавляете шаг или провайдера — обновите соответствующий файл в references/ и при необходимости карту шагов в SKILL.md.

Лицензия

MIT — используйте свободно, в том числе в коммерческих проектах.

Не аффилировано с Lovable, Cloud.ru, Supabase, YooKassa или Anthropic. Все упомянутые сервисы принадлежат их владельцам.