Communitygithub.com

Sistema de Testimonios y Citas

Diseña y estructura testimonios cualitativos de clientes, citas destacadas y componentes de atribución para establecer credibilidad, confianza y prueba social, cumpliendo con los estándares de accesibilidad WCAG AA.

¿Qué es Sistema de Testimonios y Citas?

Este skill proporciona un marco sistemático de diseño y espaciado para testimonios cualitativos de clientes y citas de clientes, abordando la prueba social de forma estructural en lugar de como un añadido tardío. Establece reglas tipográficas, de diseño y de atribución que maximizan la credibilidad visual y la autenticidad, garantizando al mismo tiempo la accesibilidad completa. El skill define tres zonas semánticas distintas (cita, atribución, marcador de confianza), múltiples patrones de diseño espacial (hero spotlight, cuadrícula de tarjetas, pull-quote en línea) y una jerarquía tipográfica clara para garantizar la escaneabilidad. Incluye flujos de trabajo para auditar la anatomía de las citas, integrar indicadores de verificación, aplicar adaptaciones responsivas y cumplir con WCAG AA mediante el uso de elementos semánticos como `<figure>`, `<blockquote>` y `<figcaption>`, además de pautas de contraste de color y navegación por teclado. Es compatible con todos los agentes de IA y plataformas de desarrollo que generen componentes de interfaz de usuario, como Claude Code, Cursor y Codex.

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

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Sistema de Testimonios y Citas?

Propósito

El Sistema de Testimonios y Citas proporciona un marco sistemático de diseño y espaciado para testimonios cualitativos de clientes y citas de clientes. En lugar de tratar la prueba social como un añadido tardío, este sistema establece reglas estructurales, tipográficas y de atribución que maximizan la credibilidad visual y la autenticidad, garantizando al mismo tiempo la accesibilidad completa. Actúa como puente entre las reseñas generadas por usuarios (gestionadas por review-and-rating-system) y los puntos de prueba de marketing altamente seleccionados.

Casos de Uso

  • Páginas de Aterrizaje: Colocar citas destacadas de éxito de clientes para apoyar las llamadas a la acción primarias y secundarias.
  • Páginas de Detalle de Servicio/Producto: Integrar citas de clientes contextualmente relevantes que aborden directamente puntos de fricción u objeciones comunes.
  • Centros de Casos de Éxito e Historias de Éxito: Diseñar las citas destacadas principales que resumen el resultado principal o el ROI de una historia de cliente.
  • Páginas Acerca de Nosotros y de Equipo: Mostrar citas de fundadores, socios clave o empleados.
  • Material de Ventas Empresariales: Estructurar citas de alto impacto de representantes de clientes de alto perfil (VP, Director, C-suite).

Cuándo NO Usar

  • Listas de Comentarios Cuantitativos: Para reseñas generadas por usuarios de alto volumen (por ejemplo, 500 reseñas individuales de productos de 1 a 5 estrellas); use review-and-rating-system en su lugar.
  • Tablas de Datos/Cuadrículas de Atributos de Producto: Para mostrar atributos de especificaciones técnicas; use property-and-attribute-system o data-table-ui-system.
  • Contenido Principal de la Página: Los testimonios deben apoyar, no reemplazar, la información principal del producto o las propuestas de valor centrales.
  • Avisos Legales y Términos de Servicio: Para texto legalmente vinculante estricto que requiere un tratamiento formal y no narrativo.

Entradas

Para diseñar un componente de testimonio o cita eficaz, se requiere la siguiente información:

  1. Contenido de la Cita: El texto real del testimonio, idealmente refinado para que sea conciso y se centre en un único resultado o beneficio clave.
  2. Identidad del Autor: Nombre de la persona, cargo y empresa.
  3. Recursos Visuales: Foto de rostro de alta resolución, logotipo de la empresa (SVG preferido) o un enlace opcional de video/audio.
  4. Contexto de Uso: La página específica y la ubicación (por ejemplo, Hero Spotlight, cuadrícula de múltiples tarjetas, pull-quote en barra lateral).
  5. Marcadores de Confianza: Detalles verificables (por ejemplo, enlace al caso de estudio original, estado de "Cliente Verificado" o logotipo de plataforma de terceros como G2/Trustpilot).

