Communitygithub.com

coastdigitalgroup/coastai-skills

고객 사용후기와 인용문을 체계적으로 디자인하고 구조화하여 WCAG AA 접근성 표준을 준수하면서 신뢰성과 사회적 증거를 구축합니다.

coastai-skills란 무엇인가요?

이 스킬은 정성적 고객 사용후기와 인용문을 체계적으로 디자인하고 구조화하는 방법을 제공합니다. 단순한 사회적 증거 배치를 넘어, 시각적 신뢰성과 진정성을 극대화하고 완전한 접근성을 보장하는 구조적, 타이포그래픽, 인용 규칙을 수립합니다. 주로 랜딩 페이지, 서비스/제품 상세 페이지, 사례 연구 허브 등에서 사용되며, `review-and-rating-system` 스킬과 달리 큐레이션된 고품질 인용문에 초점을 맞춥니다. 스킬은 `<figure>`, `<blockquote>`, `<figcaption>`을 사용한 시맨틱 마크업, WCAG AA 대비 기준, 반응형 레이아웃 전환, 장식적 인용 부호 처리 등 접근성과 사용자 경험을 모두 고려한 체계적인 워크플로우를 제공합니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

사용후기 및 인용문 시스템 (Testimonial and Quote System)

목적

사용후기 및 인용문 시스템은 정성적 고객 사용후기와 고객 인용문을 위한 체계적인 디자인 및 공간 프레임워크를 제공합니다. 사회적 증거를 단순한 부가 요소로 취급하는 대신, 이 시스템은 완전한 접근성을 보장하면서 시각적 신뢰성과 진정성을 극대화하는 구조적, 타이포그래픽, 인용 규칙을 수립합니다. 이는 원시 사용자 생성 리뷰(review-and-rating-system에서 처리)와 고도로 큐레이션된 마케팅 증거 포인트 사이의 격차를 해소합니다.

사용 사례

  • 랜딩 페이지: 주요 및 보조 CTA(행동 유도)를 지원하기 위해 눈에 띄는 고객 성공 인용문을 배치합니다.
  • 서비스/제품 상세 페이지: 일반적인 마찰 지점이나 거부 반응을 직접적으로 다루는 상황에 맞는 고객 인용문을 통합합니다.
  • 사례 연구 허브 및 성공 사례: 고객 사례의 주요 결과나 ROI를 요약하는 히어로 풀 인용문을 디자인합니다.
  • 회사 소개 및 팀 페이지: 창립자, 주요 파트너 또는 직원의 인용문을 표시합니다.
  • 엔터프라이즈 영업 자료: 고위 고객 대표(VP, 이사, C-레벨)의 영향력 있는 인용문을 구조화합니다.

사용하지 말아야 할 경우

  • 정량적 피드백 목록: 대량의 사용자 생성 리뷰(예: 500개의 개별 1~5점 제품 리뷰)의 경우 review-and-rating-system을 사용하세요.
  • 데이터 테이블/제품 속성 그리드: 하드웨어 사양 속성 표시에는 property-and-attribute-system 또는 data-table-ui-system을 사용하세요.
  • 기본 페이지 콘텐츠: 사용후기는 기본 제품 정보나 핵심 가치 제안을 대체하는 것이 아니라 지원해야 합니다.
  • 법적 고지 및 서비스 약관: 공식적이고 비서술적인 처리가 필요한 엄격한 법적 구속력이 있는 텍스트의 경우 사용하지 마세요.

입력

효과적인 사용후기 또는 인용문 구성 요소를 디자인하려면 다음 정보가 필요합니다.

  1. 인용문 콘텐츠: 사용후기의 실제 사본으로, 간결하게 다듬고 단일 주요 결과 또는 이점에 초점을 맞추는 것이 좋습니다.
  2. 작성자 신원: 개인의 이름, 직함 및 회사.
  3. 시각 자료: 고해상도 헤드샷, 회사 로고(SVG 권장) 또는 선택적 비디오/오디오 링크.
  4. 사용 맥락: 특정 페이지 및 배치(예: 히어로 스포트라이트, 멀티 카드 그리드, 사이드바 풀 인용문).
  5. 신뢰 표시: 확인 가능한 세부 정보(예: 원본 사례 연구 링크, "확인된 고객" 상태 또는 G2/Trustpilot과 같은 타사 플랫폼 로고).

