Guía de Agent Skills para SwiftUI

Si solo eliges una: elige ameyalambat128/swiftui-skills si buscas orientación escrita por Apple y menos alucinaciones sobre API; elige dpearson2699/swift-ios-skills si buscas una cobertura amplia de ingeniería para iOS y un enrutamiento preciso por framework. La combinación más sólida: usa la primera como capa de referencia e instala de la segunda solo las 5–10 skills especializadas que necesita tu proyecto.

El problema más común del código SwiftUI generado por IA no es una sintaxis inválida, sino código que solo parece correcto: propiedad del estado poco clara, patrones de navegación obsoletos, límites de concurrencia imprecisos o una API que no existe. Las Agent Skills convierten un modelo general en un colaborador con restricciones explícitas de ingeniería para plataformas Apple.

¿Qué es exactamente una Agent Skill?

Una Skill suele ser un directorio que contiene un archivo SKILL.md. Indica a agentes de programación como Codex, Claude Code y Cursor cuándo activar una capacidad, qué referencias leer primero, qué reglas seguir y cómo dar formato al resultado. No es una extensión de Xcode ni un paquete de Swift; considérala un manual de ingeniería del equipo acompañado de un paquete de conocimientos específico para IA.

A diferencia de un único prompt enorme que contiene todas las reglas, las Skills pueden cargarse solo cuando son pertinentes. La orientación sobre animación aparece al trabajar con animaciones de SwiftUI, las reglas de compra y verificación de StoreKit aparecen en tareas comerciales y la orientación sobre rendimiento se carga al depurar el desplazamiento. Este contexto específico para cada tarea suele ser más preciso y eficiente en el uso de tokens.

Los dos enfoques de un vistazo

Enfoque uno: convertir la documentación de Xcode en una fuente de referencia para la IA

Su decisión de diseño más valiosa es la regla explícita de que toda afirmación factual y toda API deben basarse en el directorio local /docs. El agente selecciona la documentación antes de programar y cita los archivos utilizados durante la revisión. Si un tipo o una API no están presentes, debe reconocer la incertidumbre en lugar de inventar un nombre verosímil.

El material extraído va más allá del layout de SwiftUI. Incluye App Intents, AlarmKit, StoreKit, WebKit, herencia de SwiftData, Swift Concurrency, Liquid Glass, widgets de visionOS y primitivas de rendimiento de bajo nivel como InlineArray y Span.

Limitaciones que debes tener en cuenta

• Requiere macOS y Xcode 26 o posterior. La Skill no debe ofrecer orientación sobre SwiftUI hasta que se haya llenado el directorio de documentación.
• Es un punto de entrada amplio. Los proyectos complejos todavía necesitan una solicitud específica, como «revisa la propiedad del estado y la navegación según la documentación de Apple».
• La versión local de Xcode determina la versión de las referencias, por lo que los equipos deben alinear sus cadenas de herramientas para evitar conclusiones contradictorias sobre disponibilidad.

Enfoque dos: 84 Skills componibles para iOS

Este repositorio destaca por su enrutamiento preciso. No necesitas todo el corpus de desarrollo para plataformas Apple en cada contexto: una app de suscripción que usa SwiftData, StoreKit 2, App Intents y WidgetKit puede instalar esas Skills junto con patrones de SwiftUI, Swift Concurrency, pruebas y accesibilidad.

A continuación se muestra el catálogo completo de 84 Skills a la fecha de actualización de este artículo. Despliega cada grupo para comprobar la cobertura frente a la pila tecnológica de tu proyecto.

Cómo elegir: empieza por la tarea, no por la cantidad

Situación A: empezar a usar IA para SwiftUI

Instala primero swiftui-skills para aplicar las restricciones de la documentación de Apple y después agrega swiftui-patterns, swiftui-navigation, swift-concurrency, swift-testing e ios-accessibility de la colección de 84 Skills. Estas cinco cubren los puntos de falla más comunes en proyectos nuevos.

Situación B: desarrollar una función en un producto existente

Elige según la tecnología actual y no por lo que podría ser útil algún día. Agrega storekit para suscripciones; app-intents y widgetkit para superficies del sistema; swiftdata o core-data para apps que manejan muchos datos; y apple-on-device-ai para productos de IA que se ejecutan en el dispositivo.

Situación C: revisión de código y trabajo de fiabilidad

Prioriza swiftui-performance, debugging-instruments, metrickit, swift-security, ios-accessibility y app-store-review. Este conjunto funciona más como un control de lanzamiento que como un generador de código.

Instalación: agentes generales y Codex

Instalar la Skill con la documentación local de Apple

# Instalar directamente y extraer la documentación de Xcode
curl -fsSL https://swiftui-skills.ameyalambat.com/install | bash

