Agent skills de Xcode: cómo exportarlas y usarlas en Xcode 27

Los agentes de programación escriben bien Swift, pero aprenden las API a partir de los datos con los que se entrenaron, que suelen ir una o dos versiones por detrás. Las agent skills de Xcode cierran esa brecha. Xcode 27 incluye skills escritas por Apple que indican a un agente cómo aplicar las buenas prácticas actuales y las API más recientes, y un solo comando las exporta para agentes que se ejecutan fuera de Xcode. Esta guía explica qué son las skills, cómo exportarlas, por qué una copia anterior a Xcode 27.1 está desactualizada y cómo la skill App Resizability te ayuda a preparar una app para iPhone Duo.

Todo lo que se cuenta aquí procede de las sesiones de Apple de la WWDC26, de los Tech Talks sobre iPhone Duo, de la documentación y las notas de la versión de Apple, y de informes de desarrolladores, a los que citamos cuando son la única fuente. El equipo de AppleDuo no ha ejecutado estas skills en una app publicada. Xcode 27.x es nuevo, así que los nombres y el comportamiento pueden cambiar entre versiones.

¿Qué son las agent skills de Xcode 27?

Una skill es un paquete de conocimientos que un agente puede cargar cuando una tarea lo requiere. La documentación de Apple sobre cómo ampliar y personalizar agentes la describe como experiencia integrada «que puede guiar a los agentes para usar las mejores API y flujos de trabajo en tareas de alto nivel». Dentro de Xcode rara vez tienes que pedir una: Xcode usa la skill adecuada según la petición que escribes.

También puedes llamar a una skill directamente. Las notas de la versión de Xcode 27 dicen que las skills «se pueden invocar como comandos de barra con autocompletado». Escribe / en el campo de mensaje del asistente de programación para ver todas las skills que tiene tu copia de Xcode. La misma versión añadió plug-ins que agrupan skills, servidores MCP y configuraciones de agentes, así que la lista puede ir más allá de las de Apple.

En la sesión de la WWDC26 What's new in SwiftUI, Apple dice que las nuevas skills están ahí para ayudarte a adoptar funciones de las versiones de 2027 «y mejorar el rendimiento y la corrección del código de tu app». Esa es la idea central: el agente recibe las indicaciones actuales de Apple en lugar de depender de datos de entrenamiento antiguos.

¿Qué agent skills incluye Xcode 27?

Apple no ha publicado una lista única. Estas son las skills que se mencionan en las propias sesiones y notas de la versión de Apple, con la versión que introdujo cada una.

Xcode también incluye skills de flujo de trabajo, como /plan para el modo de planificación, y las notas de la versión mencionan especialistas creados por Apple para localización, redimensionamiento en UIKit y accesibilidad. Tu carpeta exportada es la lista más fiable para la versión de Xcode que tienes instalada.

¿Cómo exporto las agent skills de Xcode con xcrun?

Apple da el comando en dos sesiones de la WWDC26. En Modernize your UIKit app, el presentador dice que, para usar las skills en otras herramientas, «puedes exportar las que usa Xcode» con xcrun agent skills export, que crea archivos Markdown que puedes importar en tus flujos de trabajo.

@sarunw compartió la versión con una carpeta de salida:

xcrun agent skills export --output-dir ~/Downloads/xcode-skills

xcrun ejecuta la herramienta desde tu directorio de desarrollador activo, así que asegúrate primero de que apunta a Xcode 27 o posterior. El artículo de Reda Lemeden señala que después puedes volver a cambiarlo, porque los archivos exportados se quedan donde los pusiste. Los comandos xcode-select de abajo son herramientas estándar de macOS; ajusta la ruta a donde tengas Xcode.

# Comprueba qué Xcode usará xcrun
xcode-select -p

# Apúntalo a Xcode 27.1 o posterior y después exporta
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
xcrun agent skills export --output-dir ~/Downloads/xcode-skills
ls ~/Downloads/xcode-skills

Según Lemeden, ejecutar el comando sin --output-dir exporta al directorio actual, con una carpeta por skill. Apple no ha documentado otras opciones, así que no enumeramos ninguna.

¿Puedo usar las agent skills de Xcode con Claude Code u otros agentes?

Sí, para eso sirve la exportación. La página de Apple para preparar apps para iPhone Duo lo dice claramente: «Si usas otro agente de programación, exporta la skill». Lo que Apple no documenta es cómo debe cargar los archivos cada agente. Eso depende del agente.

Lemeden cuenta que las exporta directamente a una carpeta de skills de Claude Code, y dice que los archivos funcionan con cualquier entorno que admita el formato de skills, y menciona Claude Code y OpenCode:

xcrun agent skills export --output-dir ~/.claude/skills

También sirve una carpeta por proyecto si prefieres mantener las skills con un solo repositorio. Uses el agente que uses, consulta su documentación para saber dónde se guardan las skills y cómo se activan.

Dos notas prácticas. Primero, las skills son contenido de Apple. Expórtalas desde tu propia copia de Xcode en lugar de descargar una copia que haya publicado otra persona, para obtener la versión que corresponde a tu SDK. Segundo, un agente fuera de Xcode solo puede comprobar su trabajo si puede compilar y ejecutar tu app. Las notas de la versión de Xcode 27 describen una vista previa de un servidor MCP de Xcode que funciona sin un espacio de trabajo abierto y se activa con sudo xcrun mcp-server enable. Es una vista previa temprana, así que cuenta con algunas asperezas.

Si los agentes van a editar tu archivo de proyecto además de tu código, el nuevo formato de proyecto JSON de Xcode 27.2 les resulta más fácil de leer y fusionar. Lo explicamos en el formato .xcproj de Xcode 27.