출력

이 시스템을 적용하면 다음이 생성됩니다.

  1. 구성 요소 명세: 인용문 텍스트, 인용 부호, 아바타, 이름, 직함, 로고 및 신뢰 표시에 대한 상대적 레이아웃 위치를 정의합니다.
  2. 레이아웃 구성:
    • 단일 스포트라이트: 히어로 배치를 위한 영향력이 큰 전체 너비 또는 절반 너비 레이아웃.
    • 사용후기 그리드/카드: 여러 사용후기를 표시하기 위한 비대칭 또는 구조화된 카드 그리드.
    • 인라인 풀 인용문: 장문의 에디토리얼 콘텐츠에 통합된 간결한 측면 정렬 인용문.
  3. 시맨틱 마크업 청사진: <figure>, <blockquote>, <figcaption>을 사용하여 올바른 스크린 리더 해석을 보장하는 표준화된 HTML 구조.
  4. 타이포그래피 계층 규칙: 인용문과 인용 메타데이터 간의 가중치, 줄 높이, 스타일(이탤릭 남용 제한) 및 크기 대비에 대한 지침.

워크플로우

1. 인용문 해부 구조 감사 및 구성

모든 사용후기는 DOM과 스타일 시트에서 구조화해야 하는 세 가지 개별 영역으로 구성됩니다.

┌─────────────────────────────────────────────────────────┐
│  [1] 인용문 컨테이너 (시맨틱 blockquote 포함)         │
│      "SentryFlow 배포 이후 감사 준비 오버헤드가        │
│       80% 감소했습니다."                               │
├─────────────────────────────────────────────────────────┤
│  [2] 인용 영역 (시맨틱 figcaption 포함)                │
│      (👤 아바타)  홍길동                                │
│                   SentryCorp 규정 준수 담당 부사장      │
├─────────────────────────────────────────────────────────┤
│  [3] 신뢰/확인 표시                                    │
│      (✓ 확인된 고객)   [SentryCorp 로고]                │
└─────────────────────────────────────────────────────────┘
  • 인용문: 핵심 정성적 진술. 23문장(약 4060단어)으로 길이를 제한하세요.
  • 인용 정보: 작성자의 이름, 직함 및 조직.
  • 시각적 앵커: 시선을 끌고 인용문을 인간적으로 만드는 헤드샷(아바타) 또는 브랜드 로고.

2. 공간 레이아웃 패턴 선택

정보 밀도와 시각적 중요도에 따라 다음 레이아웃 중 하나를 선택하세요.

  • 스포트라이트 히어로 패턴:

    • 사용 시기: 영향력이 큰 랜딩 페이지 또는 사례 연구 히어로.
    • 레이아웃: 중앙 정렬 또는 50/50 수평 분할. 크고 대비가 강한 타이포그래피(--text-xl 또는 --text-xxl).
    • 사용법: 희석을 방지하기 위해 페이지 섹션당 정확히 하나의 스포트라이트 사용후기.
  • 사용후기 카드 그리드:

    • 사용 시기: 전용 "사회적 증거" 섹션 또는 "고객의 말" 블록.
    • 레이아웃: 2열 또는 3열 반응형 그리드.
    • 사용법: 3~6개의 고품질 인용문이 있을 때 가장 좋습니다. 다양한 높이(또는 벤토 스타일 배열)를 활용하여 페이지를 유기적으로 만드세요.
  • 인라인 풀 인용문:

    • 사용 시기: 장문의 사례 연구, 기사 또는 블로그 게시물 내부.
    • 레이아웃: 여백 들여쓰기, 왼쪽 테두리 활성 상태 강조 표시, 단락 열 내에서 부유 또는 포함.
    • 사용법: 밀집된 텍스트 블록을 분할하고 가치 있는 고객 인용문을 강조합니다.

3. 타이포그래피 계층 수립

