Communitygithub.com

Sistema de UI para Reseñas y Valoraciones

Diseña e implementa un marco sistemático para interfaces de retroalimentación de usuarios, que incluya valoraciones agregadas, resúmenes de distribución y reseñas individuales para generar confianza y prueba social.

¿Qué es Sistema de UI para Reseñas y Valoraciones?

Este skill proporciona una metodología completa para diseñar la interfaz visual y estructural de sistemas de retroalimentación generada por usuarios, combinando datos cuantitativos (valoraciones con estrellas) y cualitativos (reseñas escritas) en una interfaz escaneable, confiable y accesible. Es útil para desarrolladores y diseñadores que trabajan en páginas de productos de e-commerce, marketplaces de servicios/SaaS, plataformas de contenido o formularios de recolección de opiniones. El sistema cubre desde el resumen agregado (puntuación promedio, distribución de estrellas) hasta la anatomía de cada reseña individual, incluyendo mecanismos de interacción (ordenamiento, filtrado) y el diseño del formulario de entrada de retroalimentación. Se apoya en principios de jerarquía visual, accesibilidad (etiquetas ARIA, navegación por teclado) y responsividad, y está pensado para plataformas web modernas donde la confianza del usuario es crítica. El skill también advierte sobre patrones de fallo comunes, como la falta de estados de media estrella, distribución oculta o inputs inaccesibles.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/review-and-rating-system

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Sistema de UI para Reseñas y Valoraciones?

Propósito

El Sistema de UI para Reseñas y Valoraciones proporciona una metodología para diseñar el marco visual y estructural de la retroalimentación generada por usuarios. Garantiza que los datos cuantitativos (valoraciones con estrellas) y cualitativos (reseñas escritas) se organicen en una interfaz escaneable, confiable y accesible. Este sistema ayuda a los usuarios a tomar decisiones informadas al mostrar la retroalimentación más relevante, manteniendo la coherencia visual con el diseño general del sitio.

Casos de Uso

  • Páginas de Producto en E-commerce: Mostrar la satisfacción del producto y experiencias detalladas de clientes.
  • Mercados de Servicios/SaaS: Valorar proveedores, herramientas o aplicaciones.
  • Plataformas de Contenido: Permitir a los usuarios valorar artículos, cursos o medios.
  • Formularios de Recopilación de Opiniones: Diseñar la parte de entrada del sistema de valoración.
  • Resúmenes de Reseñas: Crear distribuciones de valoración "de un vistazo" (ej. gráficos de barras de 5 estrellas).

Cuándo NO Usar

  • Auditorías de Calidad Internas: Cuando la retroalimentación es privada y se usa solo para procesamiento interno sin una UI pública.
  • Retroalimentación Binaria: Si el objetivo es un simple "Útil/No Útil" o "Voto Positivo/Negativo", usa un patrón de interacción más simple de sistema-de-estado-interactivo.
  • Contenido con Bajo Volumen: Si un sitio típicamente tiene 0–2 reseñas por artículo, un resumen de distribución complejo puede verse "vacío" o desalentador.
  • Datos Estrictamente Cuantitativos: Para métricas de rendimiento o salud del sistema (ej. "99,9% de Tiempo Activo"), usa un sistema-de-insignias-y-etiquetas simple o visualización de datos.

Entradas

  1. Esquema de Retroalimentación: Los datos a capturar/mostrar (Valoración 1-5, Título, Cuerpo, Fecha, ID de Usuario, Estado de verificación, Fotos).
  2. Metadatos Agregados: Conteo total de reseñas y puntuación promedio.
  3. Datos de Distribución: El conteo de reseñas para cada nivel de estrella (5, 4, 3, 2, 1).
  4. Requisitos de Interacción: Ordenamiento (Más Recientes, Mejor Valorados), Filtrado (Solo Verificados, Con Fotos) y votación "Útil".

Salidas

  1. Especificación del Componente de Valoración: Diseño visual para la "Fila de Estrellas" (incluyendo estados vacío, medio y lleno).
  2. Anatomía del Resumen de Reseñas: Un diseño para la puntuación agregada y el gráfico de barras de distribución.
  3. Plantilla de Reseña Individual: El diseño estructural para una entrada de reseña única (Usuario, Valoración, Contenido, Acciones).
  4. Especificación de Interacción de Entrada: El diseño para la selección de valoración y el formulario de envío de reseña.

Flujo de Trabajo

1. Diseñar el Resumen Agregado (La Instantánea)

Antes de mostrar reseñas individuales, proporciona un atajo mental:

  • Puntuación Promedio: Número grande y prominente (ej. "4,8").
  • Visualización de Estrellas: Una fila de 5 estrellas que refleje el promedio.
  • Conteo Total: "Basado en 1.240 reseñas".
  • Barras de Distribución: Una lista vertical u horizontal que muestre el porcentaje de reseñas de 5, 4, 3, 2 y 1 estrella. Idealmente deberían ser interactivas (hacer clic en una barra filtra la lista).

2. Establecer la Anatomía de la Reseña Individual

