hig-foundations

Panorama general de la skill hig-foundations

hig-foundations es la skill de fundamentos de Apple Human Interface Guidelines para decisiones de diseño tempranas que afectan la claridad, la accesibilidad y la coherencia con el sistema. Usa la skill hig-foundations cuando necesites orientación práctica sobre color, tipografía, símbolos, materiales, motion, privacidad, layout, RTL o diseño inclusivo para plataformas de Apple. Es especialmente útil para diseñadores de UI, equipos de producto y agentes que necesitan convertir una idea de interfaz aproximada en decisiones de diseño alineadas con Apple sin tener que adivinar.

Para qué sirve hig-foundations

Esta skill ayuda a responder “¿cómo debería verse y sentirse esto?” antes de pasar a pantallas, componentes o patrones de plataforma. Es especialmente útil cuando el problema es de base: contraste en modo oscuro, compatibilidad con Dynamic Type, uso de colores del sistema, elección de tipografía o hacer que los iconos se sientan nativos. Si el objetivo es alinear una funcionalidad con Apple HIG en lugar de inventar un lenguaje visual propio, hig-foundations es el punto de partida adecuado.

Cuándo es la opción correcta

Usa hig-foundations para UI Design cuando necesites decisiones que se apliquen a toda una app, no solo a una pantalla. Encaja bien en casos como estilos de marca en dispositivos Apple, sistemas visuales con prioridad en accesibilidad y revisiones de fundamentos para especificaciones de producto o prompts de diseño. Es menos útil si ya necesitas un patrón de interacción muy concreto o un detalle de implementación específico de plataforma.

Principales diferencias

El valor de hig-foundations es que te empuja hacia los valores predeterminados del sistema y hacia decisiones conscientes de la accesibilidad, en lugar de suposiciones decorativas de diseño. La skill también te dirige a áreas relacionadas de HIG mediante referencias cruzadas, así puedes pasar de fundamentos a plataformas, patrones o componentes sin empezar de cero. Eso hace que la guía hig-foundations sea más práctica que un prompt genérico de “sigue el estilo de Apple”.

Cómo usar la skill hig-foundations

Instala y prepara la skill

Instálala con npx skills add raintree-technology/apple-hig-skills --skill hig-foundations. Para obtener mejores resultados, úsala en un flujo de trabajo donde el agente pueda inspeccionar el archivo de la skill y el contexto cercano antes de redactar recomendaciones. La instalación de hig-foundations funciona mejor cuando tienes listos para compartir el objetivo del producto, la plataforma de destino y las restricciones de accesibilidad.

Dale a la skill la entrada correcta

Un prompt débil dice: “Haz que esto se sienta más de Apple”. Un prompt más sólido dice: “Aplica hig-foundations a esta pantalla de onboarding de iOS: usa colores del sistema, admite Dynamic Type, mantén el motion al mínimo y asegúrate de que el CTA sea legible en modo oscuro”. Incluye la plataforma, la audiencia, las restricciones de diseño existentes y cualquier problema conocido, como contraste, desajuste de iconos o layout RTL. Cuanto más concreto sea el estado actual, menos tendrá que inferir la skill.

Lee el origen en este orden

Empieza por SKILL.md, porque contiene las reglas principales de decisión y las referencias cruzadas. Después revisa cualquier contexto del repo enlazado que se mencione en la skill, especialmente README.md, AGENTS.md, metadata.json y carpetas de apoyo si existen. En este repositorio, la señal práctica clave está dentro del propio SKILL.md, así que una revisión rápida ahí suele bastar para saber si el uso de hig-foundations encaja con tu tarea.

Flujo de trabajo que produce mejores resultados

Usa la skill en tres pasos: define el problema de UI, pon límites con requisitos de plataforma y accesibilidad, y luego pide una recomendación o una reescritura. Por ejemplo: “Revisa esta página de ajustes para iPad con hig-foundations y sugiere cambios de color, jerarquía y claridad en los objetivos táctiles”. Así le das al modelo una superficie de diseño concreta que evaluar, en lugar de obligarlo a inventarla desde cero. Si trabajas a partir de copy o de un wireframe, incluye ambos; la guía de fundamentos mejora cuando se revisan texto y layout juntos.

Preguntas frecuentes sobre la skill hig-foundations

¿hig-foundations es solo para diseñadores?

No. La skill hig-foundations es útil para diseñadores, PMs, frontend engineers y agentes que necesitan orientación de UI alineada con Apple. Si estás redactando tickets de implementación o revisando el copy de una interfaz, también puede ayudar, porque muchos problemas de fundamentos afectan al código tanto como a lo visual.

¿En qué se diferencia de un prompt genérico?

Un prompt genérico puede mencionar el estilo de Apple, pero hig-foundations te da un marco de decisión reutilizable para fundamentos como colores del sistema, accesibilidad y jerarquía visual. Eso suele reducir las respuestas vagas y hace que la guía hig-foundations sea más fiable para usarla repetidamente en pantallas o funcionalidades. Sigue sin sustituir el contexto de producto, pero es más disciplinada que pedir “mejor diseño” en lenguaje llano.

¿Cuándo no debería usar esta skill?

No uses hig-foundations si necesitas un patrón de interacción muy específico, una decisión sobre una librería de componentes o una revisión profunda de implementación de plataforma. En esos casos, una skill más enfocada o una guía directa de la plataforma será más rápida. Evítala también cuando el diseño ya siga las convenciones de Apple y solo necesites pequeños ajustes de copy.

¿Es apta para principiantes?

Sí, si puedes describir la pantalla del producto y el problema que intentas resolver. No necesitas conocer de antemano todos los términos de HIG. El mejor uso de hig-foundations viene de prompts simples y explícitos que nombren el dispositivo, el problema y el conjunto de restricciones.

Cómo mejorar la skill hig-foundations

Da restricciones de diseño más precisas

La mejora de calidad más grande llega cuando indicas qué no debe cambiar: el color de marca, el layout existente, los idiomas compatibles o los mínimos de accesibilidad. Por ejemplo, di “mantén la estructura actual pero haz la jerarquía más parecida a Apple, conserva el acento de marca y supera el contraste en modo oscuro”. Eso permite que la skill se concentre en los trade-offs en lugar de repetir consejos obvios.

Pide decisiones, no principios generales

La skill hig-foundations funciona mejor cuando le pides que elija. Formula prompts como “qué colores del sistema encajan con esta tarjeta de estado” o “¿este motion debería reducirse o eliminarse?” en vez de “explica la accesibilidad”. Las decisiones concretas generan resultados que puedes aplicar de inmediato y revisar con rapidez.

Itera con el primer borrador

Después de la primera respuesta, acota el alcance a la parte más débil: tipografía, contraste, iconografía o densidad del layout. Devuelve el fallo concreto, por ejemplo: “el CTA se siente demasiado protagonista” o “el contenido sigue demasiado apretado para Dynamic Type”. Iterar funciona muy bien con hig-foundations porque los problemas de fundamentos suelen ser más fáciles de corregir una capa a la vez.