# capacitor-plugin-upgrades

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

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

## Что делает

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

При прыжке через несколько версий шаги идут строго по порядку, промежуточные пропускать нельзя. После каждого перехода — `npm install && npx cap sync`, сборка и проверка тестового приложения плагина. Внутри разбираются Android SDK targets, конфигурация Gradle, версии Java/Kotlin и iOS deployment targets, плюс ручной разбор каждого шага, если автоматические инструменты миграции упали.

Нужен Node.js и npm, причём минимальная версия зависит от целевой версии Capacitor: для 5 это 16+, для 6 — 18+, для 7 — 20+, для 8 — 22+. Проект должен быть именно плагином, а не приложением: для апгрейда самого приложения есть отдельный скилл `capacitor-app-upgrades`. Если сборка под Android падает после обновления, скилл советует запустить **Tools > AGP Upgrade Assistant** в Android Studio.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- обновить плагин Capacitor с версии 4 до 8
- перейти с Capacitor 5 на 6 без пропуска шагов
- починить упавшую Android-сборку после апгрейда
- разобрать вручную шаги, на которых сломался автоматический мигратор
- проверить тестовое приложение плагина после каждого перехода

## Примеры запросов агенту
- обнови плагин Capacitor до 8-й версии
- переведи плагин с Capacitor 5 на 7
- после апгрейда падает Android-сборка — что делать

## Похожие
- [capacitor-app-upgrade-v6-to-v7](https://affpapa.org/nevibecode/skills/capacitor-app-upgrade-v6-to-v7.md) — скилл · 643 установки
- [android-native-dev](https://affpapa.org/nevibecode/skills/android-native-dev.md) — скилл · 2700 установок
- [kotlin-multiplatform](https://affpapa.org/nevibecode/skills/kotlin-multiplatform.md) — скилл · 1600 установок
- [rnrepo](https://affpapa.org/nevibecode/skills/rnrepo.md) — скилл · 1100 установок
- [assess-react-native-migration](https://affpapa.org/nevibecode/skills/assess-react-native-migration.md) — скилл · 2100 установок

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

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

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

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