hig-components-search

Descripción general de la skill hig-components-search

hig-components-search es una skill de Apple HIG para diseñar campos de búsqueda, controles de página y controles de ruta en interfaces con mucha navegación. Usa la skill hig-components-search cuando necesites una respuesta práctica a preguntas como “¿cómo debería funcionar la búsqueda en mi app?”, “¿dónde deben ir los controles de paginación?” o “¿cómo muestro la jerarquía sin confundir a los usuarios?”. Es especialmente útil para diseñadores de interfaz, equipos de producto y agentes que necesitan orientación alineada con HIG para UX de búsqueda, ámbitos de búsqueda, sugerencias de búsqueda y navegación tipo directorio.

En qué destaca esta skill

Esta skill es más fuerte cuando la tarea trata sobre comportamiento del componente, ubicación y expectativas del usuario, no solo sobre estilo visual. Te ayuda a decidir si conviene usar un campo de búsqueda, un control de página o un control de ruta, y cómo debe comportarse cada uno en una interfaz real.

Por qué merece la pena instalarla

El valor principal de hig-components-search install es el apoyo a la toma de decisiones: reduce las dudas sobre cuándo la búsqueda debe actualizarse al instante, cuándo los ámbitos son apropiados y cuándo los controles de página o de ruta no encajan. Eso la hace más útil que un prompt genérico, porque ancla la respuesta en patrones de navegación de Apple HIG.

Cuándo encaja bien

Elige hig-components-search for UI Design si tu entrada incluye descubrimiento por búsqueda, resultados filtrados, contenido paginado, breadcrumbs, jerarquía de archivos o navegación por elementos antecesores. Es una buena opción para apps con listas, bibliotecas, catálogos, ajustes, exploradores de archivos o cualquier interfaz en la que los usuarios necesiten encontrar contenido estructurado o moverse por él.

Cómo usar la skill hig-components-search

Instala y carga el contexto de la skill

Instala hig-components-search en el entorno de tu agente y después apunta al modelo hacia el contexto de la skill antes de pedir orientación de diseño. Un flujo típico de hig-components-search usage consiste en invocar la skill con un brief breve del producto y dejar que aplique las reglas HIG a tu pantalla o función concreta.

Dale a la skill la entrada adecuada

La skill funciona mejor cuando describes: el tipo de contenido, el objetivo del usuario, el modelo de navegación y las restricciones. Por ejemplo, en vez de “diseña búsqueda”, pide “un campo de búsqueda para una gran biblioteca de documentos con resultados en vivo, filtrado opcional por categoría y sin sintaxis de consulta avanzada”. Eso le da suficiente contexto para decidir entre campos de búsqueda, ámbitos, tokens y comportamiento de estado vacío.

Lee primero estos archivos

Empieza por skills/hig-components-search/SKILL.md y después abre references/search-fields.md, references/page-controls.md y references/path-controls.md. Esos tres archivos son la forma más rápida de entender la guía real que hay detrás de hig-components-search guide y evitar forzar un patrón de búsqueda más allá de casos de paginación o jerarquía.

Un patrón de prompt que sí funciona

Usa un prompt que nombre la interfaz, el contenido y la decisión que necesitas. Ejemplo: “Aplica hig-components-search a un explorador de archivos en macOS. Recomienda la ubicación de la búsqueda, si conviene usar ámbitos y si un control de ruta debe ser estándar o emergente.” Esto es más sólido que una petición vaga, porque obliga a la skill a responder con orientación a nivel de componente y no con consejos genéricos de UX.

Preguntas frecuentes sobre la skill hig-components-search

¿hig-components-search trata solo de campos de búsqueda?

No. La hig-components-search skill también cubre controles de página y controles de ruta, así que ayuda cuando el problema es la estructura de navegación y no solo la entrada de consulta. Eso importa cuando los equipos confunden búsqueda, paginación y visualización de jerarquía.

¿La necesito si puedo escribir un prompt normal?

Si ya conoces las reglas de HIG y solo necesitas un recordatorio rápido, quizá no. Instala hig-components-search cuando quieras una guía más fiable y reutilizable que se mantenga alineada con las convenciones de Apple para componentes de navegación y evite usos incorrectos comunes, como tratar los controles de página como navegación jerárquica.

¿Es adecuada para diseñadores principiantes?

Sí, si el objetivo es tomar una buena primera decisión con rapidez. La skill es especialmente útil para principiantes que no tienen claro cuándo usar sugerencias de búsqueda, controles de ámbito o controles de ruta, porque ofrece un marco concreto en lugar de dejarlos inferir el patrón.

¿Cuándo no debería usarla?

No uses hig-components-search para branding, decoración visual o sistemas generales de maquetación. Tampoco encaja bien si tu producto necesita lógica de búsqueda muy personalizada, taxonomías de filtrado empresariales o un comportamiento que se aparte intencionalmente de los patrones de Apple HIG.

Cómo mejorar la skill hig-components-search

Aporta el contexto de decisión desde el principio

Los mejores resultados llegan con entradas que incluyen la plataforma, la densidad del contenido y si el usuario está buscando, explorando o navegando por una jerarquía. Por ejemplo: “app para iPad, 20.000 elementos, búsqueda en vivo, botones de ámbito opcionales, la lista de resultados se actualiza mientras el usuario escribe”. Eso es mejor que “mejora la búsqueda”, porque permite a la skill elegir el modelo de interacción correcto.

Sé explícito con las restricciones y los casos que no encajan

Si la interfaz no puede actualizarse al instante, si los ámbitos son limitados o si la profundidad de la jerarquía es pequeña, dilo. Esas restricciones cambian si hig-components-search debe recomendar búsqueda inmediata, tokens o un patrón más simple. Cuanto más expliques por adelantado, menos dependerá la respuesta de suposiciones.

Itera sobre una pantalla concreta

Después de la primera pasada, pide a la skill que refine una pantalla específica en vez de todo el producto. Un buen seguimiento sería: “Revisa esto para estados vacíos, ámbito predeterminado y navegación a antecesores en macOS”. Eso acota el problema y suele mejorar el valor práctico de la recomendación.

Vigila los fallos habituales

Los errores más comunes son abusar de los ámbitos de búsqueda, usar controles de página para navegación no plana y definir demasiado poco los estados vacíos o la retroalimentación de resultados. Si la primera respuesta se siente genérica, vuelve a ejecutar hig-components-search con el modelo exacto de contenido, el número de resultados y la siguiente acción más probable del usuario.