upgrading-expo

Visión general de la skill upgrading-expo

Qué hace la skill upgrading-expo

La skill upgrading-expo te ayuda a planificar y ejecutar actualizaciones del SDK de Expo con menos puntos ciegos que un prompt genérico del tipo “¿cómo actualizo Expo?”. Está centrada en el trabajo real: actualizar paquetes principales, corregir desajustes de dependencias, limpiar cachés obsoletas y detectar cambios incompatibles habituales relacionados con React, la New Architecture, Native Tabs y las migraciones de expo-av.

Quién debería usar upgrading-expo

Esta upgrading-expo skill encaja especialmente bien para desarrolladores frontend, equipos de React Native y agentes de IA que mantienen una app de Expo ya existente. Resulta más útil cuando ya tienes un proyecto y necesitas una ruta de actualización práctica, no solo un resumen de release notes.

Casos en los que mejor encaja:

• Actualizar entre versiones recientes del SDK de Expo
• Resolver fallos de instalación o de ejecución después de expo install --fix
• Migrar desde paquetes modificados o divididos, como expo-av
• Verificar si cambios específicos del SDK, como React 19 o Native Tabs, afectan a tu base de código

El trabajo real que resuelve

Quienes evalúan upgrading-expo for Frontend Development suelen querer responder rápido a tres preguntas:

1. ¿Qué secuencia de comandos debería ejecutar primero?
2. ¿Qué cambios incompatibles tienen más probabilidades de afectar a mi app?
3. ¿Qué archivos o patrones debería revisar antes de perder tiempo depurando?

Esta skill aporta valor porque reúne esas decisiones en un solo lugar y las conecta con referencias concretas de migración.

Qué la diferencia de un prompt genérico de actualización

Un prompt normal puede sugerir “actualiza Expo y ejecuta doctor”. La skill upgrading-expo va más allá al destacar temas de migración vinculados a versiones concretas desde el repositorio, entre ellos:

• valores por defecto de New Architecture en SDK 53+
• cambios de React 19 en SDK 54
• configuración de React Compiler en SDK 54+
• cambios de API de Native Tabs en SDK 55
• rutas de reemplazo de expo-av para audio y video

Eso la hace más adecuada para trabajos de actualización concretos que un prompt amplio de troubleshooting de React Native.

Lo que conviene saber antes de instalarla

Esta skill está más orientada a la guía que a la automatización. No incluye scripts que inspeccionen tu repo por ti. Su valor está en el flujo de actualización curado y en los documentos de referencia que puedes aplicar a tu propia base de código. Si buscas un migrador de un clic, esto no es eso. Si buscas una checklist de actualización de alta señal con ejemplos concretos de migración, encaja muy bien.

Cómo usar la skill upgrading-expo

Contexto de instalación de upgrading-expo

Si tu entorno de IA admite Skills, instala el repositorio de skills de Expo e invoca upgrading-expo desde ahí. Un patrón habitual es:

npx skills add https://github.com/expo/skills --skill upgrading-expo

Si tu toolchain usa otro cargador de skills, apúntalo a la ruta del repo:
plugins/expo/skills/upgrading-expo

Empieza por los archivos correctos del repositorio

Para un uso práctico de upgrading-expo, lee estos archivos en este orden:

1. SKILL.md
2. references/new-architecture.md
3. references/react-19.md
4. references/react-compiler.md
5. references/native-tabs.md
6. references/expo-av-to-audio.md
7. references/expo-av-to-video.md

Ese orden refleja los bloqueos de actualización más comunes: primero cambios de arquitectura y React; después, migraciones a nivel de funcionalidad.

Usa primero la secuencia base de actualización

El flujo base de actualización de la skill es corto y conviene seguirlo antes de entrar en una depuración más profunda:

npx expo install expo@latest
npx expo install --fix
npx expo-doctor
npx expo export -p ios --clear
rm -rf node_modules .expo
watchman watch-del-all

Por qué importa:

• expo@latest alinea el SDK
• --fix reconcilia las versiones de paquetes gestionados por Expo
• expo-doctor detecta pronto problemas de compatibilidad
• limpiar cachés elimina estado antiguo de Metro o nativo que puede parecer un bug de actualización

Si usas Linux o no usas Watchman, adapta la limpieza en consecuencia.

Cuándo conviene usar versiones preview

La skill también documenta builds beta de Expo mediante versiones .preview bajo @next. Esto resulta útil si estás validando un SDK próximo o probando una corrección que todavía no ha llegado a estable.

