Conceptos Básicos de Agent Skills

Q: ¿Las skills deben vivir en el app repo o un registro central?

App repo para convenciones de eas.json y routing específicas del proyecto. Registro central para playbooks de release e incident de toda la organización. Siempre fija la versión SDK en ambos.

Q: ¿Qué tan a menudo deberíamos refrescar skills?

Cada SDK upgrade, cada cambio a política de runtimeVersion, y después de cualquier postmortem que revele un guardrail perdido. Ejecuta npx expo-doctor en la sección de verificación de la skill.

Qué contiene una Agent Skill de SME móvil y cuándo invocarla - diez ejemplos para equipos que usan asistentes AI en Expo SDK 57 (expo ~57.0.4), React Native 0.86.0 y React 19.2.3. Estas páginas documentan skills, no código de aplicación. Una skill es un playbook SKILL.md que tu agente lee antes de actuar.

Requisitos Previos

Las skills viven en tu repositorio (o registro de skills del equipo) junto a la aplicación que gobiernan:

.cursor/skills/
├── eas-release/
│   └── SKILL.md
├── expo-router/
│   └── SKILL.md
├── mobile-testing/
│   └── SKILL.md
└── sdk-upgrade/
    └── SKILL.md

Fija el stack en cada header de skill para que los agentes nunca se desvíen a APIs obsoletas:

## Stack pin
- React 19.2.3
- React Native 0.86.0
- Expo SDK 57 (`expo` ~57.0.4)

Alcance: Las skills orquestan cómo debe trabajar un agente. Los cookbooks legibles en Conceptos Básicos de EAS Build, Conceptos Básicos de Expo Router y Conceptos Básicos de Mobile Testing siguen siendo la referencia autoritaria.

Ejemplos Básicos

1. Qué es una Agent Skill

Una Agent Skill es un archivo de instrucciones estructurado - típicamente SKILL.md - que le dice a un asistente AI qué hacer, qué preguntar y qué no hacer en una tarea móvil.

Artefacto de skill	Propósito
`SKILL.md`	Trigger phrases, inputs, outputs, guardrails
`references/`	Enlaces profundos opcionales a ADRs internos o runbooks
`examples/`	Prompts de invocación que pasaron revisión

Las skills no son tutoriales de características - son contratos operativos para desarrollo asistido
Las skills deben ser pinned a SDK - los agentes alucina APIs antiguas de expo-router sin contexto de versión explícito
Una skill = un dominio de decisión (release, routing, revisión de módulo nativo, triage de incidents)

2. Estructura Mínima de SKILL.md

Cada skill móvil debe abrirse con el mismo esqueleto:

# EAS Release Skill
 
## What this skill does
Guides build -> submit -> OTA with guardrails for SDK 57.
 
## When to invoke
- Before first production `eas build`
- When adding a new `eas.json` profile
- When planning a JS-only hotfix vs store binary
 
## Inputs (required)
- `eas.json`, `app.config.ts`, target channel/branch
- Last known-good `updateId` for rollback context
 
## Outputs
- Step checklist with commands
- Risk callouts (credentials, runtimeVersion)
- Verification commands (`eas channel:view`, `npx expo-doctor`)
 
## Guardrails
- Never OTA native-impacting changes without `eas build`
- Never submit to production track without internal QA binary
 
## Stack pin
React 19.2.3 - RN 0.86.0 - Expo SDK 57
 
## Example prompts
See -10 below.

Los Inputs previenen que el agente adivine bundle IDs o pierda runtimeVersion
Los Outputs deben ser verificables - comandos, no prosa
Los Guardrails son la sección de mayor valor - los agentes sobre-automatizan acciones de store sin ellos

3. Cuándo Invocar vs Cuándo Leer Documentación

Situación	Usa una skill	Lee documentación humana
"Scaffold `eas.json` para preview - production"	EAS Release Skill	Build Profiles & Flavors
"Agrega typed route para `/orders/[id]`"	Expo Router Skill	Typed Routes
"Escribe Maestro a partir de criterios de aceptación"	Mobile Testing Skill	Maestro E2E
"Actualiza 56 - 57"	SDK Upgrade Skill	SDK Upgrade Policy
"Spike de crash después de OTA"	Incident Triage Skill	Rollback Runbook

Invoca skills en puntos de decisión donde la automatización incorrecta es cara
Lee documentación cuando estés aprendiendo conceptos - las skills asumen que quieres un plan ejecutable ahora

4. Inputs que el Agente Debe Recolectar