# O usar la CLI de skills
npx skills add ameyalambat128/swiftui-skills

Antes de enviar un script remoto a tu shell mediante una canalización, revisa el instalador en el repositorio. Después de la instalación, ejecuta setup.sh desde el directorio de la Skill instalada y reinicia la sesión del agente para que pueda descubrir la nueva Skill.

Seleccionar de forma interactiva en la colección de 84 Skills

# Abrir el selector interactivo y elegir Skills y agentes de destino
npx skills add dpearson2699/swift-ios-skills

# Instalar solo las capacidades seleccionadas
npx skills add dpearson2699/swift-ios-skills \
  --skill swiftui-patterns \
  --skill swift-concurrency \
  --skill swift-testing

# Comprobar y actualizar
npx skills check
npx skills update

Instalar una sola Skill en Codex

$skill-installer install \
  https://github.com/dpearson2699/swift-ios-skills/tree/main/skills/swiftui-patterns

Sustituye el directorio final por el nombre de cualquier Skill del catálogo. Las reglas específicas de un proyecto deben estar en el ámbito del proyecto; la orientación reutilizable de SwiftUI e ingeniería debe estar en el ámbito personal compartido.

Un flujo de trabajo combinado más fiable

1. Declara el objetivo y la versión mínima de despliegue. Indica al agente si la tarea es una función, una refactorización o una revisión, y especifica la versión mínima de iOS para que las API nuevas no se utilicen sin condiciones.
2. Deja que la capa de referencia seleccione primero la documentación. Pide a swiftui-skills que enumere los documentos de Apple y las restricciones de disponibilidad utilizados para la tarea.
3. Carga solo las Skills específicas de la tarea. Usa swiftui-navigation para la navegación y storekit para las compras, en lugar de añadir todo el catálogo a una sola tarea.
4. Exige una validación completa. Pide al agente que compile el target, ejecute las pruebas y compruebe Dynamic Type, VoiceOver y el modo oscuro cuando haya cambios en la interfaz.
5. Registra las decisiones en las reglas del proyecto. Las decisiones de arquitectura recurrentes deben incluirse en una Skill del proyecto o en AGENTS.md en lugar de volver a negociarse para cada tarea.

Un prompt reutilizable para una tarea puede empezar así:

Use local Apple documentation as the API source of truth,
and use swiftui-patterns, swift-concurrency, and swift-testing.
Goal: implement a testable asynchronous loading screen for an iOS 26 app.
List the selected documentation and state ownership first, then modify the code, build, and run tests.
Do not introduce an architecture that the project does not already use.

Versiones y licencias: dos comprobaciones finales

Las API de las plataformas Apple avanzan con rapidez. Este artículo se verificó con un commit de swiftui-skills del 6 de julio de 2026 y un commit de swift-ios-skills del 4 de julio de 2026. El contenido de los repositorios, las versiones compatibles y la cantidad de Skills pueden cambiar. Verifica siempre los frameworks en beta con el SDK actual de Xcode.

Las licencias también son distintas: swiftui-skills usa MIT, mientras que swift-ios-skills usa PolyForm Perimeter 1.0.0. Permite el desarrollo de apps y los flujos de trabajo comerciales de código cerrado, pero restringe volver a empaquetar el contenido como un producto competidor. Lee la LICENSE del repositorio original antes de distribuirlo en un equipo, modificarlo o integrarlo con fines comerciales.

Preguntas frecuentes

¿Las Agent Skills para SwiftUI sustituyen la documentación oficial de Apple?

No. Una Skill ayuda a un agente a cargar y aplicar reglas en el momento adecuado. La disponibilidad final de las API, el comportamiento de la plataforma y los requisitos de revisión deben verificarse con el SDK actual de Xcode y el material oficial de Apple.

¿Puedo instalar las dos bibliotecas de Skills?

Sí. Se complementan: una ofrece una fuente de referencia local basada en la documentación de Apple, mientras que la otra proporciona flujos de trabajo específicos para frameworks e ingeniería. Selecciona las Skills según el proyecto en lugar de instalar todo de forma predeterminada.

¿Es mejor instalar las 84 Skills?

No necesariamente. Los equipos que mantienen muchos proyectos para plataformas Apple pueden beneficiarse, pero un único producto suele ser más claro con entre cinco y diez Skills de uso frecuente y permite rastrear con mayor facilidad el origen de cada recomendación.

¿Estas Skills son solo para Codex?

No. Ambos repositorios son compatibles con varios agentes, incluidos Codex, Claude Code y Cursor. Las rutas de instalación y los mecanismos de detección dependen de la versión actual de cada agente.