사용자가 읽기 전에 스캔한다는 점을 고려하여 스캔 가능성을 보장합니다.

  • 인용문 스타일: 전체 인용문을 가늘고 밝은 회색 이탤릭체로 스타일링하지 마세요. 몇 단어보다 긴 텍스트 블록을 이탤릭체로 지정하면 가독성이 떨어집니다. 대신 약간 더 큰 크기(--font-size-lg)의 일반 글꼴 스타일이나 표현적인 디스플레이 세리프 서체를 사용하고 대비가 높은 중립 색상으로 설정하세요.
  • 직접 인용 표시: CSS 가상 요소(::before/::after)를 사용하여 장식적인 인용 부호를 렌더링하거나 블록 뒤에 크고 불투명도가 낮은 배경 인용 부호를 배치하세요. 스크린 리더가 이중으로 알리는 것을 방지하기 위해 텍스트에 리터럴 " 표시를 하드코딩하지 마세요.
  • 인용 정보 대비: 작성자 이름은 굵게(font-weight: 600) 표시하고, 역할/회사는 작은 글꼴 크기(--font-size-sm)로 음소거된 보조 색상(color: var(--text-muted))으로 스타일링하세요.

4. 신뢰 및 확인 표시 통합

"가짜 사용후기" 회의론에 대응합니다.

  • 실제 시각 자료: 일반 아바타, 스톡 일러스트레이션 또는 빈 자리 표시자보다 항상 실제 전문 헤드샷을 선호하세요.
  • 로고 통합: 고객의 회사 로고를 직함 옆에 배치하여 브랜드 권위를 빌려오세요.
  • 확인 배지: 확인된 타사 소스(예: G2, Capterra)에서 가져온 경우 출처를 나타내는 작은 브랜드 아이콘을 포함하세요.

5. 반응형 적응 적용

유동적인 크기 조정 및 쌓기 규칙을 구성합니다.

  • 모바일 축소: 모든 수평(50/50 분할) 스포트라이트 사용후기는 768px 미만의 뷰포트에서 단일 수직 열로 축소되어 가치 진술을 눈에 띄게 유지하기 위해 시각적 헤드샷/로고를 인용문 텍스트 아래에 배치해야 합니다.
  • 그리드 레이아웃 전환: 다중 열 사용후기 그리드는 모바일에서 단일 열 스택으로 전환되어야 합니다. 터치 스와이프 캐러셀을 구현하지 않는 한 사용자가 작은 카드를 가로로 스크롤하도록 강요하지 마세요.
  • 캐러셀 컨트롤(사용하는 경우): 캐러셀 슬라이더 패턴은 표준 터치 제스처, 키보드 화살표(왼쪽/오른쪽)를 지원해야 하며, 자동 재생하는 경우(강력히 권장되지 않음) 매우 가시적인 일시 정지/재생 컨트롤을 포함해야 합니다.

6. WCAG AA 접근성 보장

  • 시맨틱 구조: 항상 전체 구성 요소를 <figure> 요소로 감쌉니다. 인용문 텍스트는 <blockquote>로 감싸고 인용 정보는 작성자의 직함이나 회사에 대한 <cite>를 포함하는 <figcaption>으로 감쌉니다.
  • 색상 대비: 모든 요소를 테스트하세요. 인용문 텍스트와 작성자 인용 정보는 최소 4.5:1 대비 비율을 유지해야 합니다. 장식 요소(예: 큰 배경 인용 부호)는 대비가 낮거나 aria-hidden="true"를 사용하여 보조 기술에서 숨겨야 합니다.
  • 키보드 및 포커스: 사용후기가 탭 패널이나 슬라이더에 있는 경우 모든 컨트롤 표시기(점, 화살표)는 매우 가시적인 :focus-visible 윤곽선을 가지고 터치 대상 최소 크기를 충족해야 합니다.

결정 규칙

레이아웃 선택 매트릭스

콘텐츠 볼륨대상 배치우선순위권장 패턴
1개 핵심 인용문히어로 / 기본 CTA높음스포트라이트 히어로 (중앙/대형)
3~6개 인용문기능 / 증거 영역중간사용후기 카드 그리드 (비대칭 또는 벤토)
6개 이상 인용문고객 성공 허브고밀도분류된 탭 그리드 또는 잘린 더보기 카드
에디토리얼 사본사례 연구 본문 / 블로그맥락적인라인 풀 인용문 (들여쓰기, 왼쪽 강조 테두리)