Antes de ejecutar, una skill bien escrita fuerza al agente a reunir:

## Inputs checklist
- [ ] `package.json` expo/react/react-native versions
- [ ] `app.config.ts` - scheme, bundleId, runtimeVersion policy
- [ ] `eas.json` profiles in scope
- [ ] Target platform(s): ios | android | all
- [ ] CNG mode: generated native dirs vs checked-in ios/android
- [ ] Incident context (if triage): buildNumber, channel, crash-free delta

Falta bundle ID / applicationId rompe skills de Maestro y submit
Falta runtimeVersion rompe skills de OTA - ver Runtime Version Policy
Los agentes deben pegar valores recolectados de vuelta al humano para confirmación antes de comandos destructivos

5. Outputs que Debes Esperar

Una ejecución de skill debe terminar con entregables concretos:

Tipo de output	Ejemplo
Secuencia de comandos	`eas build --profile production --platform all`
Config diff	snippet de perfil submit de `eas.json`
Plan de prueba	casos Jest - outline de `.maestro/checkout.yml`
Checklist de revisión	idempotencia de config plugin - gate de `expo-doctor`
Árbol de decisión	rollback de OTA vs store hotfix con timestamps

Sin output - skill fallida - rechaza respuestas de agente que solo resumen documentación
Los outputs deben referenciar verificación - npx tsc --noEmit, npm test, eas channel:view
Para SDK 57, siempre incluye npx expo-doctor cuando dependencias o plugins cambian

6. Guardrails que Cada Mobile Skill Necesita

Copia estos defaults en cada SKILL.md:

## Guardrails (SDK 57)
1. Use `npx expo install` - never hand-pin Expo module versions.
2. OTA (`eas update`) only when `runtimeVersion` matches live store binaries.
3. Native module or permission changes require `eas build`, not OTA alone.
4. Never commit secrets - EAS environments and CI secrets only.
5. Run `npx expo-doctor` before merging skill-generated dependency changes.
6. Do not edit generated `ios/` / `android/` under CNG - use config plugins.
7. Pause phased/staged store rollout before hotfix binary when crash storm is live.

Los guardrails convierten entusiasmo de agente en disciplina de release-engineering
Empareja con Agent Skills Best Practices para reglas de equipo

7. Pinning SDK 57 en Skills

Los agentes por defecto a versiones de training data. Fija explícitamente:

## Stack pin (required)
| Package | Version |
| --- | --- |
| react | 19.2.3 |
| react-native | 0.86.0 |
| expo | ~57.0.4 |
 
## SDK 57 specifics
- New Architecture defaults on RN 0.86 - verify TurboModule skills against NA-enabled builds.
- `experiments.typedRoutes` generates `.expo/types/router.d.ts` - regen after `app/` changes.
- EAS Workflows support `type: maestro` jobs - prefer over ad-hoc shell scripts.

Re-fija skills en cada SDK bump - skills obsoletas son peor que sin skills
Verifica output de agente cruzado con npx expo-doctor y npx expo install --check

8. Composición de Skill (No Dupliques Documentación)

Las skills delegan a documentación humana; no la reemplazan:

## References (read, don't rewrite)
- Build: ../eas-build/eas-build-basics/eas-build-basics.md
- Submit: ../eas-build/eas-submit/eas-submit.md
- OTA: ../ota-updates/ota-updates-basics/ota-updates-basics.md
- Router: ../expo-router/typed-routes/typed-routes.md
- Testing: ../testing/jest-setup-for-expo/jest-setup-for-expo.md

Output de skill = plan - comandos - gates
Output de doc = conceptos - edge cases - FAQs
Enlaza ambas direcciones: skills apuntan a docs; docs pueden decir "invoca X skill para setup asistido"

9. Verificando Output de Skill

Después de cualquier cambio asistido por skill:

# Dependency / native alignment
npx expo-doctor
 
# Type safety (router, TS strict)
npx tsc --noEmit
 
# Unit/component gate
npm run test:ci
 
# Optional E2E smoke (Maestro)
maestro test .maestro/smoke.yml

Verificación	Detecta
`expo-doctor`	SDK skew, misconfigured plugins, invalid app config
`tsc`	Broken typed routes, invalid `Href`
Jest	Regressions en business logic que el agente refactorizó
Maestro	Navigation y native chrome que el agente no mockeó

Trata output de skill como un PR de ingeniero junior - revisa antes de merge
CI debe ejecutar los mismos gates - ver CI Quality Gates

