Mejores prácticas para Agent Skills
Un resumen condensado de las 25 mejores prácticas más importantes extraídas de cada página en esta sección.
//
Busca en todas las páginas de la documentación
Un resumen condensado de las 25 mejores prácticas más importantes extraídas de cada página en esta sección.
Las skills son playbooks, no tutoriales: los archivos SKILL.md indican a los agentes cómo ejecutar - Agent Skills Basics define la estructura; EAS Build Basics enseña conceptos.
Fija el stack en cada skill: React 19.2.3, RN 0.86.0, Expo SDK 57 (expo ~57.0.4) - las skills sin versiones fijadas alucinar APIs deprecadas.
Una skill por dominio de decisión: Release, routing, native review, testing, upgrade, incident - nunca una mega-skill.
Declara inputs antes de actuar: eas.json, app.config.ts, bundle IDs, runtimeVersion, último updateId conocido como bueno - los agentes adivinan sin ellos.
Los outputs deben ser verificables: Comandos y checklists, no resúmenes de prosa - rechaza ejecuciones de skill que omitan npx expo-doctor.
Las barreras de seguridad son la sección de mayor valor: Límites OTA vs build, reglas de credenciales, pausa de rollout - ver EAS Release Skill.
Invoca skills en puntos de decisión: Primer release en producción, actualización del SDK, tormenta de crashes - no para leer documentos introductorios.
Los documentos humanos permanecen como fuente de verdad: Las skills enlazan a Typed Routes, Maestro E2E, Config Plugins - no duplicar.
Ejecuta npx expo-doctor después de cambios de dependencias: Puerta obligatoria en SDK Upgrade Skill y en cada salida de skill que toque código nativo.
Usa npx expo install en skills: Nunca fijes manualmente versiones de expo-* - la alineación del SDK 57 drifts de otro modo.
Clasifica solo JS vs impactando nativo antes de release: Native module, plugin o permission - eas build - OTA solo no es seguro.
runtimeVersion en cada invocación de skill de OTA: El desajuste necesita binary de store - Runtime Version Policy.
Las skills de Expo Router habilitan typedRoutes: Regenera con npx expo start; verifica npx tsc --noEmit - Expo Router Skill.
Valida parámetros de deep-link en runtime: Zod en entrada de pantalla - los tipos Href generados no prueban entrada maliciosa.
Las skills nativas prefieren config plugins: CNG prebuild --clean borra ios/ editado manualmente - Native Module Skill.
Solo plugins idempotentes: El segundo prebuild --clean debe producir un git diff vacío.
App bridges - Expo Modules; TurboModules para librerías de RN: RN 0.86 New Architecture por defecto - prueba en dispositivo.
Las skills de testing respetan la pirámide: Muchos Jest, pocos Maestro - Mobile Testing Skill.
El appId de Maestro debe coincidir con bundle ID: Los desajustes de nombre de pantalla causan fallos silenciosos de flujo.
E2E en builds de EAS e2e-test: Expo Go no tiene forma de producción - empareja con type: maestro de EAS Workflows.
Las skills de actualización del SDK usan ramas dedicadas: prebuild --clean, doctor, matriz de preview eas build antes de producción.
Las skills de incidentes contienen antes que diagnosticar: Pausa rollout por fases/escalonado; asigna IC - Incident Triage Skill.
Etiqueta crashes con buildNumber + updateId + route: Triage sin repro - Observability Best Practices.
Rollback de OTA < 15 minutos cuando JS regression: Registra updateId conocido como bueno en cada ticket de release - Rollback Runbook.
Actualiza las skills después de postmortems: Cada barrera de seguridad perdida se convierte en una nueva bala - versiona las skills con semver en espíritu de createRunOncePlugin.
App repo .cursor/skills/ para convenciones de eas.json específicas del proyecto; registro de org para playbooks compartidos de incidente y upgrade. Siempre fija la versión del SDK.
La skill puede hacer diffs en borrador - el capitán de release humano aprueba antes de ejecuciones no interactivas de CI. Las barreras de seguridad bloquean el envío de track de producción sin prompt explícito.
SDK Upgrade Skill orquesta las mismas puertas para agentes - las notas de release oficiales permanecen como autoridad para cambios que rompen la compatibilidad.
No. Las skills aceleran checklists; Store Incident Response y runbooks de rollback poseen autoridad de producción.
Después de cualquier bumpa del SDK, cambio de política de runtimeVersion o item de acción de postmortem. Ejecuta npx expo-doctor en la sección de verificación de skill al actualizar.
Versiones del stack: Esta página fue escrita para React 19.2.3, React Native 0.86.0 y Expo SDK 57 (
expo~57.0.4).
Revisado por Chris St. John·Última actualización: 19 jul 2026