Salidas

La aplicación de este sistema produce:

  1. Especificación de Anatomía: Posiciones de diseño relativas definidas para el texto de la cita, comillas, avatar, nombre, cargo, logotipo y marcadores de confianza.
  2. Composiciones de Diseño:
    • Spotlight Único: Un diseño de alto impacto, de ancho completo o medio ancho para ubicaciones hero.
    • Cuadrícula/Tarjetas de Testimonios: Una cuadrícula asimétrica o estructurada de tarjetas para mostrar múltiples testimonios.
    • Pull-Quote en Línea: Cita compacta, alineada al lado, integrada en contenido editorial de formato largo.
  3. Modelo de Marcado Semántico: Estructura HTML estandarizada usando <figure>, <blockquote> y <figcaption> para garantizar la interpretación correcta por parte de los lectores de pantalla.
  4. Reglas de Jerarquía Tipográfica: Pautas para peso, interlineado, estilo (limitando el abuso de cursivas) y contraste de escala entre la cita y los metadatos de atribución.

Flujo de Trabajo

1. Auditar y Estructurar la Anatomía de la Cita

Cada testimonio consta de tres zonas distintas que deben estructurarse en el DOM y la hoja de estilo:

┌─────────────────────────────────────────────────────────┐
│  [1] Contenedor de Cita (con blockquote semántico)      │
│      "Desde que implementamos SentryFlow, hemos          │
│       reducido nuestros costos de preparación            │
│       de auditoría en un 80%."                          │
├─────────────────────────────────────────────────────────┤
│  [2] Área de Atribución (con figcaption semántico)      │
│      (👤 Avatar)  Juan Pérez                            │
│                   VP de Cumplimiento en SentryCorp       │
├─────────────────────────────────────────────────────────┤
│  [3] Marcador de Confianza/Verificación                 │
│      (✓ Cliente Verificado)   [Logotipo SentryCorp]     │
└─────────────────────────────────────────────────────────┘
  • La Cita: La declaración cualitativa central. Limitar la longitud a 2–3 oraciones (aprox. 40–60 palabras).
  • La Atribución: El nombre del autor, su cargo y su organización.
  • El Ancla Visual: Una foto de rostro (avatar) o el logotipo de la marca para atraer la mirada y humanizar la cita.

2. Elegir el Patrón de Diseño Espacial

Según la densidad de información y la prioridad visual, seleccione uno de los siguientes diseños:

  • Patrón Hero Spotlight:

    • Cuándo: Páginas de aterrizaje de alto impacto o héroes de casos de estudio.
    • Diseño: Centrado o división horizontal 50/50. Tipografía masiva y de alto contraste (--text-xl o --text-xxl).
    • Uso: Exactamente un testimonio spotlight por sección de página para evitar la dilución.
  • Cuadrícula de Tarjetas de Testimonio:

    • Cuándo: Secciones dedicadas de "Prueba Social" o bloques de "Lo que dicen nuestros clientes".
    • Diseño: Cuadrícula responsiva de 2 o 3 columnas.
    • Uso: Mejor cuando se tienen de 3 a 6 citas de alta calidad. Utilizar alturas variables (o una disposición estilo Bento) para que la página se sienta orgánica.
  • Pull-Quote en Línea:

    • Cuándo: Dentro de casos de estudio de formato largo, artículos o publicaciones de blog.
    • Diseño: Márgenes sangrados, resaltado de borde izquierdo activo, flotante o incrustado dentro de columnas de párrafos.
    • Uso: Para dividir bloques de texto densos y enfatizar citas de clientes de alto valor.

3. Establecer la Jerarquía Tipográfica

