# capacitor-app-upgrades

Ведёт агента через обновление Capacitor-проекта до новой мажорной версии, включая прыжки через несколько версий. Пригодится, когда пора перейти с 4 на 8 и не хочется разбираться в миграции вручную.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 902 установки · ★ 51
- Автор: capawesome-team
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/capawesome-team/skills/tree/HEAD/skills/capacitor-app-upgrades/SKILL.md
- Обновлён: 2026-10-20
- HTML: https://affpapa.org/nevibecode/skills/capacitor-app-upgrades

## Что делает

Скилл читает версию `@capacitor/core` из `package.json`, определяет текущую мажорную версию и спрашивает целевую. Если не указать — берёт 8. Дальше применяет шаги из файлов `references/upgrade-v4-to-v5.md` и так далее, по одному переходу за раз.

Важная деталь: `npx cap migrate` не запускается. Это интерактивная команда, агент её вызвать не может, поэтому все шаги выполняются вручную по инструкциям из reference-файлов. При прыжке через несколько версий промежуточные не пропускаются: после каждого перехода идут `npx cap sync`, сборка и проверка на обеих платформах.

Заранее проверьте окружение. Для Capacitor 8 нужны Node.js 22+, Xcode 26.0+ и Android Studio Otter 2025.2.1+; для 7 — Node.js 20+, Xcode 16.0+ и Ladybug 2024.2.1+ с Java 21. Если Android-сборка падает после обновления, скилл советует запустить Tools > AGP Upgrade Assistant в Android Studio. Скилл не для апгрейда плагинов и не для мобильных фреймворков помимо Capacitor.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add capawesome-team/skills --skill capacitor-app-upgrades -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add capawesome-team/skills --skill capacitor-app-upgrades -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add capawesome-team/skills --skill capacitor-app-upgrades -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install capawesome-team/skills capacitor-app-upgrades
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add capawesome-team/skills --skill capacitor-app-upgrades -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/capawesome-team/skills --path skills/capacitor-app-upgrades
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add capawesome-team/skills --skill capacitor-app-upgrades -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/capawesome-team/skills/tree/HEAD/skills/capacitor-app-upgrades/SKILL.md

## Когда брать
- обновить Capacitor-приложение с 4-й версии до 8-й
- пройти миграцию без интерактивной команды `npx cap migrate`
- не пропустить промежуточные версии при прыжке через несколько мажоров
- проверить сборку на Android и iOS после каждого шага апгрейда
- разобраться, какие версии Node.js, Xcode и Android Studio нужны для целевой версии

## Примеры запросов агенту
- Обнови мой Capacitor-проект с 6 на 8
- Прочитай версию `@capacitor/core` в `package.json` и скажи, какая миграция нужна
- Проведи апгрейд по шагам и после каждого запускай `npx cap sync`

## Похожие
- [capacitor-plugin-upgrades](https://affpapa.org/nevibecode/skills/cap-go-capacitor-plugin-upgrades.md) — скилл · 730 установок
- [capacitor-best-practices](https://affpapa.org/nevibecode/skills/capacitor-best-practices.md) — скилл · 2700 установок
- [mobile-app-debugging](https://affpapa.org/nevibecode/skills/secondsky-mobile-app-debugging.md) — скилл · 428 установок
- [app-ads](https://affpapa.org/nevibecode/skills/app-ads.md) — скилл · 1100 установок
- [Mobile App Design Standards](https://affpapa.org/nevibecode/skills/mobile-app-design-standards.md) — скилл · 906 установок
- [app-ui-design](https://affpapa.org/nevibecode/skills/app-ui-design.md) — скилл · 636 установок

## Другие версии с тем же именем
- [capacitor-app-upgrades · cap-go](https://affpapa.org/nevibecode/skills/cap-go-capacitor-app-upgrades.md) — 771 установка

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

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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