Communitygithub.com

Testimonial- und Zitat-System

Entwerfen und strukturieren Sie qualitative Kundenreferenzen, hervorgehobene Zitate und Zitationskomponenten, um Glaubwürdigkeit, Vertrauen und sozialen Beweis in Übereinstimmung mit den WCAG-AA-Barrierefreiheitsstandards zu schaffen.

Was ist Testimonial- und Zitat-System?

Das Testimonial- und Zitat-System bietet einen systematischen Design- und räumlichen Rahmen für qualitative Kundenreferenzen und -zitate. Es behandelt soziale Beweise nicht als nachträglichen Einfall, sondern als strukturelles, typografisches und zitationsbasiertes System, das die visuelle Glaubwürdigkeit und Authentizität maximiert und gleichzeitig vollständige Barrierefreiheit gewährleistet. Das System überbrückt die Lücke zwischen rohen, nutzergenerierten Bewertungen (die vom `review-and-rating-system` behandelt werden) und hochkuratierten Marketing-Beweispunkten. Es unterstützt Plattformen wie Claude Code, Cursor und Codex und bietet klare Workflows für die Prüfung und Strukturierung von Zitatanatomien, die Auswahl räumlicher Layouts (Spotlight-Held, Testimonial-Kartenraster, Inline-Pull-Quote), die Festlegung typografischer Hierarchien und die Integration von Vertrauens- und Verifizierungsindikatoren. Das System enthält Entscheidungsregeln für die Layoutauswahl, definiert Einschränkungen für Barrierefreiheit, Reaktionsfähigkeit und visuelle Hierarchie und identifiziert häufige Fehlermuster, um typische Fallstricke zu vermeiden.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Testimonial- und Zitat-System?

Zweck

Das Testimonial- und Zitat-System bietet einen systematischen Design- und räumlichen Rahmen für qualitative Kundenreferenzen und Kunden-Zitate. Anstatt soziale Beweise als nachträglichen Einfall zu behandeln, etabliert dieses System strukturelle, typografische und zitationsbasierte Regeln, die die visuelle Glaubwürdigkeit und Authentizität maximieren und gleichzeitig vollständige Barrierefreiheit gewährleisten. Es überbrückt die Lücke zwischen rohen, nutzergenerierten Bewertungen (die vom review-and-rating-system behandelt werden) und hochkuratierten Marketing-Beweispunkten.

Anwendungsfälle

  • Landing Pages: Platzieren prominente Kunden-Erfolgszitate, um primäre und sekundäre Calls-to-Action zu unterstützen.
  • Service-/Produkt-Detailseiten: Integrieren kontextuell relevante Kunden-Zitate, die direkt auf häufige Reibungspunkte oder Einwände eingehen.
  • Case-Study-Hubs & Erfolgsgeschichten: Entwerfen der Helden-Pull-Quotes, die das Hauptergebnis oder den ROI einer Kundengeschichte zusammenfassen.
  • Über-uns- und Teamseiten: Anzeigen von Zitaten von Gründern, wichtigen Partnern oder Mitarbeitern.
  • Enterprise-Sales-Collateral: Strukturieren von wirkungsvollen Zitaten von hochkarätigen Kundenvertretern (VP, Direktor, C-Suite).

Wann NICHT zu verwenden

  • Quantitative Feedback-Listen: Für hochvolumige, nutzergenerierte Bewertungen (z. B. 500 einzelne 1-bis-5-Sterne-Produktbewertungen); stattdessen review-and-rating-system verwenden.
  • Datentabellen/Produktattributraster: Zum Anzeigen von harten Spezifikationsattributen; property-and-attribute-system oder data-table-ui-system verwenden.
  • Primärer Seiteninhalt: Testimonials sollten primäre Produktinformationen oder Kernwertversprechen unterstützen, nicht ersetzen.
  • Rechtliche Hinweise und Allgemeine Geschäftsbedingungen: Für streng rechtsverbindliche Texte, die eine formelle, nicht-narrative Behandlung erfordern.

Eingaben