10. Ejemplo de Prompts de Invocación

EAS release:

Use the EAS Release skill. Stack: Expo SDK 57, RN 0.86.
Inputs: eas.json attached, production channel, last good updateId abc123.
Goal: JS hotfix for checkout copy - confirm OTA is safe, then give commands.
Guardrails: no store submit unless doctor fails on native change.

Expo Router:

Use the Expo Router skill. Add /settings/notifications with typed params.
Enable experiments.typedRoutes. Provide href builder + deep link scheme myapp://.
Run tsc verification steps.

Mobile testing:

Use the Mobile Testing skill.
Acceptance criteria:
- Guest can add item to cart
- Cart badge shows count
Deliver: 3 Jest tests + 1 Maestro flow. SDK 57, appId com.example.shop.

SDK upgrade:

Use the SDK Upgrade skill. Upgrade expo 56 - 57.
Produce ordered checklist with expo-doctor gates and breaking-change scan.
Do not skip lockfile regen or prebuild --clean recommendation.

Incident triage:

Use the Incident Triage skill.
Crash-free dropped 99.2% - 94% after production OTA 30 min ago.
buildNumber 240012, iOS phased at 50%. Decision tree: OTA rollback vs pause vs hotfix binary.

FAQs

¿Las Agent Skills son lo mismo que Expo config plugins?

No. Los config plugins modifican proyectos nativos en prebuild. Las Agent Skills instruyen a asistentes AI cómo realizar workflows de equipo de forma segura. Puedes invocar el Native Module Skill para revisar un config plugin - capas diferentes.

¿Las skills deben vivir en el app repo o un registro central?

App repo para convenciones de eas.json y routing específicas del proyecto. Registro central para playbooks de release e incident de toda la organización. Siempre fija la versión SDK en ambos.

¿Puede una SKILL.md cubrir el stack móvil completo?

Evítalo. Divide por dominio de decisión para que guardrails se mantengan afilados. Una skill monolítica diluye límites OTA vs native y produce automatización insegura.

¿Las skills reemplazan runbooks on-call?

No. Las skills aceleran redacción de checklists y comandos. El Incident Triage Skill complementa - no reemplaza - Store Incident Response.

¿Qué tan a menudo deberíamos refrescar skills?

Cada SDK upgrade, cada cambio a política de runtimeVersion, y después de cualquier postmortem que revele un guardrail perdido. Ejecuta npx expo-doctor en la sección de verificación de la skill.

EAS Release Skill - build, submit, OTA cookbook
Expo Router Skill - routes, typed params, deep links
Mobile Testing Skill - Jest + Maestro from AC
SDK Upgrade Skill - Expo 57 upgrade checklist
Incident Triage Skill - crash clusters and rollback tree
Agent Skills Best Practices - 25-item team summary
EAS Build Basics - human reference for builds
Mobile Testing Basics - testing pyramid

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).

Requisitos Previos

Las skills viven en tu repositorio (o registro de skills del equipo) junto a la aplicación que gobiernan:

.cursor/skills/
├── eas-release/
│   └── SKILL.md
├── expo-router/
│   └── SKILL.md
├── mobile-testing/
│   └── SKILL.md
└── sdk-upgrade/
    └── SKILL.md

Fija el stack en cada header de skill para que los agentes nunca se desvíen a APIs obsoletas:

## Stack pin
- React 19.2.3
- React Native 0.86.0
- Expo SDK 57 (`expo` ~57.0.4)

Alcance: Las skills orquestan cómo debe trabajar un agente. Los cookbooks legibles en Conceptos Básicos de EAS Build, Conceptos Básicos de Expo Router y Conceptos Básicos de Mobile Testing siguen siendo la referencia autoritaria.

Ejemplos Básicos

1. Qué es una Agent Skill

Una Agent Skill es un archivo de instrucciones estructurado - típicamente SKILL.md - que le dice a un asistente AI qué hacer, qué preguntar y qué no hacer en una tarea móvil.

Artefacto de skill	Propósito
`SKILL.md`	Trigger phrases, inputs, outputs, guardrails
`references/`	Enlaces profundos opcionales a ADRs internos o runbooks
`examples/`	Prompts de invocación que pasaron revisión

Las skills no son tutoriales de características - son contratos operativos para desarrollo asistido
Las skills deben ser pinned a SDK - los agentes alucina APIs antiguas de expo-router sin contexto de versión explícito
Una skill = un dominio de decisión (release, routing, revisión de módulo nativo, triage de incidents)