npx expo install expo@next --fix

Hazlo solo de forma intencional. Las actualizaciones preview no son una buena opción por defecto para apps en producción, salvo que estés probando explícitamente una pre-release.

Proporciona los datos que la skill realmente necesita

Los mejores prompts para una upgrading-expo guide incluyen tu estado actual y tu objetivo. Dale a la skill:

• versión actual del SDK de Expo
• package manager
• si usas Expo Go o development builds
• si ejecutas prebuild
• paquetes clave: expo-router, expo-av, react-native-reanimated, módulos nativos personalizados
• errores actuales de instalación, build o runtime
• fallos específicos de plataforma en iOS, Android o web

Sin ese contexto, la respuesta seguirá siendo genérica.

Convierte un objetivo impreciso en un prompt sólido

Prompt débil:

Upgrade my Expo app.

Prompt más sólido:

Use the upgrading-expo skill to move my app from Expo SDK 53 to 54. We use expo-router, expo-av, Reanimated, and development builds. After npx expo install --fix, expo-doctor reports dependency mismatches and our app fails on startup with video playback errors. Tell me the likely breaking changes, the commands to run in order, and the code areas I should inspect first.

Por qué funciona:

• indica el SDK de origen y el de destino
• enumera los paquetes de mayor riesgo
• pide una respuesta priorizada, no consejos genéricos

Relaciona tu app con las guías de referencia

Las referencias del repositorio son más útiles cuando las haces corresponder de forma deliberada con la superficie de dependencias de tu proyecto:

• ¿Usas expo-av para sonido o grabación? Lee references/expo-av-to-audio.md
• ¿Usas expo-av para video? Lee references/expo-av-to-video.md
• ¿Actualizas a SDK 55 con expo-router/unstable-native-tabs? Lee references/native-tabs.md
• ¿Pasas a SDK 53+ o 54+ con módulos nativos? Lee references/new-architecture.md
• ¿Estás en SDK 54? Revisa tanto references/react-19.md como references/react-compiler.md

Aquí es donde la skill aporta una ganancia real de información frente a una lectura rápida del repo.

Vigila las áreas de actualización de mayor riesgo

En la práctica, estos son los puntos de ruptura más habituales que destaca la skill:

• desalineación de versiones de paquetes después de subir el SDK
• incompatibilidad con New Architecture en módulos nativos antiguos
• cambios en la configuración de Reanimated, incluido react-native-worklets en SDK 54+
• cambios de API de React 19 en código de app o librerías
• migraciones de expo-av a expo-audio y expo-video
• cambios de interfaz a nivel de router en Native Tabs

Si tu app usa alguno de estos elementos, pide a la skill una checklist de migración específica en lugar de un resumen general de actualización.

Usa un flujo de trabajo en dos pasadas

Un buen patrón de uso de upgrading-expo es:

1. Pedir un plan de actualización según tus versiones y dependencias
2. Ejecutar los comandos
3. Devolver los errores exactos y pedir un plan de corrección más acotado

Esta skill funciona mejor para un triaje estructurado cuando le aportas salidas concretas de expo-doctor, TypeScript, Metro o builds nativas.

Revisa los problemas de estilo release notes que la skill da a entender

La checklist de breaking changes de la skill apunta a áreas prácticas de revisión:

• APIs eliminadas
• rutas de import modificadas
• cambios en módulos nativos que requieren prebuild
• regresiones en cámara, audio y video
• regresiones de navegación

Eso significa que tu revisión de código no debería quedarse en package.json. Busca en tu base de código los imports y componentes afectados antes de ejecutar la app.

Usa upgrading-expo con cuidado si trabajas con prebuild y código nativo

Si tu app usa módulos nativos personalizados o config plugins, la upgrading-expo skill sigue siendo útil, pero debes asumir trabajo adicional fuera de las referencias markdown. En esos proyectos, pídele a la skill que separe:

• tareas de migración solo de JS
• tareas de regeneración de prebuild
• comprobaciones de compatibilidad de dependencias nativas

Esa separación reduce la confusión durante la actualización.

Preguntas frecuentes sobre la skill upgrading-expo

¿upgrading-expo es buena para principiantes?

Sí, siempre que ya tengas un proyecto Expo y puedas compartir detalles básicos del proyecto. No es un tutorial completo sobre Expo. Es una guía centrada en actualizaciones, así que los principiantes obtienen mejores resultados si indican la versión actual del SDK, los errores y las dependencias principales.

¿Cuál es el alcance de la skill upgrading-expo?