Um eine effektive Testimonial- oder Zitatkomponente zu entwerfen, sind folgende Informationen erforderlich:

  1. Zitat-Inhalt: Der eigentliche Text des Testimonials, idealerweise verfeinert, um präzise und auf ein einziges Schlüsselergebnis oder einen Nutzen fokussiert zu sein.
  2. Autor-Identität: Name der Person, Berufsbezeichnung und Unternehmen.
  3. Visuelle Assets: Hochauflösendes Porträtfoto, Firmenlogo (SVG bevorzugt) oder ein optionaler Video-/Audio-Link.
  4. Nutzungskontext: Die spezifische Seite und Platzierung (z. B. Helden-Spotlight, Multi-Karten-Raster, Seitenleisten-Pull-Quote).
  5. Vertrauensmarker: Überprüfbare Details (z. B. Link zur ursprünglichen Fallstudie, Status „Verifizierter Kunde" oder Logo einer Drittanbieterplattform wie G2/Trustpilot).

Ausgaben

Die Anwendung dieses Systems erzeugt:

  1. Anatomie-Spezifikation: Definierte relative Layout-Positionen für den Zitattext, Anführungszeichen, Avatar, Name, Titel, Logo und Vertrauensmarker.
  2. Layout-Kompositionen:
    • Einzel-Spotlight: Ein wirkungsstarkes, voll- oder halbbreites Layout für Helden-Platzierungen.
    • Testimonial-Raster/Karten: Ein asymmetrisches oder strukturiertes Raster von Karten zur Anzeige mehrerer Testimonials.
    • Inline-Pull-Quote: Kompaktes, seitlich ausgerichtetes Zitat, das in redaktionelle Langform-Inhalte integriert ist.
  3. Semantischer Markup-Plan: Standardisierte HTML-Struktur unter Verwendung von <figure>, <blockquote> und <figcaption>, um eine korrekte Interpretation durch Screenreader sicherzustellen.
  4. Typografie-Hierarchie-Regeln: Richtlinien für Gewichtung, Zeilenhöhe, Stil (Einschränkung von Kursiv-Missbrauch) und Skalenkontrast zwischen Zitat und Zitationsmetadaten.

Workflow

1. Prüfen und Strukturieren der Zitatanatomie

Jedes Testimonial besteht aus drei unterschiedlichen Zonen, die im DOM und im Stylesheet strukturiert werden müssen:

┌─────────────────────────────────────────────────────────┐
│  [1] Zitat-Container (mit semantischem blockquote)      │
│      „Seit der Einführung von SentryFlow haben wir      │
│       unseren Prüfungsvorbereitungsaufwand um 80 %      │
│       reduziert."                                       │
├─────────────────────────────────────────────────────────┤
│  [2] Zitationsbereich (mit semantischem figcaption)     │
│      (👤 Avatar)  Jane Doe                              │
│                   VP of Compliance bei SentryCorp       │
├─────────────────────────────────────────────────────────┤
│  [3] Vertrauens-/Verifizierungsmarker                   │
│      (✓ Verifizierter Kunde)   [SentryCorp Logo]        │
└─────────────────────────────────────────────────────────┘
  • Das Zitat: Die Kernaussage. Begrenzen Sie die Länge auf 2–3 Sätze (ca. 40–60 Wörter).
  • Die Zitation: Der Name des Autors, die Position und die Organisation.
  • Der visuelle Anker: Ein Porträtfoto (Avatar) oder Markenlogo, um das Auge zu lenken und das Zitat zu vermenschlichen.

2. Wählen des räumlichen Layoutmusters

Basierend auf Informationsdichte und visueller Priorität wählen Sie eines der folgenden Layouts:

  • Spotlight-Helden-Muster:

    • Wann: Wirkungsstarke Landing Pages oder Case-Study-Helden.
    • Layout: Zentriert ausgerichtet oder 50/50 horizontale Teilung. Große, kontrastreiche Typografie (--text-xl oder --text-xxl).
    • Nutzung: Genau ein Spotlight-Testimonial pro Seitenabschnitt, um eine Verwässerung zu vermeiden.
  • Testimonial-Kartenraster:

    • Wann: Spezielle „Soziale Beweise"-Abschnitte oder „Was unsere Kunden sagen"-Blöcke.
    • Layout: 2-spaltiges oder 3-spaltiges responsives Raster.
    • Nutzung: Am besten, wenn Sie 3 bis 6 hochwertige Zitate haben. Verwenden Sie unterschiedliche Höhen (oder ein Bento-ähnliches Arrangement), um die Seite organisch wirken zu lassen.
  • Inline-Pull-Quote:

    • Wann: Innerhalb von Langform-Fallstudien, Artikeln oder Blogbeiträgen.
    • Layout: Eingerückte Ränder, aktive linke Randhervorhebung, schwebend oder eingebettet in Absatzspalten.
    • Nutzung: Um dichte Textblöcke aufzulockern und wertvolle Kunden-Zitate hervorzuheben.

3. Festlegen der typografischen Hierarchie

Um die Scanbarkeit zu gewährleisten (da Benutzer scannen, bevor sie lesen):

  • Zitat-Gestaltung: Vermeiden Sie es, das gesamte Zitat in einer dünnen, hellgrauen Kursivschrift zu gestalten. Das Kursivsetzen von Textblöcken, die länger als ein paar Wörter sind, verringert die Lesbarkeit. Verwenden Sie stattdessen einen regulären Schriftstil mit einer etwas größeren Größe (--font-size-lg) oder eine ausdrucksstarke Display-Serifenschrift und setzen Sie diese in einer kontrastreichen neutralen Farbe.
  • Direkte Zitatkennzeichnung: Verwenden Sie CSS-Pseudoelemente (::before/::after), um dekorative Anführungszeichen darzustellen, oder platzieren Sie ein großes, deckungsarmes Hintergrund-Anführungszeichen hinter dem Block. Hartcodierte wörtliche "-Zeichen im Text vermeiden, da Screenreader diese doppelt ansagen würden.
  • Zitationskontrast: Der Name des Autors sollte fettgedruckt sein (font-weight: 600), und seine Rolle/Firma sollte in einer gedämpften Sekundärfarbe (color: var(--text-muted)) mit einer kleineren Schriftgröße (--font-size-sm) gestaltet werden.

4. Integrieren von Vertrauens- und Verifizierungsindikatoren

Um der Skepsis gegenüber „falschen Testimonials" entgegenzuwirken:

  • Echte Bilder: Bevorzugen Sie immer echte, professionelle Porträtfotos gegenüber generischen Avataren, Stock-Illustrationen oder leeren Platzhaltern.
  • Logo-Integration: Platzieren Sie das Firmenlogo des Kunden neben seinem Titel, um Markenautorität zu entlehnen.
  • Verifizierungsabzeichen: Wenn von einer verifizierten Drittanbieterquelle (z. B. G2, Capterra) bezogen, fügen Sie ein kleines Markensymbol hinzu, das die Herkunft angibt.

5. Anwenden von responsiven Anpassungen

Konfigurieren Sie fließende Größenänderungen und Stapelregeln:

  • Mobile Zusammenklappung: Alle horizontalen (50/50-Teilung) Spotlight-Testimonials müssen auf Viewports unter 768px in eine einzige vertikale Spalte zusammenklappen, wobei das visuelle Porträtfoto/Logo unterhalb des Zitattextes platziert wird, um die Wertaussage prominent zu halten.
  • Raster-Layout-Verschiebungen: Mehrspaltige Testimonial-Raster müssen auf Mobilgeräten in einen einspaltigen Stapel übergehen. Zwingen Sie Benutzer nicht, horizontal durch winzige Karten zu scrollen, es sei denn, Sie implementieren ein Touch-Swipe-Karussell.
  • Karussell-Steuerung (falls verwendet): Karussell-Schieberegler-Muster müssen Standard-Touch-Gesten, Tastaturpfeile (Links/Rechts) unterstützen und hoch sichtbare Pause-/Wiedergabe-Steuerelemente enthalten, wenn sie automatisch abgespielt werden (stark abgeraten).

6. Sicherstellung der WCAG-AA-Barrierefreiheit

  • Semantische Struktur: Wickeln Sie die gesamte Komponente immer in ein <figure>-Element. Wickeln Sie den Zitattext in ein <blockquote> und die Zitation in ein <figcaption>, das ein <cite> für den Titel des Autors oder das Unternehmen enthält.
  • Farbkontrast: Testen Sie alle Elemente. Zitattext und Autorenzitate müssen ein Kontrastverhältnis von mindestens 4,5:1 aufweisen. Dekorative Elemente (wie große Hintergrund-Anführungszeichen) müssen einen geringen Kontrast haben oder mit `aria-hidden="true"" vor assistiven Technologien verborgen werden.
  • Tastatur und Fokus: Wenn die Testimonials in einem Tab-Panel oder Schieberegler leben, müssen alle Steuerungsindikatoren (Punkte, Pfeile) hoch sichtbare :focus-visible-Umrisse aufweisen und die Mindestanforderungen an die Berührungszielgröße erfüllen.

Entscheidungsregeln

Layout-Auswahl-Matrix

InhaltsvolumenZielplatzierungPrioritätEmpfohlenes Muster
1 SchlüsselzitatHeld / Primärer CTAHochSpotlight-Held (Zentriert/Groß)
3–6 ZitateFunktionen / BeweiszoneMittelTestimonial-Kartenraster (Asymmetrisch oder Bento)
6+ ZitateCustomer Success HubHohe DichteKategorisiertes Tab-Raster oder Gekürzte Load-More-Karten
Redaktioneller TextFallstudientext / BlogKontextuellInline-Pull-Quote (Eingerückt, linksbetonter Rand)

Porträtfoto vs. Logo-Priorität

  • Porträtfotos verwenden, wenn: Die menschliche emotionale Verbindung von größter Bedeutung ist (B2C, persönliches Coaching, Creator-Plattformen, einzelne verbraucherorientierte Apps).
  • Firmenlogos verwenden, wenn: Unternehmensglaubwürdigkeit und institutionelle Autorität die Haupttreiber sind (Enterprise SaaS, B2B-Dienstleistungen, Industrieprodukte).
  • Beide verwenden, wenn: Hochwertige B2B-Entscheidungsträger angesprochen werden, bei denen sowohl die spezifische Käuferpersönlichkeit (z. B. CTO) als auch ihre Unternehmensmarke enormes Gewicht haben.

Einschränkungen

  • Barrierefreiheit:
    • Semantisches Markup: <figure>, <blockquote>, <figcaption>, <cite>.
    • Kontrast: Mindestens 4,5:1 Kontrast für allen lesbaren Text.
    • Screenreader: Dekorative Zitat-Pseudoelemente, die über CSS oder aria-hidden="true" ausgeblendet werden.
    • Fokus: Der Fokus darf in Schiebereglern niemals eingeschlossen oder verdeckt werden.
  • Responsivität:
    • Absolute mobile Containerbreitenbeschränkung: Niemals 100vw überschreiten.
    • Berührungsziele für Schieberegler-Steuerungen: Mindestens 24x24px (WCAG 2.2 SC 2.5.8), bevorzugt 44x44px.
    • Textumbruch: Lange Namen oder Titel müssen elegant umbrechen, ohne abgeschnitten zu werden.
  • Visuelle Hierarchie:
    • Die Zitattextgröße muss in Spotlight-Layouts mindestens 120 % der Körpertextgröße betragen.
    • Halten Sie dekorative Anführungszeichen bei geringer Deckkraft (z. B. opacity: 0.1 bis 0.2), um zu verhindern, dass sie mit Text kollidieren oder ihn überlappen.

Häufige Fehlermuster

  • Der „Kursiv-Wand"-Fehler: Kursivschrift verringert die Lesegeschwindigkeit und erhöht die kognitive Belastung. Wenn Sie ein 100-Wörter-Zitat vollständig in kursiver, kontrastarmer grauer Schrift setzen, stellen Sie sicher, dass Benutzer es vollständig überspringen.
  • Anonymität und Stock-Elemente: Zitate, die „John D." zugeschrieben werden, oder die von offensichtlichen Stock-Fotos lächelnder Modelle begleitet werden, wirken unecht und schädigen die Glaubwürdigkeit der Seite erheblich.
  • Die „Über-dekorativ"-Falle: CSS-Anführungszeichen so groß und kontrastreich machen, dass sie die ersten oder letzten Buchstaben des eigentlichen Zitats verdecken oder auf mobilen Viewports mit dem Avatar des Sprechers überlappen.
  • Horizontale Scrollsperre: Mobile Benutzer zwingen, horizontal zu wischen, um Testimonials zu lesen, ohne einen visuellen Hinweis auf Überlauf (z. B. hervorlugende Karten) oder zugängliche Fallback-Punkt-Indikatoren.
  • Ästhetik über Barrierefreiheit (Semantische Div-Suppe): Testimonials mit willkürlicher <div>-Verschachtelung ohne standardmäßige semantische Tags strukturieren, wodurch Screenreader daran gehindert werden, die Passage als Zitat anzukündigen.

Validierungskriterien

  • Semantisches Markup: Das HTML verwendet <figure> als Wrapper, <blockquote> für den Text und <figcaption> für die Zitationsdetails.
  • Kontrastverifikation: Der Zitattext, der Name des Sprechers und der Titel des Sprechers haben alle ein Kontrastverhältnis von mindestens 4,5:1.
  • Responsiver Übergang: Spotlight-Layouts stapeln sich auf Viewports < 768px vertikal, und mehrspaltige Raster fallen auf 1 Spalte zusammen.
  • Typografie-Lesbarkeit: Der Zitat-Körpertext ist in einem normalen/geraden Schriftstil gesetzt, wobei lange Blöcke in Kursivschrift vermieden werden.
  • Keine hartcodierten Anführungszeichen: Anführungszeichen werden mit dekorativen CSS-Hintergrundmustern oder Pseudoelementen (::before/::after) mit content: "" und Styling dargestellt oder vor Screenreadern verborgen.
  • Proportionale Abstände: Der Abstand zwischen dem Zitat-Körper und dem Zitationsblock verwendet eine konsistente relative Variable (z. B. margin-top: var(--space-m)).
  • Visuelle Authentizität: Die Zitation enthält überprüfbare Berechtigungsnachweise (vollständiger Name, Titel, Unternehmen oder Logo) und vermeidet Platzhaltergrafiken.

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.

Verwandte Skills