2. Estructura Mínima de SKILL.md

Cada skill móvil debe abrirse con el mismo esqueleto:

# EAS Release Skill
 
## What this skill does
Guides build -> submit -> OTA with guardrails for SDK 57.
 
## When to invoke
- Before first production `eas build`
- When adding a new `eas.json` profile
- When planning a JS-only hotfix vs store binary
 
## Inputs (required)
- `eas.json`, `app.config.ts`, target channel/branch
- Last known-good `updateId` for rollback context
 
## Outputs
- Step checklist with commands
- Risk callouts (credentials, runtimeVersion)
- Verification commands (`eas channel:view`, `npx expo-doctor`)
 
## Guardrails
- Never OTA native-impacting changes without `eas build`
- Never submit to production track without internal QA binary
 
## Stack pin
React 19.2.3 - RN 0.86.0 - Expo SDK 57
 
## Example prompts
See -10 below.

Los Inputs previenen que el agente adivine bundle IDs o pierda runtimeVersion
Los Outputs deben ser verificables - comandos, no prosa
Los Guardrails son la sección de mayor valor - los agentes sobre-automatizan acciones de store sin ellos

3. Cuándo Invocar vs Cuándo Leer Documentación

Situación	Usa una skill	Lee documentación humana
"Scaffold `eas.json` para preview - production"	EAS Release Skill	Build Profiles & Flavors
"Agrega typed route para `/orders/[id]`"	Expo Router Skill	Typed Routes
"Escribe Maestro a partir de criterios de aceptación"	Mobile Testing Skill	Maestro E2E
"Actualiza 56 - 57"	SDK Upgrade Skill	SDK Upgrade Policy
"Spike de crash después de OTA"	Incident Triage Skill	Rollback Runbook

Invoca skills en puntos de decisión donde la automatización incorrecta es cara
Lee documentación cuando estés aprendiendo conceptos - las skills asumen que quieres un plan ejecutable ahora

4. Inputs que el Agente Debe Recolectar

Antes de ejecutar, una skill bien escrita fuerza al agente a reunir:

## Inputs checklist
- [ ] `package.json` expo/react/react-native versions
- [ ] `app.config.ts` - scheme, bundleId, runtimeVersion policy
- [ ] `eas.json` profiles in scope
- [ ] Target platform(s): ios | android | all
- [ ] CNG mode: generated native dirs vs checked-in ios/android
- [ ] Incident context (if triage): buildNumber, channel, crash-free delta

Falta bundle ID / applicationId rompe skills de Maestro y submit
Falta runtimeVersion rompe skills de OTA - ver Runtime Version Policy
Los agentes deben pegar valores recolectados de vuelta al humano para confirmación antes de comandos destructivos

5. Outputs que Debes Esperar

Una ejecución de skill debe terminar con entregables concretos:

Tipo de output	Ejemplo
Secuencia de comandos	`eas build --profile production --platform all`
Config diff	snippet de perfil submit de `eas.json`
Plan de prueba	casos Jest - outline de `.maestro/checkout.yml`
Checklist de revisión	idempotencia de config plugin - gate de `expo-doctor`
Árbol de decisión	rollback de OTA vs store hotfix con timestamps

Sin output - skill fallida - rechaza respuestas de agente que solo resumen documentación
Los outputs deben referenciar verificación - npx tsc --noEmit, npm test, eas channel:view
Para SDK 57, siempre incluye npx expo-doctor cuando dependencias o plugins cambian

6. Guardrails que Cada Mobile Skill Necesita

Copia estos defaults en cada SKILL.md:

## Guardrails (SDK 57)
1. Use `npx expo install` - never hand-pin Expo module versions.
2. OTA (`eas update`) only when `runtimeVersion` matches live store binaries.
3. Native module or permission changes require `eas build`, not OTA alone.
4. Never commit secrets - EAS environments and CI secrets only.
5. Run `npx expo-doctor` before merging skill-generated dependency changes.
6. Do not edit generated `ios/` / `android/` under CNG - use config plugins.
7. Pause phased/staged store rollout before hotfix binary when crash storm is live.

Los guardrails convierten entusiasmo de agente en disciplina de release-engineering
Empareja con Agent Skills Best Practices para reglas de equipo

7. Pinning SDK 57 en Skills

Los agentes por defecto a versiones de training data. Fija explícitamente:

## Stack pin (required)
| Package | Version |
| --- | --- |
| react | 19.2.3 |
| react-native | 0.86.0 |
| expo | ~57.0.4 |
 