Para garantizar la escaneabilidad (los usuarios escanean antes de leer):

  • Estilo de la Cita: Evite estilizar toda la cita con una fuente itálica fina y gris claro. La cursivización de bloques de texto de más de unas pocas palabras reduce la legibilidad. En su lugar, use un estilo de fuente normal con un tamaño ligeramente mayor (--font-size-lg) o un tipo de letra serif display expresiva, y ajústelo en un color neutro de alto contraste.
  • Indicación de Cita Directa: Use pseudo-elementos CSS (::before/::after) para representar comillas decorativas, o coloque una marca de cita de fondo grande y de baja opacidad detrás del bloque. No codifique literalmente marcas " en el texto para evitar que los lectores de pantalla las anuncien dos veces.
  • Contraste de la Atribución: El nombre del autor debe estar en negrita (font-weight: 600), y su rol/empresa debe estilizarse en un color secundario apagado (color: var(--text-muted)) con un tamaño de fuente más pequeño (--font-size-sm).

4. Integrar Indicadores de Confianza y Verificación

Para combatir el escepticismo de los "testimonios falsos":

  • Visuales Reales: Siempre prefiera fotos de rostro profesionales y reales sobre avatares genéricos, ilustraciones de stock o marcadores de posición vacíos.
  • Integración de Logotipo: Coloque el logotipo de la empresa del cliente junto a su cargo para aprovechar la autoridad de la marca.
  • Insignias de Verificación: Si se extrae de una fuente de terceros verificada (por ejemplo, G2, Capterra), incluya un pequeño icono de marca que indique el origen.

5. Aplicar Adaptaciones Responsivas

Configure reglas de redimensionamiento y apilamiento fluidos:

  • Colapso en Móvil: Todos los testimonios spotlight horizontales (división 50/50) deben colapsar en una sola columna vertical en viewports por debajo de 768px, colocando la foto de rostro/logotipo visual debajo del texto de la cita para mantener la declaración de valor prominente.
  • Cambios en el Diseño de la Cuadrícula: Las cuadrículas de testimonios de varias columnas deben pasar a una sola columna en móvil. No obligue a los usuarios a desplazarse horizontalmente a través de tarjetas pequeñas a menos que implemente un carrusel deslizable por toque.
  • Controles de Carrusel (si se usan): Los patrones de carrusel deslizante deben admitir gestos táctiles estándar, teclas de flecha (Izquierda/Derecha) y contener controles de pausa/reproducción muy visibles si se reproducen automáticamente (altamente desaconsejado).

6. Garantizar la Accesibilidad WCAG AA

  • Estructura Semántica: Siempre envuelva todo el componente en un elemento <figure>. Envuelva el texto de la cita en un <blockquote> y la atribución en un <figcaption> que contenga un <cite> para el cargo o la empresa del autor.
  • Contraste de Color: Pruebe todos los elementos. El texto de la cita y las atribuciones del autor deben mantener una relación de contraste de al menos 4.5:1. Los elementos decorativos (como las grandes marcas de cita de fondo) deben tener bajo contraste u ocultarse de la tecnología de asistencia con aria-hidden="true".
  • Teclado y Enfoque: Si los testimonios se encuentran en un panel con pestañas o un control deslizante, todos los indicadores de control (puntos, flechas) deben tener contornos :focus-visible muy visibles y cumplir con los mínimos de objetivo táctil.

Reglas de Decisión

Matriz de Selección de Diseño

Volumen de ContenidoUbicación ObjetivoPrioridadPatrón Recomendado
1 Cita ClaveHero / CTA PrimarioAltaHero Spotlight (Centrado/Grande)
3–6 CitasCaracterísticas / Zona de PruebaMediaCuadrícula de Tarjetas de Testimonio (Asimétrica o Bento)
6+ CitasCentro de Éxito del ClienteAlta densidadCuadrícula de Pestañas Categorizadas o Tarjetas con Carga de Más Truncadas
Texto EditorialCuerpo de Caso de Estudio / BlogContextualPull-Quote en Línea (Sangrado, borde de acento izquierdo)