헤드샷 vs 로고 우선순위

  • 헤드샷 사용 시기: 사람 간의 감정적 연결이 가장 중요한 경우(B2C, 개인 코칭, 크리에이터 플랫폼, 개인 소비자 대상 앱).
  • 회사 로고 사용 시기: 기업 신뢰성과 기관 권위가 주요 동인인 경우(엔터프라이즈 SaaS, B2B 서비스, 산업 제품).
  • 둘 다 사용 시기: 특정 구매자 페르소나(예: CTO)와 그들의 회사 브랜드가 모두 큰 비중을 차지하는 고가치 B2B 이해 관계자에게 제안할 때.

제약 조건

  • 접근성:
    • 시맨틱 마크업: <figure>, <blockquote>, <figcaption>, <cite>.
    • 대비: 모든 읽을 수 있는 텍스트에 최소 4.5:1 대비.
    • 스크린 리더: CSS 또는 aria-hidden="true"를 통해 장식적 인용 가상 요소를 숨깁니다.
    • 포커스: 슬라이더에서 포커스가 갇히거나 가려져서는 안 됩니다.
  • 반응형:
    • 절대 모바일 컨테이너 너비 제약: 100vw를 초과하지 않음.
    • 슬라이더 컨트롤의 터치 대상: 최소 24x24px(WCAG 2.2 SC 2.5.8), 권장 44x44px.
    • 텍스트 줄 바꿈: 긴 이름이나 직함은 잘리지 않고 우아하게 줄 바꿈되어야 합니다.
  • 시각적 계층 구조:
    • 인용문 텍스트 크기는 스포트라이트 레이아웃에서 본문 텍스트 크기의 최소 120%여야 합니다.
    • 장식적 인용 부호는 텍스트와 충돌하거나 겹치는 것을 방지하기 위해 낮은 불투명도(예: opacity: 0.1 ~ 0.2)로 유지하세요.

일반적인 실패 패턴

  • "이탤릭의 벽" 실수: 이탤릭체는 읽기 속도를 늦추고 인지 부하를 증가시킵니다. 100단어 인용문을 완전히 이탤릭체, 저대비 회색 텍스트로 설정하면 사용자가 완전히 건너뛸 것입니다.
  • 익명성 및 스톡 요소: "John D."에게 귀속되거나 명백한 스톡 사진의 미소 짓는 모델이 동반된 인용문은 가짜처럼 보이며 사이트 신뢰성을 심각하게 손상시킵니다.
  • "과도한 장식" 함정: CSS 인용 부호를 너무 크고 대비가 높게 만들어 실제 인용문의 첫 글자나 마지막 글자를 가리거나 모바일 뷰포트에서 화자의 아바타와 겹치게 하는 경우.
  • 가로 스크롤 잠금: 오버플로우 시각적 표시기(예: 엿보기 카드)나 접근 가능한 대체 불릿 표시기 없이 모바일 사용자가 사용후기를 읽기 위해 가로로 스와이프하도록 강요하는 경우.
  • 미학보다 접근성(시맨틱 Div 수프): 표준 시맨틱 태그 없이 임의의 <div> 중첩을 사용하여 사용후기를 구조화하여 스크린 리더가 해당 구절을 인용문으로 알리는 것을 방지하는 경우.

검증 기준

  • 시맨틱 마크업: HTML이 <figure>를 래퍼로, <blockquote>를 텍스트로, <figcaption>을 귀속 세부 정보로 사용합니다.
  • 대비 확인: 인용문 텍스트, 화자 이름 및 화자 직함 모두 최소 4.5:1의 대비 비율을 가집니다.
  • 반응형 전환: 스포트라이트 레이아웃은 768px 미만의 뷰포트에서 수직으로 쌓이고, 다중 열 그리드는 1열로 축소됩니다.
  • 타이포그래피 가독성: 인용문 본문 텍스트는 일반/로만 글꼴 스타일로 설정되어 긴 이탤릭 블록을 피합니다.
  • 하드코딩된 인용 문자 없음: 인용 부호는 장식적 CSS 배경 패턴 또는 content: "" 및 스타일링이 있는 가상 요소(::before/::after)를 사용하여 렌더링되거나 스크린 리더에서 숨겨집니다.
  • 비례적 간격: 인용문 본문과 인용 블록 사이의 간격은 일관된 상대 변수(예: margin-top: var(--space-m))를 사용합니다.
  • 시각적 진정성: 귀속 정보에는 확인 가능한 자격 증명(전체 이름, 직함, 회사 또는 로고)이 포함되고 자리 표시자 그래픽을 피합니다.

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.

관련 스킬