SKILL 53 · AGENT SKILL
Expo Upgrade
Organiza atualizações do Expo SDK, alinhamento de dependências, diagnóstico e migrações nativas para agentes de programação.
FONTE PRIMÁRIA
Confira o projeto original.
A imagem é uma ilustração editorial exclusiva. A origem, a licença e as permissões devem ser conferidas no repositório oficial antes da instalação.
Abrir repositório original ↗
O QUE ESTA SKILL VERIFICA
O que ela coloca na mesa.
✓Atualize uma versão do SDK por vez e leia o changelog da versão-alvo
✓Peça um plano antes de autorizar comandos de terminal
✓Confirme se ios e android são gerados ou mantidos manualmente
✓Revise package.json, lockfile, código nativo, testes e rollback antes de avançar
DETALHES DA SKILL
Como esta skill funciona na prática.
Entenda a função, o melhor cenário de uso e o resultado que você deve revisar antes de incluir esta skill no seu fluxo de trabalho.
Quando ela é útil
Atualizações incrementais do Expo SDK, correção de dependências, diagnóstico, migração de APIs e revisão de projetos nativos iOS e Android.
O que ela faz
Organiza atualizações do Expo SDK, alinhamento de dependências, diagnóstico e migrações nativas para agentes de programação.
O que você deve receber
Plano de upgrade com dependências alinhadas, mudanças de versão identificadas e validação explícita antes de qualquer promoção.
Onde pode ser usada
Codex, Claude Code e outros agentes compatíveis com Agent Skills; comandos dependem do ambiente Expo do projeto
Limite importante
As instruções citam comandos que usam rede, alteram dependências, limpam caches e podem regenerar projetos nativos. Revise o diff, confirme CNG ou fluxo bare e mantenha controle de versão e rollback.
ANÁLISE EDITORIAL
Imagem editorial: ilustração exclusiva do Bastidores da IA. Não é captura de tela, interface real nem prova de uma atualização executada.
Atualizar um aplicativo Expo parece simples quando o plano cabe em uma linha: trocar a versão do SDK e alinhar dependências. Na prática, a mudança pode alcançar navegação, módulos nativos, áudio, vídeo, caches, projetos iOS e Android e configurações que sobreviveram a versões anteriores. A Expo Upgrade é uma Skill oficial que organiza esse trabalho para agentes de programação sem transformar uma sequência de comandos em garantia de migração segura.
Por que o upgrade não termina no package.json
A Skill reúne um roteiro para atualizar o Expo SDK, corrigir dependências incompatíveis, executar diagnósticos e revisar mudanças relevantes entre versões. O arquivo principal aponta referências específicas para React 19, nova arquitetura, React Compiler, abas nativas, migração de expo-av e adoção do Expo Router.
Ela não examina seu projeto antes de ser carregada, não cria backup, não conhece a cobertura dos testes e não decide sozinha se os diretórios ios/ e android/ podem ser regenerados. Instalar a Skill acrescenta instruções ao contexto do agente; executar comandos continua dependendo das ferramentas, permissões e confirmações dadas no ambiente real.
Nove arquivos, um commit e uma versão declarada
Esta curadoria fixou o commit ea6f1492f4e69e5b530c3fb8162728a1b0d982eb do repositório oficial expo/skills. A pasta expo-upgrade contém 9 arquivos: o manifesto SKILL.md, sete referências em Markdown e o metadado agents/openai.yaml. Não há script, binário, dependência empacotada ou credencial.
O manifesto declara versão 1.0.0 e licença MIT. O repositório é mantido pela equipe Expo e apresenta as Skills como oficiais, mas também diz que a documentação, o Expo CLI e o EAS CLI continuam sendo a fonte de verdade. Por isso, o commit identifica exatamente a cópia revisada, enquanto o changelog do SDK deve ser consultado para a versão que será instalada.
A trilha oficial que o agente recebe
O fluxo sugerido passa por alinhar o pacote expo e suas dependências, executar expo-doctor, revisar notas da versão e verificar APIs removidas, importações alteradas e módulos nativos. Há checklists separados para câmera, áudio, vídeo e navegação, além de referências de migração que evitam resumir mudanças grandes a uma substituição de nome.
A orientação mais útil é distinguir projetos com Continuous Native Generation (CNG) de fluxos que mantêm projetos nativos. Antes de citar prebuild --clean, a Skill manda verificar se ios/ ou android/ existem. Essa diferença importa porque regenerar pastas nativas pode descartar ajustes manuais. O comando não deve ser executado como limpeza genérica.
Duas formas de instalar, com escopos diferentes
Para Codex, a documentação oficial do repositório recomenda instalar o plugin Expo pelo marketplace curado, com codex plugin add expo@openai-curated. Para clientes compatíveis com o padrão Agent Skills, a alternativa focada é npx skills@latest add expo/skills --skill expo-upgrade. Faça a instalação no projeto que será revisado, fixe a origem recebida e examine os arquivos antes de permitir qualquer ferramenta de terminal.
A Expo lista Codex, Claude Code e diversos agentes compatíveis. Isso não significa comportamento idêntico: descoberta automática, caminhos de instalação, prompts de confirmação, hooks e acesso a terminal variam por cliente. O ZIP local desta página contém somente a pasta da Skill, a licença e o registro de origem; não inclui o plugin completo, configuração MCP ou hooks.
Os comandos que exigem confirmação
Os arquivos copiados são texto e não executam nada por conta própria. Ainda assim, as instruções citam npx, reinstalação de dependências, rm -rf node_modules .expo, limpeza do Watchman, expo prebuild --clean, CocoaPods e Gradle. Esses comandos podem usar rede, alterar package.json e lockfiles, apagar caches e regenerar código nativo.
O manifesto também oferece um comando npx --yes submit-expo-feedback para enviar feedback quando houver um problema concreto. Ele não deve ser executado automaticamente. A telemetria do plugin Expo é declarada como opcional e desligada por padrão, mas essa política pertence ao plugin completo; a cópia local auditada não contém seus hooks de telemetria.
Teste incremental antes do aplicativo real
- Comece em uma branch limpa, registre a versão atual do SDK e confirme que o aplicativo compila antes da mudança.
- Atualize uma versão de SDK por vez, como recomenda a documentação oficial da Expo.
- Peça ao agente primeiro um plano e uma lista de arquivos afetados, sem autorização para executar comandos destrutivos.
- Revise o changelog da versão-alvo, o
package.json, o lockfile e qualquer alteração emios/ouandroid/. - Execute diagnóstico, testes e builds no ambiente de desenvolvimento; só avance depois de verificar o diff e a rota de rollback pelo controle de versão.
Redistribuição com a fonte oficial separada
O repositório usa licença MIT, preservada no ZIP junto dos arquivos oficiais e de um registro de origem. A licença permite redistribuição com manutenção do aviso e não oferece garantia. O download local existe para auditoria e reprodutibilidade; o repositório oficial permanece como ação separada para acompanhar correções e versões futuras.
Referências primárias
CONFIGURAÇÃO
Instale só depois de ler.
Abra a fonte oficial, leia README e licença, fixe uma versão ou commit e só então siga o método indicado pelo mantenedor. Não execute comandos copiados de comentários ou vídeos sem revisão.
Codex: plugin oficial
codex plugin add expo@openai-curatedO plugin oficial reúne as Skills da Expo. Revise os arquivos e mantenha cada execução de terminal sujeita a confirmação; para instalar somente esta Skill em outro cliente, consulte o repositório oficial.
Abra a fonte e o README
- Confira mantenedor e nome do repositório.
- Leia licença, requisitos e permissões.
- Escolha uma versão ou commit para aprovar.
Comece em um projeto de teste
- Use o comando acima ou o método do README.
- Prefira instalação por projeto antes da global.
- Não copie tokens, chaves ou arquivos sensíveis.
Faça um teste pequeno
- Confirme a descrição e os arquivos instalados.
- Execute uma tarefa reversível.
- Registre versão aprovada e remova o que não usar.