ios-design-guidelines

Resumen de la skill ios-design-guidelines

La skill ios-design-guidelines te ayuda a revisar, ajustar y reescribir trabajos de UI para iPhone según las Apple Human Interface Guidelines sin tener que leer antes toda la fuente. Resulta especialmente útil para tareas en SwiftUI y UIKit donde el layout, la navegación, la accesibilidad, Dynamic Type, Dark Mode o la elección de componentes del sistema pueden definir el éxito o el fracaso del resultado.

Usa esta skill de ios-design-guidelines cuando necesites orientación práctica para una decisión real de interfaz, no teoría de diseño abstracta. Encaja muy bien para diseñadores, ingenieros de iOS y agentes de revisión que necesitan detectar rápido errores evitables de HIG: áreas táctiles demasiado pequeñas, layouts inseguros, navegación no estándar, tamaños de texto fijados en código o falta de soporte de accesibilidad.

Para qué sirve mejor esta skill de ios-design-guidelines

La tarea principal es convertir una idea de UI imprecisa en una implementación o lista de revisión adecuada para iPhone. La skill funciona mejor cuando quieres valores predeterminados alineados con Apple, ejemplos en SwiftUI/UIKit y comprobaciones concretas de reglas, en lugar de consejos genéricos tipo “hazlo más intuitivo”.

Dónde aporta valor real

Es especialmente útil cuando estás decidiendo entre patrones habituales de iOS: tab bar frente a navegación personalizada, comportamiento de safe area, acciones ancladas abajo, escalado de texto, colores semánticos y gestos del sistema. Eso hace que la guía ios-design-guidelines sea más orientada a decisiones que una lectura rápida del repositorio.

Cuándo no encaja

Si necesitas estrategia de producto amplia, consejo de diseño multiplataforma o patrones para Android/web, esta skill no es la fuente adecuada. También es menos útil para trabajo puramente visual de branding que no dependa de convenciones de iOS.

Cómo usar la skill ios-design-guidelines

Instala e inspecciona los archivos correctos

Instálala con npx skills add ehmo/platform-design-skills --skill ios-design-guidelines. Para que la instalación de ios-design-guidelines realmente compense, empieza leyendo SKILL.md y luego AGENTS.md, metadata.json y rules/_sections.md. Esos archivos muestran el alcance de la skill, las prioridades de las reglas y los pocos grupos de reglas que con más probabilidad terminarás aplicando.

Convierte un objetivo vago en un prompt útil

El mejor uso de ios-design-guidelines parte de un contexto de interfaz concreto. Incluye plataforma, tipo de pantalla, tarea del usuario y riesgo actual. Por ejemplo: “Revisa esta pantalla de checkout en SwiftUI para iPhone, centrándote en la zona del pulgar, los safe areas, las áreas táctiles y Dynamic Type. Sugiere solo cambios que mantengan el flujo actual.” Eso le da a la skill algo accionable en lugar de un “mejora mi app” genérico.

Qué información mejora la calidad de salida

Aporta el fragmento de UI relevante, la lista de componentes y las restricciones: solo iPhone o universal, SwiftUI o UIKit, versión de iOS compatible y cualquier comportamiento que deba mantenerse sí o sí. Si pides una reescritura, incluye el código actual o la estructura de la pantalla para que la skill pueda mapear las reglas a controles reales en vez de adivinar.

Flujo de trabajo práctico que conviene seguir

Empieza con una revisión enfocada y luego pide una segunda pasada más estrecha sobre cualquier área de riesgo: navegación, accesibilidad o layout. Por ejemplo, primero pide las infracciones HIG de mayor prioridad y después solicita una implementación corregida solo de los tres problemas principales. Así el uso de ios-design-guidelines se mantiene eficiente y los cambios son más fáciles de aplicar.

Preguntas frecuentes sobre la skill ios-design-guidelines

¿Es solo para SwiftUI?

No. La skill ios-design-guidelines cubre tanto SwiftUI como UIKit, así que funciona para desarrollos nuevos y refactors de legado. Úsala para comparar decisiones de implementación con las convenciones de iPhone, no solo para generar código.

¿En qué se diferencia de un prompt normal?

Un prompt normal suele dar consejos de UI bastante superficiales. Esta skill está construida alrededor de reglas específicas de Apple y modos de fallo frecuentes, así que la guía ios-design-guidelines es mejor cuando necesitas recomendaciones revisables, nativas de iPhone y con menos margen de improvisación.

¿Necesito ser experto en iOS para usarla?

No. Los principiantes pueden usarla bien si describen claramente la pantalla y aportan el código o layout que ya tienen. La principal limitación es la calidad de la entrada: si el prompt es vago, la salida también lo será.

¿Cuándo debería evitar usarla?

Sáltatela para interfaces que no sean de iPhone, maquetas solo de branding o casos en los que quieras romper explícitamente el comportamiento estándar de iOS. Si tu objetivo es un patrón de interacción novedoso, la skill ios-design-guidelines probablemente te empuje, con razón, de vuelta a las convenciones del sistema.

Cómo mejorar la skill ios-design-guidelines

Dale el contexto de reglas que necesita

Los mejores resultados llegan cuando indicas qué partes de la interfaz tienen más probabilidades de fallar una revisión HIG. Menciona si te importa más el layout, la navegación, la tipografía, el color o la accesibilidad para que la skill ios-design-guidelines pueda ponderar su feedback en lugar de repartir demasiado la atención.

Pide cambios, no solo comentarios

Si quieres ayuda de implementación, pide una estructura de pantalla revisada, código SwiftUI/UIKit corregido o una lista priorizada de arreglos. La skill es más útil cuando puede convertir un problema en una acción explícita, como aumentar las áreas táctiles, mover las acciones principales a la zona del pulgar o restablecer el cumplimiento de safe area.

Vigila los fallos más comunes

Los errores más graves suelen ser la navegación personalizada que choca con iOS, el texto que no escala y las señales de estado solo visuales que no funcionan para accesibilidad. Si la primera pasada te resulta demasiado genérica, añade restricciones concretas como “debe preservar la navegación actual” o “debe soportar Dynamic Type extra grande” para forzar un mejor uso de ios-design-guidelines.

Itera con un segundo prompt más acotado

Después de la primera respuesta, vuelve a ejecutar la skill sobre el área de riesgo más importante en lugar de pedir otra revisión completa. Por ejemplo: “Ahora revisa solo accesibilidad para VoiceOver, Reduce Motion y contraste.” Eso produce feedback más preciso y hace que la instalación de ios-design-guidelines aporte más valor en proyectos reales.