Prioridad de Foto de Rostro vs. Logotipo

  • Use Fotos de Rostro Cuando: La conexión emocional humana es primordial (B2C, coaching personal, plataformas de creadores, aplicaciones individuales orientadas al consumidor).
  • Use Logotipos de Empresa Cuando: La credibilidad corporativa y la autoridad institucional son los principales impulsores (SaaS empresarial, servicios B2B, productos industriales).
  • Use Ambos Cuando: Se presente a partes interesadas B2B de alto valor donde tanto la persona compradora específica (por ejemplo, CTO) como su marca corporativa tengan un peso masivo.

Restricciones

  • Accesibilidad:
    • Marcado semántico: <figure>, <blockquote>, <figcaption>, <cite>.
    • Contraste: Mínimo 4.5:1 en todo el texto legible.
    • Lectores de pantalla: Pseudo-elementos de cita decorativos ocultos mediante CSS o aria-hidden="true".
    • Enfoque: El enfoque nunca debe quedar atrapado u oscurecido en los controles deslizantes.
  • Responsividad:
    • Restricción de ancho absoluto del contenedor móvil: Nunca exceder 100vw.
    • Objetivos táctiles para controles deslizantes: Mínimo 24x24px (WCAG 2.2 SC 2.5.8), preferido 44x44px.
    • Ajuste de texto: Los nombres o títulos largos deben ajustarse correctamente sin recortarse.
  • Jerarquía Visual:
    • El tamaño del texto de la cita debe ser al menos el 120% del tamaño del texto del cuerpo en los diseños Spotlight.
    • Mantenga las marcas de cita decorativas con una opacidad baja (por ejemplo, opacity: 0.1 a 0.2) para evitar que choquen o se superpongan con el texto.

Patrones de Falla Comunes

  • El Error de la "Pared de Cursivas": Las cursivas reducen la velocidad de lectura y aumentan la carga cognitiva. Establecer una cita de 100 palabras completamente en cursiva, con texto gris de bajo contraste, garantiza que los usuarios la omitan por completo.
  • Anonimato y Elementos de Stock: Las citas atribuidas a "Juan D." o acompañadas de fotos de stock obvias de modelos sonrientes parecen falsas y dañan gravemente la credibilidad del sitio.
  • La Trampa de lo "Sobreadornado": Hacer que las comillas CSS sean tan grandes y de alto contraste que oscurezcan las primeras o últimas letras de la cita real, o que se superpongan con el avatar del orador en viewports móviles.
  • Bloqueo de Desplazamiento Horizontal: Obligar a los usuarios móviles a deslizar horizontalmente para leer testimonios sin un indicador visual de desbordamiento (por ejemplo, tarjetas que se asoman) o indicadores de viñeta alternativos accesibles.
  • Estética sobre Accesibilidad (Sopa de Divs Semánticos): Estructurar testimonios usando anidación arbitraria de <div> sin etiquetas semánticas estándar, impidiendo que los lectores de pantalla anuncien el pasaje como una cita.

Criterios de Validación

  • Marcado Semántico: El HTML usa <figure> como envoltorio, <blockquote> para el texto y <figcaption> para los detalles de atribución.
  • Verificación de Contraste: El texto de la cita, el nombre del orador y el cargo del orador tienen una relación de contraste de al menos 4.5:1.
  • Transición Responsiva: Los diseños Spotlight se apilan verticalmente en viewports < 768px, y las cuadrículas de varias columnas colapsan a 1 columna.
  • Legibilidad Tipográfica: El texto del cuerpo de la cita se establece en un estilo de fuente normal/romana, evitando bloques largos de cursivas.
  • Sin Caracteres de Cita Codificados: Las comillas se representan mediante patrones de fondo CSS decorativos o pseudo-elementos (::before/::after) con content: "" y estilo, o se ocultan de los lectores de pantalla.
  • Espaciado Proporcional: El espaciado entre el cuerpo de la cita y el bloque de atribución utiliza una variable relativa consistente (por ejemplo, margin-top: var(--space-m)).
  • Autenticidad Visual: La atribución incluye credenciales verificables (nombre completo, cargo, empresa o logotipo) y evita gráficos de marcador de posición.

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