tvos-design-guidelines

Descripción general de la skill tvos-design-guidelines

La skill tvos-design-guidelines es un conjunto práctico de reglas de diseño para Apple TV, pensado para equipos que construyen o revisan interfaces de tvOS. Te ayuda a decidir si una pantalla, un flujo de navegación o una UI de reproducción va a funcionar de verdad en el salón antes de publicar. Si necesitas la skill tvos-design-guidelines para UI Design, encaja especialmente bien cuando el movimiento del foco, el comportamiento del Siri Remote, la legibilidad a 10 pies o los controles multimedia son los riesgos reales.

Para qué sirve mejor esta skill tvos-design-guidelines

Usa tvos-design-guidelines cuando estés diseñando apps para tvOS, auditando una interfaz existente de Apple TV o redactando prompts para un modelo que tenga que razonar sobre navegación basada en foco. Es especialmente útil para evaluaciones tipo checklist, críticas pantalla por pantalla y guía de implementación, donde pequeños errores de interacción generan grandes problemas de usabilidad.

En qué se diferencia de un prompt genérico

Un prompt de diseño normal puede mencionar “Apple TV” pero pasar por alto las restricciones que más importan: no hay puntero, no hay toque, el orden del foco debe ser predecible y el control es primero con el mando. Esta guía tvos-design-guidelines pone esas restricciones en primer plano desde el inicio, así que es menos probable que el resultado sugiera patrones móviles que fallan en tvOS.

Riesgos principales de adopción que aborda

Los mayores bloqueos son los trampas de foco, los estados de selección poco claros, un comportamiento del mando que rompe la navegación esperada y layouts que se ven bien en un monitor pero fallan a distancia de sala. La skill es especialmente fuerte cuando quieres una guía basada en reglas que detecte esos problemas antes de la implementación.

Cómo usar la skill tvos-design-guidelines

Instálala y empieza por los archivos principales

Instala con npx skills add ehmo/platform-design-skills --skill tvos-design-guidelines. Después, lee primero SKILL.md, luego AGENTS.md, metadata.json y rules/_sections.md. Esos archivos te dicen para qué está optimizada la skill, qué reglas son críticas y dónde están las restricciones de diseño de tvOS más importantes.

Dale una tarea, no solo un tema

La skill funciona mejor cuando tu input nombra la pantalla, el objetivo del usuario y el contexto de plataforma. Input débil: “Revisa esta app de Apple TV.” Input fuerte: “Revisa la pantalla de detalle de una película para tvOS y comprueba el orden del foco, el foco predeterminado, el comportamiento de vuelta con el mando y si los metadatos siguen siendo legibles a 10 pies de distancia.” Ese tipo de prompt hace que el uso de tvos-design-guidelines sea concreto y accionable.

Qué incluir en tu prompt

Indica el tipo de layout, las acciones principales, cualquier comportamiento de reproducción multimedia y si la vista es nueva o una rediseño. Si aplica, menciona restricciones como soporte para Top Shelf, necesidades de accesibilidad o movimiento de foco personalizado. Cuanto más describas el recorrido de interacción, más fácil será para la skill juzgar si el diseño respeta las suposiciones de instalación de las tvOS design guidelines.

Flujo de trabajo práctico para obtener mejores resultados

Empieza con un prompt aproximado, luego pide una revisión basada en reglas y después solicita correcciones. Por ejemplo: “Evalúa esta pantalla según las reglas de foco de tvOS, lista las infracciones por severidad y luego reescribe el modelo de interacción.” Esa secuencia produce mejores resultados que pedir un diseño final en un solo paso, porque la skill primero puede sacar a la luz los huecos antes de que pidas la corrección.

Preguntas frecuentes de la skill tvos-design-guidelines

¿Esto es solo para diseño de apps para Apple TV?

Sí. La skill tvos-design-guidelines está centrada en patrones de interacción de tvOS y aporta más valor en interfaces de Apple TV, navegación por foco y restricciones de visualización en el salón. Si tu producto no depende de una navegación controlada con mando, la guía será menos útil que un prompt general de UI design.

¿Sustituye a la HIG de Apple?

No. Es una capa de trabajo práctica encima de las Apple Human Interface Guidelines, no un sustituto. Úsala cuando quieras una guía tvos-design-guidelines más rápida y operativa que convierta los conceptos de la HIG en comprobaciones de diseño e implementación.

¿Es apta para principiantes?

En general, sí, porque las reglas de mayor valor son concretas: el foco debe verse, el movimiento debe ser predecible y las acciones con el mando deben mantenerse simples. A los principiantes les ayuda porque reduce la incertidumbre, aunque sigue siendo útil conocer términos básicos de tvOS como focus, Top Shelf y Siri Remote.

¿Cuándo no debería usarla?

No la uses para layouts de iPhone o iPad centrados en toque, ni para trabajo genérico de UI donde la navegación por foco no sea el problema principal. Tampoco encaja bien si necesitas estrategia de marca o conceptos de motion sin ninguna restricción de plataforma, porque la skill está pensada para decisiones de instalación de tvos-design-guidelines y revisión de implementación.

Cómo mejorar la skill tvos-design-guidelines

Da más contexto sobre la pantalla

Los mejores resultados vienen de prompts que especifican la pantalla exacta y su estado: página de exploración, página de detalle, overlay de reproducción, ajustes o onboarding. Incluye qué intenta hacer el usuario, qué se puede seleccionar y dónde debería caer el foco primero. Ese contexto permite aplicar tvos-design-guidelines con más precisión en lugar de dar consejos genéricos.

Haz visibles pronto los fallos más comunes

Pregunta de forma explícita por trampas de foco, controles inaccesibles, estados de selección ambiguos y cualquier punto donde el foco pueda saltar a otra parte del layout. Si una pantalla contiene rejillas, carruseles o contenido mixto, dilo; esos patrones son donde el output de tvOS suele romperse con más frecuencia.

Itera con restricciones, no con estética

Si la primera respuesta es demasiado amplia, acota la siguiente ronda pidiendo una de estas tres cosas: una lista de infracciones por regla, un mapa de foco revisado o una auditoría de interacción con el mando. Esto mejora el uso de tvos-design-guidelines porque la skill puede corregir un problema concreto en lugar de volver a explicar toda la plataforma.

Usa las referencias del repositorio como checklist

Para refinar más, compara la respuesta con rules/_sections.md y metadata.json. Esos archivos son útiles cuando quieres confirmar la severidad, identificar las categorías críticas o convertir la skill en una checklist interna de revisión para trabajo de tvOS.