## SDK 57 specifics
- New Architecture defaults on RN 0.86 - verify TurboModule skills against NA-enabled builds.
- `experiments.typedRoutes` generates `.expo/types/router.d.ts` - regen after `app/` changes.
- EAS Workflows support `type: maestro` jobs - prefer over ad-hoc shell scripts.

Re-fija skills en cada SDK bump - skills obsoletas son peor que sin skills
Verifica output de agente cruzado con npx expo-doctor y npx expo install --check

8. Composición de Skill (No Dupliques Documentación)

Las skills delegan a documentación humana; no la reemplazan:

## References (read, don't rewrite)
- Build: ../eas-build/eas-build-basics/eas-build-basics.md
- Submit: ../eas-build/eas-submit/eas-submit.md
- OTA: ../ota-updates/ota-updates-basics/ota-updates-basics.md
- Router: ../expo-router/typed-routes/typed-routes.md
- Testing: ../testing/jest-setup-for-expo/jest-setup-for-expo.md

Output de skill = plan - comandos - gates
Output de doc = conceptos - edge cases - FAQs
Enlaza ambas direcciones: skills apuntan a docs; docs pueden decir "invoca X skill para setup asistido"

9. Verificando Output de Skill

Después de cualquier cambio asistido por skill:

# Dependency / native alignment
npx expo-doctor
 
# Type safety (router, TS strict)
npx tsc --noEmit
 
# Unit/component gate
npm run test:ci
 
# Optional E2E smoke (Maestro)
maestro test .maestro/smoke.yml

Verificación	Detecta
`expo-doctor`	SDK skew, misconfigured plugins, invalid app config
`tsc`	Broken typed routes, invalid `Href`
Jest	Regressions en business logic que el agente refactorizó
Maestro	Navigation y native chrome que el agente no mockeó

Trata output de skill como un PR de ingeniero junior - revisa antes de merge
CI debe ejecutar los mismos gates - ver CI Quality Gates

10. Ejemplo de Prompts de Invocación

EAS release:

Use the EAS Release skill. Stack: Expo SDK 57, RN 0.86.
Inputs: eas.json attached, production channel, last good updateId abc123.
Goal: JS hotfix for checkout copy - confirm OTA is safe, then give commands.
Guardrails: no store submit unless doctor fails on native change.

Expo Router:

Use the Expo Router skill. Add /settings/notifications with typed params.
Enable experiments.typedRoutes. Provide href builder + deep link scheme myapp://.
Run tsc verification steps.

Mobile testing:

Use the Mobile Testing skill.
Acceptance criteria:
- Guest can add item to cart
- Cart badge shows count
Deliver: 3 Jest tests + 1 Maestro flow. SDK 57, appId com.example.shop.

SDK upgrade:

Use the SDK Upgrade skill. Upgrade expo 56 - 57.
Produce ordered checklist with expo-doctor gates and breaking-change scan.
Do not skip lockfile regen or prebuild --clean recommendation.

Incident triage:

Use the Incident Triage skill.
Crash-free dropped 99.2% - 94% after production OTA 30 min ago.
buildNumber 240012, iOS phased at 50%. Decision tree: OTA rollback vs pause vs hotfix binary.

FAQs

¿Las Agent Skills son lo mismo que Expo config plugins?

¿Las skills deben vivir en el app repo o un registro central?

App repo para convenciones de eas.json y routing específicas del proyecto. Registro central para playbooks de release e incident de toda la organización. Siempre fija la versión SDK en ambos.

¿Puede una SKILL.md cubrir el stack móvil completo?

Evítalo. Divide por dominio de decisión para que guardrails se mantengan afilados. Una skill monolítica diluye límites OTA vs native y produce automatización insegura.

¿Las skills reemplazan runbooks on-call?

No. Las skills aceleran redacción de checklists y comandos. El Incident Triage Skill complementa - no reemplaza - Store Incident Response.

¿Qué tan a menudo deberíamos refrescar skills?

EAS Release Skill - build, submit, OTA cookbook
Expo Router Skill - routes, typed params, deep links
Mobile Testing Skill - Jest + Maestro from AC
SDK Upgrade Skill - Expo 57 upgrade checklist
Incident Triage Skill - crash clusters and rollback tree
Agent Skills Best Practices - 25-item team summary
EAS Build Basics - human reference for builds
Mobile Testing Basics - testing pyramid

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).

Conceptos Básicos de Agent Skills

Buscar en la documentación

Conceptos Básicos de Agent Skills