# upgrading-expo

Ведёт агента по шагам при апгрейде Expo SDK: команды установки, диагностика, чистка кэшей и разбор сломанных зависимостей.

- скилл · `type=skill` · Codex, ChatGPT · 2 установки · ★ 7596
- Автор: Expo Team · официальный репозиторий OpenAI
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/openai/plugins/tree/HEAD/plugins/expo/skills/upgrading-expo/SKILL.md
- Обновлён: 2026-10-08
- HTML: https://affpapa.org/nevibecode/skills/upgrading-expo

## Что делает

Скилл задаёт агенту порядок действий при переходе на новую версию Expo SDK. Он ставит `npx expo install expo@latest`, затем `npx expo install --fix`, прогоняет `npx expo-doctor` и чистит кэши через `npx expo export -p ios --clear` с удалением `node_modules` и `.expo`. Дальше агент сверяется с чеклистом ломающих изменений: удалённые API, переехавшие модули, нативные правки.

Внутри лежат справочники по конкретным версиям: миграция на новую архитектуру, переход на React 19, настройка React Compiler, изменения нативных табов, перенос аудио и видео с `expo-av` на `expo-audio` и `expo-video`. Есть таблица устаревших пакетов с заменами и отдельный раздел про бета-версии с суффиксом `.preview` под тегом `@next`.

Перед `npx expo prebuild --clean` скилл требует проверить, есть ли в проекте каталоги `ios/` и `android/`. Если их нет, проект собирается через Continuous Native Generation, и этот шаг вместе с чисткой кэшей bare-воркфлоу пропускается. Для SDK 54 и новее нужен `react-native-worklets`, иначе `react-native-reanimated` не заработает. Это повод проверить `package.json` до начала обновления, а не после.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill upgrading-expo -a codex
```

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

### Claude Code

1. **Через Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill upgrading-expo -a claude-code
```

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

### Cursor

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install openai/plugins upgrading-expo
```

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

### Gemini CLI

**Командой платформы**
```bash
gemini skills install https://github.com/openai/plugins --path plugins/expo/skills/upgrading-expo
```

### Windsurf (Devin Desktop)

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

### Claude.ai

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

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

## Когда брать
- обновить Expo SDK и не утонуть в сломанных зависимостях
- найти удалённые API и переехавшие импорты после апгрейда
- перенести аудио и видео с expo-av на expo-audio и expo-video
- почистить кэши CocoaPods, Xcode и Gradle после смены версии
- вычистить устаревшие патчи и лишние записи в конфигах Metro и PostCSS

## Примеры запросов агенту
- Обнови проект до последней версии Expo SDK и почини зависимости
- Прогони expo-doctor и разберись, что он ругает
- Проверь, какие пакеты устарели, и предложи замены

## Похожие
- [expo-web-to-native](https://affpapa.org/nevibecode/skills/expo-web-to-native.md) — скилл · 19600 установок
- [expo-react-native-coder](https://affpapa.org/nevibecode/skills/expo-react-native-coder.md) — скилл · 409 установок
- [expo-react-native-typescript](https://affpapa.org/nevibecode/skills/expo-react-native-typescript.md) — скилл · 2200 установок
- [react-native-expo-cursorrules-prompt-file](https://affpapa.org/nevibecode/rules/react-native-expo-cursorrules-prompt-file.md) — правило · ★ 41011
- [expo-module](https://affpapa.org/nevibecode/skills/expo-expo-module.md) — скилл · 45100 установок
- [limrun-expo-development](https://affpapa.org/nevibecode/skills/limrun-expo-development.md) — скилл · 43100 установок

Из того же набора: [openai/plugins](https://affpapa.org/nevibecode/by/openai/plugins.md) — 304 карточки

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

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