La skill ayuda con la planificación de la actualización, el orden de los comandos y los puntos calientes de migración conocidos. No inspecciona automáticamente todo tu repo ni garantiza compatibilidad con todas las librerías nativas de terceros. Si hay una ruptura nativa profunda, puede que igualmente necesites la documentación específica del paquete y los issues de GitHub.

¿En qué se diferencia upgrading-expo de simplemente pedirle a un LLM que actualice Expo?

La diferencia principal es la curación. La upgrading-expo skill orienta al modelo hacia referencias de migración específicas de Expo que un prompt genérico puede pasar por alto, sobre todo en torno a expo-av, React 19, React Compiler, Native Tabs y el comportamiento de New Architecture.

¿Cuándo no debería usar upgrading-expo?

No la uses si:

• estás empezando una app nueva de Expo en lugar de actualizar una existente
• tu problema no está relacionado con actualizaciones del SDK
• necesitas un codemod automatizado o una herramienta CLI de migración
• tu principal bloqueo es una única librería nativa de terceros con pasos de migración propios y muy específicos

¿upgrading-expo cubre SDKs preview?

Sí. La skill indica que las versiones beta usan el sufijo .preview y se instalan desde @next. Eso es útil para probar cambios próximos, pero las actualizaciones estables siguen siendo la opción más segura por defecto.

¿upgrading-expo es solo para apps con managed workflow?

No. Es útil tanto para apps Expo managed como para apps basadas en prebuild, pero prebuild y el código nativo personalizado aumentan la probabilidad de que necesites comprobaciones manuales adicionales de compatibilidad.

Cómo mejorar la skill upgrading-expo

Indica a la skill tu delta exacto de versiones

La mejora de mayor valor es simple: indica “de SDK X a SDK Y”, no solo “actualizar Expo”. Gran parte del consejo de migración cambia de forma material según si estás entrando en SDK 53, 54 o 55.

Incluye la superficie de paquetes que cambia la respuesta

Para obtener mejores resultados con upgrading-expo, incluye los paquetes que activan los documentos de referencia:

• expo-av
• expo-router
• react-native-reanimated
• módulos nativos personalizados
• cualquier paquete que falle en expo-doctor

Esto permite que la skill pase de checklists genéricas a orientación basada en impacto probable.

Pega diagnósticos reales, no paráfrasis

Mal:

build failed after upgrade

Mejor:

npx expo-doctor says package versions are invalid, Metro reports unresolved import from expo-av, and iOS dev build fails after enabling New Architecture.

Los logs exactos ayudan a la skill a distinguir entre deriva de dependencias y problemas de migración de API.

Pide una salida priorizada

Un formato de solicitud sólido es:

1. comandos que debo ejecutar ahora
2. fallos probables ordenados por probabilidad
3. archivos/imports que debo buscar
4. pasos de verificación después de aplicar correcciones

Esa estructura hace que la upgrading-expo guide sea mucho más fácil de ejecutar cuando vas con prisa.

Separa los fallos de instalación de las migraciones de código

Un modo de fallo frecuente es mezclar problemas de instalación de paquetes con cambios de API a nivel de código fuente. Pide a la skill que los trate en este orden:

• alineación de dependencias
• salida de doctor
• reinicio de caché
• migraciones de código fuente
• verificación en runtime

Esto reduce la depuración circular.

Solicita patrones de búsqueda específicos para tu base de código

Una de las mejores formas de mejorar la salida de la upgrading-expo skill es pedir objetivos de búsqueda tipo grep. Ejemplo:

Using the upgrading-expo skill, list the import paths, component names, and hooks I should search for to migrate from expo-av and to verify Native Tabs changes in SDK 55.

Eso convierte una orientación amplia en tareas accionables de revisión de código.

Valida las rutas de riesgo después de la primera pasada

Después del primer intento de actualización, prueba de forma específica:

• reproducción y grabación de audio
• reproducción de video
• navegación por pestañas
• arranque en Expo Go frente a dev build
• cualquier pantalla que use animación intensiva o módulos nativos

Estas son las áreas donde es más probable que afloren problemas de transición entre SDKs cubiertos por la skill.

Itera con prompts de seguimiento más acotados

No le pidas a la skill que resuelva toda la actualización una y otra vez. Acota el segundo prompt:

• “Focus only on React 19 changes in my shared UI package”
• “Focus only on expo-av video migration”
• “Focus only on New Architecture incompatibilities”

Los alcances más pequeños suelen producir pasos de corrección más claros y más precisos.