¿Por qué debo volver a exportar las skills tras Xcode 27.1?

Las skills se versionan con Xcode, y Xcode 27.1 cambió una que importa para iPhone Duo. En el Tech Talk Prepare your app for iPhone Duo, Apple dice que la skill de modernización de apps de «Modernize your UIKit app» tiene un nombre nuevo en Xcode 27.1: «App Resizability. Ahora es compatible con SwiftUI e iPhone Duo».

@sarunw explicó qué significa eso para las copias exportadas: si exportaste antes de Xcode 27.1, vuelve a exportar, porque uikit-app-modernization ahora es app-resizability. Una carpeta exportada desde Xcode 27.0 conserva la skill antigua, que no sabe nada de iPhone Duo ni de SwiftUI.

Cuando vuelvas a exportar, borra antes la carpeta antigua o exporta a una ruta nueva, para que tu agente no cargue las dos versiones. Haz lo mismo después de cada actualización de Xcode, ya que Apple puede revisar cualquier skill entre versiones.

¿Cómo uso la skill App Resizability para iPhone Duo?

Dentro de Xcode, la página de Apple para preparar apps para iPhone Duo indica que pidas al asistente de programación «get my app ready for iPhone Duo» (prepara mi app para iPhone Duo). La skill analiza tu proyecto y, para cada problema que encuentra, explica de qué se trata y sugiere una solución. Con una copia exportada, haz la misma petición a tu agente e indícale la skill.

La sesión de UIKit de la WWDC26 enumera lo que hace la skill por sí sola: convierte las llamadas a la pantalla principal en comprobaciones de trait collection o de los límites de la escena, sustituye las comprobaciones de orientación de la interfaz por comprobaciones de size class y puede pasar una app al ciclo de vida de escenas. En los trabajos más grandes hace preguntas para aclarar dudas, y cuando el trabajo es demasiado grande para una sola sesión, deja comentarios para que puedas seguir lo que falta.

Un cambio típico tiene este aspecto. Ambas líneas usan API estándar de UIKit, y la página de preparación de Apple menciona exactamente esta sustitución:

// Antes: dimensionada a partir de la pantalla principal
let window = UIWindow(frame: UIScreen.main.bounds)

// Después: creada a partir de la escena, así que sigue su tamaño
let window = UIWindow(windowScene: windowScene)

Apple deja claro que la skill «encuentra la mayoría de los problemas, pero no todos». Usa su pasada como un primer barrido y después revisa los patrones que Apple pide corregir a mano:

• Deja de dimensionar a partir de la pantalla principal. Sustituye UIScreen.main.bounds por view.bounds o window.bounds, y usa GeometryReader u onGeometryChange en SwiftUI.
• No uses la orientación para el diseño. Elimina la lógica de diseño que lee UIDevice.current.orientation, statusBarOrientation o interfaceOrientation.
• No trates el idiom o la size class como un dispositivo. En iPhone Duo, una app de iPhone puede recibir cualquier combinación de size classes, así que un ancho regular ya no significa iPad. Nuestra guía sobre las size classes de iPhone Duo entra en detalle.
• Revisa los contenidos multimedia a sangre. Las imágenes de cabecera en modo de relleno pueden perder contenido en la pantalla interior, más ancha.

Después, compila con el SDK de iOS 27.1, que extiende las apps a toda la pantalla con barras verticales, y prueba. Nuestra checklist para preparar tu app para iPhone Duo ordena estos pasos.

¿Qué cambió en Device Hub en Xcode 27.2?

Los cambios de un agente siguen necesitando pruebas, y Device Hub es donde se hacen. Con Xcode 27.1 eliges el simulador de iPhone Duo y usas los controles de la parte inferior de la pantalla para abrir, cerrar, girar o plegar el dispositivo. Las notas de la versión de Xcode 27.2 añaden una lista de mejoras, entre ellas varias que destacó @sarunw:

• Compatibilidad con StandBy en iPhone Duo
• Slow Motion Animation, Simulate Shake, Simulate Fall y Simulate Memory Pressure (solo en simuladores)
• Eventos táctiles a través de Sidecar, para que pellizcar y girar funcionen desde la pantalla de un iPad
• Una opción para ocultar los biseles del dispositivo, además de mejoras en las capturas de pantalla y el teclado

La cámara lenta te ayuda a observar un cambio de diseño mientras el dispositivo se pliega, y la presión de memoria muestra si tu estado sobrevive a un cambio de tamaño bajo carga. Las notas de la 27.2 de Apple también enumeran problemas conocidos: VoiceOver y el Inspector de accesibilidad no pueden transmitir el contenido de la pantalla de iPhone Duo dentro de Device Hub, y las capturas de pantalla pueden salir negras durante unos minutos después de arrancar el dispositivo.

Puntos clave

• Las agent skills de Xcode 27 son indicaciones escritas por Apple para agentes de programación, que se aplican automáticamente o mediante comandos de barra.
• Expórtalas con xcrun agent skills export más --output-dir y una carpeta para usarlas con otro agente; Apple dice que la exportación genera archivos Markdown.
• Vuelve a exportarlas tras Xcode 27.1: uikit-app-modernization pasó a ser app-resizability, con compatibilidad con SwiftUI e iPhone Duo.
• Pide «get my app ready for iPhone Duo» y después revisa lo que se le escapa a la skill, ya que Apple dice que no lo detecta todo.
• Prueba el resultado en Device Hub, que en Xcode 27.2 añade simulaciones de cámara lenta, presión de memoria, agitación y caída.

A continuación, recorre la checklist para preparar tu app para iPhone Duo y descubre apps que ya sacan el máximo partido a la bisagra en Built for the fold.