visionos-design-guidelines
por ehmoEl skill visionos-design-guidelines te ayuda a aplicar las reglas de Apple Vision Pro para UI espacial, entrada con ojos y manos, espacios inmersivos, ventanas, volúmenes y accesibilidad. Úsalo al revisar o diseñar interfaces de visionOS que requieran comodidad, ubicación correcta y una guía fiel a la plataforma.
Este skill obtiene 85/100, así que es una opción sólida para el directorio si estás construyendo o revisando trabajo en visionOS. Aporta a los agentes suficiente lenguaje de activación, estructura de reglas y guía específica de plataforma para reducir la improvisación frente a un prompt genérico, aunque conviene esperar un flujo de trabajo centrado en directrices de diseño y no una herramienta ejecutable.
- Ámbito de activación claro para tareas de visionOS, Apple Vision Pro, RealityKit, UI espacial y realidad mixta.
- Contenido amplio y real, sin relleno, con más de 50 reglas distribuidas en secciones categorizadas y niveles de severidad, lo que ayuda a tomar decisiones de diseño concretas.
- Buen enfoque operativo en AGENTS.md y rules/_sections.md, con restricciones de “nunca hacer” e índice rápido de reglas como referencia.
- No incluye comando de instalación ni scripts, así que su adopción depende de la documentación y no de asistencia automatizada.
- El repositorio está muy centrado en la guía y no muestra flujos de trabajo completos ni ejemplos de cómo aplicar las reglas en acciones de agentes.
Descripción general de la skill visionos-design-guidelines
Para qué sirve esta skill
La skill visionos-design-guidelines te ayuda a aplicar las reglas de diseño de Apple Vision Pro cuando necesitas decidir cómo distribuir una interfaz espacial, cómo deben funcionar la entrada ocular y manual, o si un concepto inmersivo encaja con las convenciones de visionOS. Es especialmente útil cuando no buscas solo inspiración, sino restricciones de diseño que afectan la comodidad, la alcanzabilidad y la corrección para la plataforma.
Quién debería instalarla
Instala visionos-design-guidelines si estás diseñando o revisando una app de visionOS, una experiencia en RealityKit, un volumen, una interfaz basada en ventanas o un prototipo de realidad mixta. Es especialmente útil para diseñadores de UI, ingenieros de producto y agentes de IA que necesitan generar recomendaciones listas para implementar, en lugar de consejos genéricos de “hazlo más inmersivo”.
Por qué destaca
Esta skill se centra menos en la teoría general de producto y más en guardarraíles prácticos: dónde colocar el contenido, cómo manejar la interacción de mirada más pellizco, qué no fijar a la cabeza y cómo evitar errores de comodidad o accesibilidad. La skill visionos-design-guidelines brilla cuando necesitas una revisión rápida de diseño frente a reglas espaciales críticas antes de construir.
Cómo usar la skill visionos-design-guidelines
Instala y carga el contexto adecuado
Usa el flujo visionos-design-guidelines install desde tu gestor de skills y luego lee primero los archivos de entrada de la skill: SKILL.md, AGENTS.md, metadata.json y rules/_sections.md. Esta skill no depende de scripts, así que el valor está en el conjunto de reglas y en los resúmenes por categoría.
Empieza con un brief espacial concreto
El uso de visionos-design-guidelines usage funciona mejor cuando tu prompt incluye el tipo de interfaz, el objetivo del usuario y el contexto físico. Buenos ejemplos de entrada suenan así: “Diseña un flujo de onboarding de visionOS para una app de productividad usando una ventana y un ornamento”, o “Revisa este panel inmersivo por comodidad, tamaño de objetivo y riesgos de interacción ocular/manual”. Entradas débiles como “hazlo más estilo Apple” suelen producir respuestas genéricas.
Convierte una idea vaga en un prompt mejor
Para visionos-design-guidelines for UI Design, incluye:
- superficie de la app: ventana, volumen, espacio inmersivo o diseño mixto
- tarea principal: lectura, selección, manipulación, navegación o visualización de estado
- modelo de interacción: mirada, pellizco, arrastrar, gesto manual, voz o entrada mixta
- restricciones: número fijo de ventanas, necesidades de accesibilidad, límites de comodidad o código existente de RealityKit
Un prompt más sólido es: “Usando las guías de visionOS, critica este panel de dos secciones por fatiga visual, ubicación dentro del campo de visión y tamaño de los controles; luego reescríbelo como una disposición espacialmente cómoda.”
Lee los archivos en este orden
Usa visionos-design-guidelines guide como ruta para leer el repositorio:
rules/_sections.mdpara el mapa de reglas clasificado por severidadSKILL.mdpara las reglas detalladas y los anti-patronesAGENTS.mdpara propósito, alcance y señales de usometadata.jsonpara referencias y contexto de versión
Si vas corto de tiempo, empieza por las categorías críticas: distribución espacial, entrada ocular y manual, y accesibilidad.
Preguntas frecuentes de la skill visionos-design-guidelines
¿Es solo para Apple Vision Pro?
Principalmente sí. La skill visionos-design-guidelines está centrada en visionOS y en las convenciones de Apple Vision Pro, aunque sus reglas también resultan útiles para cualquier interfaz de computación espacial que use mirada, entrada manual o distribución anclada al mundo.
¿En qué se diferencia de un prompt normal?
Un prompt normal puede darte una respuesta de estilo. Esta skill te da una lente de diseño basada en reglas: distancia, colocación, tamaño de objetivo, feedback de hover, cobertura de accesibilidad y límites de inmersión. Por eso es mejor para revisión, implementación y para evitar errores específicos de la plataforma.
¿Es apta para principiantes?
Sí, si puedes describir la pantalla o la experiencia que quieres. No necesitas un conocimiento profundo de visionOS para usar visionos-design-guidelines, pero sí debes aportar suficiente contexto para que la skill evalúe con precisión la distribución espacial y los patrones de interacción.
¿Cuándo no debería usarla?
No la uses para UI móvil general, interfaces solo web o textos de producto sin componente espacial. Tampoco es la opción adecuada si necesitas generación de código sin revisión de diseño, o si tu tarea no tiene componente de visionOS, RealityKit o realidad mixta.
Cómo mejorar la skill visionos-design-guidelines
Dale la forma real de la interfaz
La mayor mejora de calidad llega cuando especificas qué existe en pantalla y dónde vive en el espacio. Indica si tienes una sola ventana, varias ventanas, un volumen flotante o una escena inmersiva, y señala qué debe hacer el usuario en los primeros 5 segundos.
Expón las restricciones que cambian la respuesta
visionos-design-guidelines funciona mejor cuando mencionas desde el principio las restricciones de comodidad, accesibilidad e interacción. Incluye cosas como tamaños mínimos de objetivo, si la interfaz debe admitir VoiceOver o control por puntero, y si el diseño necesita evitar movimientos frecuentes de cabeza.
Pide una crítica y luego una reescritura
Un flujo útil es: primero pedir violaciones de las reglas y después una versión corregida. Ejemplo: “Audita este onboarding de visionOS según las reglas de comodidad, feedback de mirada y accesibilidad; luego reescribe la distribución y la secuencia de interacción”. Eso suele dar resultados más accionables que pedir un diseño genérico.
Usa la primera respuesta para acotar la siguiente pasada
Si el resultado inicial es demasiado amplio, afina por categoría: distribución espacial, entrada ocular y manual, ventanas o accesibilidad. La skill visionos-design-guidelines mejora cuando iteras un modo de fallo a la vez, como la colocación del contenido, los estados de hover o el anclaje al mundo.