hig-patterns

Resumen de la skill hig-patterns

hig-patterns es una skill de patrones de Apple Human Interface Guidelines para decidir cómo deben comportarse las interacciones comunes de una app en iOS, iPadOS y otras experiencias de Apple. Resulta especialmente útil cuando necesitas una respuesta sólida a preguntas como si conviene usar una modal, cómo debe fluir el onboarding, cómo mostrar una carga o cuándo ofrecer deshacer en lugar de una confirmación.

Para qué sirve hig-patterns

La hig-patterns skill ayuda a traducir un objetivo de producto al patrón de interacción correcto, no solo a generar texto de interfaz. Está pensada para diseñadores de producto, ingenieros y agentes de IA que necesitan tomar decisiones de UX alineadas con Apple bajo presión de tiempo.

Tareas en las que mejor encaja

Usa hig-patterns cuando estés diseñando o revisando onboarding, búsqueda, ajustes, permisos, notificaciones, multitarea, arrastrar y soltar, compartir, gestión de archivos o estados de feedback. Es especialmente relevante para hig-patterns for UI Design cuando ya conoces el área funcional, pero necesitas definir el modelo de interacción.

Qué la hace distinta

Esta skill tiene una postura clara sobre la selección de patrones según Apple HIG: minimizar la modalidad, dar feedback inmediato, preferir undo y elegir el control menos invasivo que siga encajando con la tarea. Su foco está menos en el estilo visual y más en la elección de interacción, que suele ser lo que bloquea las buenas decisiones de UX en Apple.

Cómo usar la skill hig-patterns

Instálala y actívala

Usa el flujo hig-patterns install desde tu gestor de skills, o instálala desde raintree-technology/apple-hig-skills con el comando estándar de skills del repositorio si tu entorno lo admite. Una vez instalada, indica al modelo la tarea y el contexto de plataforma Apple, y pide la recomendación de patrón en lugar de una crítica genérica de UI.

Da la entrada correcta

Un buen prompt de hig-patterns usage incluye: plataforma, objetivo del usuario, flujo actual, qué está fallando y cualquier restricción como no añadir pantallas, tener que funcionar sin conexión o el riesgo de una acción destructiva. Por ejemplo: “Diseña el mejor patrón de Apple HIG para borrar una nota sincronizada en iPhone cuando los usuarios suelen equivocarse y necesitan una forma rápida de recuperación”.

Lee primero estos archivos

Empieza por skills/hig-patterns/SKILL.md y después revisa .claude/apple-design-context.md si existe en tu espacio de trabajo. El contenido de la skill es breve y autocontenido, así que no hay carpetas auxiliares que explorar; el valor principal está en las reglas de patrones y en las referencias cruzadas a skills HIG relacionadas.

Flujo de trabajo que da mejores resultados

Sigue este flujo de trabajo de hig-patterns guide: describe la tarea, pide el patrón recomendado, valídalo contra las restricciones de Apple y luego solicita casos límite y comportamiento de reserva. Si ya tienes una UI propuesta, pide a la skill que evalúe si tiene demasiada modalidad, si informa demasiado poco o si le falta feedback.

Preguntas frecuentes sobre la skill hig-patterns

¿hig-patterns es solo para trabajo de diseño en Apple?

Sí. hig-patterns está creada para decisiones de interacción en plataformas Apple, así que rinde mejor cuando el resultado debe alinearse con Apple HIG y no con patrones genéricos de web o Android.

¿En qué se diferencia de un prompt normal?

Un prompt normal puede generar una buena idea, pero hig-patterns ofrece un marco de decisión más preciso: cuándo usar una sheet frente a una alert, cómo gestionar el progreso, cuándo undo es mejor que confirmar y qué nivel de interrupción está justificado. Eso suele reducir el ida y vuelta y los consejos vagos.

¿Es apta para principiantes?

Sí, si puedes describir la tarea del usuario con claridad. No hace falta dominar HIG en profundidad para usarla, pero la calidad depende de lo bien que especifiques la plataforma, la acción y el nivel de riesgo.

¿Cuándo no debería usarla?

No uses hig-patterns si necesitas branding visual, código de una librería de componentes o consejo de UX agnóstico de plataforma. Es una skill de selección de patrones, así que resulta menos útil cuando la verdadera pregunta es cómo implementar el layout o qué tokens del sistema de diseño usar.

Cómo mejorar la skill hig-patterns

Aporta la decisión, no solo la funcionalidad

Las mejores entradas le dicen a la skill qué decisión te está frenando: “modal o inline”, “confirmar borrado o deshacer”, “spinner o barra de progreso” o “pedir permisos ahora o después”. Eso genera un mejor hig-patterns usage que pedir una revisión general de diseño.

Incluye el modo de fallo

Menciona qué puede salir mal en el flujo: toques accidentales, esperas largas, errores repetidos, datos sensibles o incertidumbre del usuario. hig-patterns funciona mejor cuando puede ponderar entre interrupción, recuperabilidad y feedback.

Pide restricciones y trade-offs

Si necesitas que la recomendación encaje en una pantalla existente, en un flujo corto o en un requisito de accesibilidad, dilo desde el principio. La skill resulta más útil cuando puede explicar por qué un patrón de Apple es preferible bajo esas restricciones en lugar de enumerar varias opciones.

Itera con un seguimiento más concreto

Después de la primera respuesta, afina con un caso límite específico: “¿Y si la acción es destructiva pero reversible?” o “¿Cómo debería funcionar esto en iPad con multitarea?”. Esa es la forma más rápida de convertir una respuesta buena de hig-patterns guide en un patrón listo para implementar.