hig-components-menus
por raintree-technologyhig-components-menus es una skill de Apple HIG para decisiones de diseño de menús y superficies de comandos basadas en botones. Usa la skill hig-components-menus cuando necesites orientación de Apple para menús, menús contextuales, barras de herramientas, barras de menús y controles relacionados, y debas decidir la ubicación, agrupación y comportamiento de comandos.
Esta skill obtiene 82/100, lo que la convierte en una entrada sólida del directorio para quienes necesitan orientación de Apple HIG sobre menús y botones. Ofrece a los agentes un alcance de activación claro, señales concretas para decidir y material de referencia estructurado suficiente para actuar con menos suposiciones que con un prompt genérico, aunque es más un índice de guía que un flujo de trabajo automatizado paso a paso.
- Alta capacidad de activación: la descripción menciona de forma explícita muchas intenciones de usuario y tipos de componentes, lo que facilita que un agente la invoque correctamente.
- Buena cobertura respaldada por referencias: el contenido vincula menús, menús contextuales, menús de edición, barra de menús, barras de herramientas, botones de acción, botones emergentes o desplegables, controles de divulgación y botones estándar.
- Referencias cruzadas y atribución útiles: 11 archivos de referencia apuntan a páginas canónicas de Apple HIG, lo que mejora la confianza y la navegación.
- Ligera en lo operativo: el repositorio es principalmente contenido de referencia organizado, sin scripts ni comando de instalación que respalden una ejecución procedimental.
- Algo amplia y menos profunda: la descripción es extensa, pero los fragmentos visibles del cuerpo sugieren una guía de nivel superior que puede requerir que el agente sintetice varias referencias.
Descripción general de la skill hig-components-menus
hig-components-menus es una skill de guía HIG de Apple para diseñar menús y superficies de comandos basadas en botones en las plataformas de Apple. Usa la skill hig-components-menus cuando necesites orientación práctica sobre menús, menús contextuales, menús del Dock, menús de edición, la barra de menús, barras de herramientas, botones de acción, botones emergentes, botones desplegables, controles de divulgación o botones estándar.
Esta skill es especialmente útil para diseñadores de UI, diseñadores de producto, ingenieros frontend y agentes de IA que generan guía de interfaz con estilo Apple. El trabajo real no es “qué es un menú”, sino “qué control debe ir aquí, qué debe contener y cómo debe comportarse para respetar las convenciones de Apple y seguir siendo predecible”.
Qué te ayuda a decidir
La guía hig-components-menus resulta útil cuando la pregunta de diseño trata sobre la colocación de comandos, no solo sobre el acabado visual. Te ayuda a elegir entre acciones en la barra de herramientas, comandos en la barra de menús, menús contextuales y controles en línea; evitar sobrecargar los menús con elementos de poco valor; y mantener las etiquetas, el orden y la agrupación alineados con las expectativas de la plataforma.
Por qué vale la pena instalarla
Frente a un prompt genérico, hig-components-menus ofrece una cobertura HIG estructurada y referencias cruzadas hacia temas cercanos como botones, menús contextuales, menús de edición y barras de herramientas. Eso la hace más sólida para decisiones que dependen de los límites entre componentes y de su comportamiento, especialmente cuando necesitas coherencia específica de Apple en lugar de consejos amplios de UI.
Casos de encaje y de no encaje
Instala hig-components-menus si diseñas para plataformas de Apple o si traduces la intención del producto a una UI alineada con el HIG de Apple. Omítela si necesitas código de framework, detalles de implementación de componentes o sistemas de diseño que no sean de Apple; esta skill trata de guía de diseño y elecciones de interacción, no de APIs del SDK.
Cómo usar la skill hig-components-menus
Instala y abre el archivo de entrada correcto
Usa la ruta de instalación de hig-components-menus desde el directorio y empieza por SKILL.md. Los archivos de apoyo más útiles son las páginas de references/, porque separan las familias principales de componentes en fragmentos fáciles de leer. Para una primera criba rápida, lee antes references/menus.md, references/buttons.md, references/context-menus.md y references/toolbars.md.
Dale a la skill un problema de UI concreto
El uso de hig-components-menus funciona mejor cuando describes la pantalla, la plataforma y el objetivo del usuario en lugar de pedir consejos de diseño abstractos. Una buena entrada nombra la fuente del comando, el contexto y la restricción:
- “Diseña la superficie de comandos para un editor de documentos en macOS con 8 acciones frecuentes y 12 acciones ocasionales.”
- “¿Deberían eliminar, duplicar y compartir vivir en la barra de herramientas, el menú contextual o la barra de menús en iPadOS?”
- “¿Cómo debería diferir un menú contextual de estilo Apple para texto seleccionado frente a un elemento de archivo?”
Si solo dices “diseña mi menú”, la skill tendrá que adivinar el modelo de interacción y será menos útil.
Lee las referencias en el orden de la decisión
Una guía práctica de hig-components-menus suele empezar por el componente principal y luego afinar hacia los casos especiales. Lee references/menus.md para reglas de etiquetado y organización, references/context-menus.md para relevancia y número de elementos, y references/toolbars.md cuando estés decidiendo qué debe estar siempre visible. Usa references/the-menu-bar.md para la arquitectura de comandos en macOS y references/edit-menus.md cuando intervenga la edición de texto.
Usa un flujo de trabajo que empiece por la decisión
Pídele a la skill primero la elección del control, luego el contenido y después el orden. Un formato de prompt eficaz es:
- Plataforma: macOS, iPadOS, iOS o visionOS
- Objeto: selección, documento, mensaje, archivo o comando a nivel de app
- Conjunto de acciones: primarias, secundarias, destructivas y no disponibles
- Restricción: espacio, descubribilidad, compatibilidad con teclado o coherencia
Esa estructura ayuda a la skill hig-components-menus a devolver una respuesta más precisa sobre dónde debe ir cada comando y qué conviene ocultar, agrupar o destacar.
Preguntas frecuentes sobre la skill hig-components-menus
¿hig-components-menus es solo para menús?
No. La skill hig-components-menus cubre menús y los patrones adyacentes de botones que controlan el acceso a comandos, incluidos botones de acción, botones emergentes, botones desplegables, controles de divulgación, barras de herramientas y botones estándar. Ese alcance más amplio es útil porque muchas decisiones de UI en Apple dependen de si una acción se expone como botón, como elemento de menú o de ambas formas.
¿Cuándo no debería usar esta skill?
No uses hig-components-menus si tu pregunta trata sobre branding visual, animación personalizada o código de componentes. Tampoco es la opción adecuada si diseñas para un ecosistema que no es de Apple y no necesitas el comportamiento del HIG de Apple. Para detalles de implementación, combínala con la documentación del framework.
¿En qué se diferencia de un prompt normal?
Un prompt normal podría proponer una estructura de menú, pero la skill hig-components-menus está ajustada a los compromisos específicos de Apple: jerarquía de comandos, convenciones de plataforma, densidad de menús y cuándo conviene preferir acciones visibles frente a opciones ocultas. Eso suele reducir la especulación cuando necesitas una UI que se sienta nativa en dispositivos Apple.
¿Es adecuada para principiantes?
Sí, si puedes describir la pantalla y las acciones implicadas. No necesitas dominar el HIG en profundidad para empezar a usar hig-components-menus, pero sí necesitas suficiente contexto para indicar qué está haciendo el usuario y qué comandos están disponibles. Cuanto mejor sea tu escenario, mejor será la guía.
Cómo mejorar la skill hig-components-menus
Aporta inventarios de acciones, no solo objetivos
La mayor mejora de calidad llega cuando enumeras las acciones reales. En lugar de “haz esto más fácil”, dale a la skill el conjunto de comandos y señala qué acciones son frecuentes, raras, destructivas o contextuales. Así hig-components-menus puede valorar si conviene una barra de herramientas, un menú o un menú contextual, y si un elemento debería ocultarse o mostrarse.
Indica explícitamente la plataforma y el gesto de activación
Un patrón de menú que encaja en macOS puede ser incorrecto en iOS o iPadOS. Di si el usuario invoca el comando con clic, clic secundario, mantener pulsado, teclado o navegación por la barra de menús. Esto importa porque la guía hig-components-menus es sensible a las rutas de interacción específicas de cada plataforma, sobre todo en menús contextuales y menús de edición.
Pide compensaciones, no solo una respuesta final
Si la primera respuesta te parece genérica, itera preguntando por qué un comando debe ir en un sitio y no en otro. Por ejemplo: “¿Qué elementos deberían pasar del menú contextual a la barra de herramientas y cuál es el coste en descubribilidad?” Eso produce un uso más útil de hig-components-menus porque la salida deja de ser solo una lista y pasa a apoyar la decisión.
Vigila los fallos habituales
Los errores más comunes son menús saturados, comandos duplicados sin una prioridad clara y ocultar acciones centrales detrás de gestos secundarios. Usa la skill para detectar esos problemas pronto. Si la primera salida parece demasiado densa, pide un conjunto reducido de elementos de alto valor y una separación más estricta entre acciones primarias y secundarias.