Aplica sistema-de-jerarquía-visual a la tarjeta de reseña:

  • Encabezado: Nombre del usuario (opcionalmente anónimo) e insignia "Compra Verificada".
  • Valoración y Fecha: La valoración con estrellas y cuándo se publicó.
  • Título y Cuerpo: Un título en negrita para el sentimiento principal, seguido del texto descriptivo.
  • Medios (Opcional): Miniaturas para fotos subidas por el usuario.
  • Pie/Acciones: Botones "¿Fue útil esto? (Sí/No)" y "Reportar".

3. Seleccionar Patrones de Interacción y Descubrimiento

Permite a los usuarios encontrar la retroalimentación más relevante para ellos:

  • Ordenamiento: Por defecto a "Más Relevante" (una mezcla de actualidad y utilidad). Permite cambiar a "Más Reciente" o "Mejor/Peor Valorado".
  • Filtrado: Proporciona alternadores rápidos para "Con Imágenes", "Solo Verificados" o conteos de estrellas específicos.

4. Diseñar la Entrada de Retroalimentación (El Formulario)

Asegúrate de que el proceso de recopilación sea sin fricciones:

  • Disparador Inicial: Usa estrellas grandes e interactivas que cambien de estado al pasar el ratón. Un grupo de radio de entradas de estrellas estilizado con el selector :has() (ej. label:has(~ input:checked)) proporciona estados de relleno al pasar/ seleccionar sin JavaScript adicional.
  • Divulgación Progresiva: Revela el área de entrada de texto solo después de seleccionar una valoración con estrellas.
  • Guía Contextual: Usa marcadores de posición como "¿Qué te gustó o no te gustó?" para fomentar retroalimentación útil.

5. Planificar para la Variación de Contenido

  • Estado Vacío: Diseña un estado "Aún no hay reseñas—sé el primero en reseñar".
  • Reseñas Largas: Implementa truncamiento "Leer Más" para retroalimentación cualitativa extremadamente larga.
  • Apilamiento Responsivo: En móvil, mueve el resumen de distribución a una sección colapsable o apílalo encima de la lista de reseñas.

Reglas de Decisión

  • La Prueba del "Entrecerrar Ojos" para Estrellas: Las estrellas deben ser distinguibles incluso cuando son pequeñas. Usa colores de alto contraste (ej. Ámbar/Dorado) contra el fondo.
  • Prioridad de Verificación: Las insignias de "Compra Verificada" deben ser visualmente distintas (a menudo verdes o con un icono de check) para generar confianza inmediata.
  • Precisión del Promedio: Redondea el promedio numérico a un decimal (ej. 4,7) pero asegúrate de que la fila de estrellas represente visualmente correctamente las medias estrellas.
  • Lógica de Utilidad: Usa la votación "Útil" para mostrar las mejores reseñas, pero asegúrate de que la UI no se sobrecargue con demasiadas acciones secundarias.
  • Relación de Aspecto de Imágenes: Usa miniaturas cuadradas (1:1) para las imágenes de reseñas subidas por el usuario para mantener la lista de reseñas organizada.

Restricciones

  • Accesibilidad: Las valoraciones con estrellas deben usar aria-label (ej. "4 de 5 estrellas"). Las entradas de estrellas interactivas deben ser accesibles por teclado y usar role="radiogroup" o similar, con cada estrella de al menos 24x24px (WCAG 2.2, 2.5.8) — se prefiere 44x44px dado lo fácil que es tocar mal un objetivo pequeño de estrella.
  • Contraste: Las estrellas vacías (fondo) deben tener un contraste de 3:1 contra el fondo de la página; las estrellas llenas deben tener 4.5:1 contra el fondo o un borde fuerte.
  • Responsividad: Las listas de reseñas deben ser fluidas. Evita tarjetas de reseña de varias columnas en móvil; apila todos los metadatos verticalmente.

Patrones de Falla Comunes

  • El Error de "Estrella Binaria": Usar estrellas que solo son "Encendido" o "Apagado" sin estados de media estrella, lo que representa incorrectamente promedios como 4,3.
  • Distribución Oculta: Mostrar la puntuación promedio pero no el desglose, imposibilitando que los usuarios vean el volumen de críticas negativas frente a positivas.
  • Falta de Verificación: No distinguir entre un comprador verificado y un usuario genérico, reduciendo la confianza de todo el sistema.
  • El "Muro de Reseñas": No proporcionar ordenamiento o filtrado, obligando a los usuarios a desplazarse por cientos de entradas irrelevantes.
  • Entradas Inaccesibles: Usar una entrada de valoración con estrellas solo de iconos que no puede ser alcanzada o seleccionada por usuarios que solo usan teclado.

Criterios de Validación

  • La valoración promedio y el resumen de distribución están presentes y son escaneables.
  • Las reseñas individuales tienen una jerarquía clara (Usuario -> Valoración -> Contenido).
  • El estado de "Compra Verificada" está señalizado visualmente.
  • Los controles de ordenamiento y filtrado están presentes para escenarios de alto volumen.
  • Accesibilidad: Las valoraciones con estrellas tienen etiquetas ARIA descriptivas.
  • Las entradas de valoración interactivas son navegables por teclado y tienen estados de enfoque.
  • El diseño es responsivo, apilando elementos de manera lógica en pantallas más pequeñas.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

Skills relacionados