Communitygithub.com

bish-x/claude-bishx

전체 웹사이트 감사 — UX/UI 디자인, 마케팅, SEO, 접근성, 성능, 전환. cmux 브라우저를 통해 사이트를 크롤링(최대 100페이지)하고, 실행 가능한 권장 사항이 포함된 상세한 시각적 비평을 생성합니다.

claude-bishx란 무엇인가요?

Bishx-Site는 웹사이트의 UX/UI 디자인, 마케팅, SEO, 접근성, 성능, 전환, 브랜드 일관성, 정보 아키텍처를 종합적으로 감사하는 AI 에이전트 스킬입니다. cmux 브라우저를 사용하여 최대 100페이지까지 자동 크롤링하며, 각 페이지를 '사람 우선(Human-First)' 원칙에 따라 평가합니다. 이 스킬은 기술적 정확성보다는 방문자의 실제 경험과 니즈에 초점을 맞춥니다. 예를 들어, Lighthouse 점수가 100점이더라도 방문자의 의도와 감정 상태를 고려하지 못한 페이지는 실패로 간주합니다. 평가는 '누구를 위한 페이지인가', '올바른 내용인가', '표현 방식이 적절한가', '사용자는 어떻게 느끼는가', '페이지가 어떻게 반응하는가' 등 5개 레이어와 메타 레이어(여정 일관성)를 통해 이루어집니다. 또한 각 모듈은 이러한 원칙을 구체화한 것입니다. 예를 들어 UX 디자인 모듈은 방문자의 주의를 가장 필요한 곳으로 안내하는 구성을 확인하고, 전환 모듈은 방문자의 의사 결정 논리에 맞는 경로를 제공합니다. Bishx-Site는 Claude와 같은 주요 AI 플랫폼에서 사용할 수 있으며, 결과물은 디자인 비평(코드가 아님)으로, 실행 가능한 권장 사항을 상세히 제공합니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/bish-x/claude-bishx/tree/HEAD/skills/site

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

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

문서

Bishx-Site: 전체 웹사이트 감사

자율 웹사이트 감사 스킬입니다. cmux 브라우저를 통해 사이트를 크롤링(최대 100페이지)하고, UX/UI 디자인, 마케팅, SEO, 접근성, 성능, 전환, 브랜드 일관성, 정보 아키텍처를 분석합니다. 실행 가능한 권장 사항이 포함된 단일 상세 시각적 비평 문서를 생성합니다.

출력물은 코드가 아닌 디자인 비평(DESIGN CRITIQUE)입니다. 소스 코드 검사, 기술 구현 세부 사항은 포함되지 않습니다. 순수한 UX/마케팅/시각적 관점: 무엇이 잘못되었는지, 무엇으로 변경해야 하는지, 정확히 어디로 이동해야 하는지, 왜 더 나은지 — 디자이너나 다른 에이전트가 명확한 질문 없이 실행할 수 있을 정도로 상세하게 설명합니다.


기본 원칙: 사람 우선 평가(Human-First Evaluation)

이것은 전체 감사의 기초입니다. 모든 모듈, 모든 검사, 모든 발견은 이 원칙에서 비롯됩니다. 모듈별 검사(CTA 배치, 대비 비율, 제목 구조, 페이지 속도)는 이 추상적 원칙의 구체적인 사례(CONCRETE INSTANCES)이며, 독립적인 규칙이 아닙니다.

원칙

페이지의 모든 요소는 특정 순간에 특정 사람을 섬기기 위해 존재합니다. 방문자의 논리가 아닌 제작자의 논리로 페이지가 구성되었다면 — 기술적으로 완벽하더라도 그것은 실패입니다.

사이트는 Lighthouse에서 100점을 받고, 모든 WCAG 검사를 통과하며, 완벽한 SEO를 가질 수 있습니다 — 하지만 여전히 방문하는 사람에게는 실패할 수 있습니다.

다섯 개 레이어 + 메타 레이어

모든 페이지 평가는 — 모든 모듈에서 — 이 렌즈를 통과합니다:

레이어 1 — 누구를 위한 것인가(올바른 사람이 서비스를 받고 있는가?)

  • 콘텐츠가 실제로 이 페이지를 보고 있는 사람을 위해 작성되었는가?
  • 어조가 방문자의 이 시점에서의 감정 상태와 일치하는가? (결제 페이지에서 불안한 방문자 → 흥분이 아닌 안심 필요; 오류 페이지에서 좌절한 방문자 → 브랜딩이 아닌 공감 필요)
  • 페이지가 방문자가 실제로 알고 있는 것만 가정하는가? (설명 없는 전문 용어 없음, 내부 개념 참조 없음)

'첫 방문' 이상의 방문자 상태:

페이지에 있는 사람이 누구인지 식별할 때(HB1), 다음 상태를 고려하세요:

상태필요한 것실패하는 것
멀티탭 비교 (3-5개 경쟁사 사이트 열림)스캔 가능한 데이터 포인트(가격, 기능). 비교 가능한 형식. 빠른 추출.숨겨진 가격. 고유 용어. 비표준 지표.
좌절 / 오류 복구 (깨진 링크, 실패한 결제, 잘못된 검색)실패 인정. 명확한 복구 경로. 보존된 컨텍스트.일반 오류. 손실된 양식 데이터. 대안 제안 없음.
긴급 (응급 정보, 시간에 민감한)2초 이내에 하나의 사실. 상호 작용 불필요.답변을 묻는 콘텐츠 계층. 팝업. 로딩 지연.
마지못해 / 강제 (사용해야 함, 대안 없음)완료를 위한 최소 경로. 불필요한 마찰 없음.추가 단계. 업셀. 유틸리티 페이지의 마케팅 카피.
추천 (친구가 링크 보냄, 높은 신뢰, 컨텍스트 없음)홈페이지 컨텍스트 없이 독립적으로 서는 페이지.이전 탐색 가정. 설명 없는 전문 용어.
전문가 / 파워 유저 (도메인을 알고, 특정 데이터를 찾음)데이터 포인트로 바로 이동. 서문 건너뛰기. 심층 검색.강제 선형 읽기. 앵커 링크 없음. 확장 가능한 세부 정보 없음.
가격 민감형 (총 비용, 숨겨진 수수료 추적)전체 비용을 투명하게 사전 공개. 명확한 비교.설명 없이 "₩X부터". 체크아웃 시 추가되는 수수료.
상황적 제약 (밝은 햇빛, 한 손, 느린 연결, 작은 화면)우아한 저하. 높은 대비. 큰 대상. 최소 데이터 사용.밝은 회색 텍스트. 작은 버튼. 지연 로딩 없이 무거운 자산.

이것들은 별도의 검사가 아닙니다. HB1 하트비트를 위한 관점(PERSPECTIVES)입니다. 방문자를 식별할 때 고려하세요: 이들 중 어떤 상태에 있을 수 있을까? 페이지는 "이상적인" 첫 방문 데스크톱 방문자뿐만 아니라 가능한 모든 방문자 상태에서 작동해야 합니다.

레이어 2 — 무엇(올바른 콘텐츠가 표시되고 있는가?)

  • 페이지가 방문자의 논리(VISITOR'S logic)로 구성되었는가, 제작자의 논리(CREATOR'S logic)로 구성되었는가? (제작자: 기능, 부서, 연대순; 방문자: 문제, 해결책, 증거, 행동)
  • 깊이가 방문자의 준비 상태와 일치하는가? (첫 방문 → 개요; 비교 단계 → 세부 사항; 행동 준비 → 구체적인 내용)
  • 불필요한 것은 없고, 중요한 것이 빠진 것은 없는가?

레이어 3 — 방법(표현이 올바른가?)

  • 형식이 방문자의 인지 모드와 일치하는가? (스캐닝 → 제목, 아이콘, 시각적 신호; 읽기 → 전체 텍스트, 논증; 결정 → 비교 테이블, 계산기; 실행 → 산문이 아닌 단계별)
  • 정보가 방문자에게 필요한 순서로 되어 있는가?

레이어 4 — 느낌(페이지를 사용할 때의 느낌은 어떤가?)

  • 통제감: 방문자는 자신의 경험을 관리하며, 그 반대가 아님. 동의 없이 자동 재생 없음. 콘텐츠를 보여주기 전에 강제 등록 없음. 스크롤 하이재킹 없음. 흐름을 방해하는 팝업 없음. 뒤로 가기 버튼 작동. 방문자는 모든 상태를 북마크, 공유, 및 돌아갈 수 있어야 함.
  • 익숙한 패턴: 사이트는 나머지 웹과 동일하게 작동함(야콥의 법칙). 로고는 왼쪽 상단에 있고 홈으로 연결. 검색은 헤더에. 장바구니는 오른쪽 상단에. "다음" 버튼은 오른쪽에, "뒤로"는 왼쪽에. 웹 관습을 위반하는 것은 인지적 비용이 듭니다 — 모든 이탈은 정당화되어야 함.
  • 압도 방지: 페이지의 총 인지적 요구량은 관리 가능해야 함. 각 요소는 개별적으로 정당화될 수 있지만, 5개의 CTA + 3개의 배너 + 팝업 + 티커 + 채팅 위젯 + 애니메이션이 함께 = 과부하. 개별 요소에 관한 것이 아니라 주의를 경쟁하는 모든 것의 합계(SUM)에 관한 것임.

레이어 5 — 행동(사이트는 방문자에게 어떻게 반응하는가?)

  • 예측 가능성: 모든 요소는 상호 작용 시 어떤 일이 일어날지 보여줌. "다운로드"라고 레이블된 버튼은 다운로드되며, 등록 양식을 열지 않음. "가격"에 대한 링크는 가격을 보여주며, "영업팀에 문의"를 보여주지 않음. 레이블에서 결과를 예측할 수 없다면 — 그것은 실패임.
  • 투명성: 숨겨진 의제 없음. 사전 선택된 옵트인 없음. 체크아웃에서만 공개되는 수수료 없음. 신용카드가 필요한 "무료 체험" 없음. 다크 패턴 없음. 사이트는 방문자의 이익을 위해(in the visitor's interest) 작동하며, 방문자에 반대(AGAINST)해서 작동하지 않음.
  • 피드백: 모든 방문자 행동에 대한 승인이 있어야 함. 버튼 클릭 → 버튼이 시각적으로 응답. 양식 제출 → 확인 메시지 나타남. 장바구니에 추가 → 카운터 업데이트. 항목 삭제 → 실행 취소 옵션이 있는 "삭제됨" 메시지. 행동 후 침묵 = 방문자는 작동했는지 알 수 없음.
  • 용서: 사이트는 인간이 실수한다고 가정하고 — 그것을 되돌릴 수 있게 만듦. 실수로 삭제 → 복구 가능. 탭 닫힘 → 양식 데이터 저장. 잘못된 버튼 → 돌아갈 수 있음. 잘못된 입력 → 다시 시작하지 않고 편집 가능. 파괴적인 행동에 대해 실행 취소는 항상 가능해야 함.
  • 진행: 방문자는 목표를 향한 전진하는 모멘텀을 봅니다. 긴 양식 → 진행 표시줄. 다단계 프로세스 → "2/4단계". 긴 기사 → 예상 읽기 시간. 로딩 → 진행 표시기. "얼마나 더 남았나요?"에는 항상 답이 있어야 함.
  • 시간 존중: 모든 요소는 시간 비용을 정당화함. 대기를 강요하는 자동 재생 비디오 없음. 콘텐츠 전 중간 광고 없음. 로딩 후 3초 만에 나타나는 "구독" 팝업 없음. 불필요한 단계 없음. 모든 지연 또는 중단은 "내 시간이 당신의 시간보다 더 중요하다"고 말하는 것임.

메타 레이어 — 여정(페이지가 컨텍스트에서 작동하는가?)

  • 약속 = 현실: 진입점이 약속한 것(버튼 텍스트, 링크, 검색 결과)이 페이지가 제공하는 것과 일치해야 함.
  • 노력 ≤ 가치: 페이지가 주는 것보다 더 많이 요구해서는 안 됨 (2페이지 PDF를 위한 10개 필드 양식 = 위반).
  • 신뢰는 요구 사항에 비례: 요청된 약속(결제, 개인 데이터)이 클수록, 페이지는 먼저 더 많은 신뢰를 얻어야 함.
  • 다음 단계가 명확함: 방문자는 이 페이지 이후에 무엇을 해야 할지 앎.
  • 기억 가능성: 방문자가 떠난 후 — 무언가 남았는가? 방문자가 사이트를 한 문장으로 설명할 수 있는가? 경쟁사와 어떻게 다른지 기억할 수 있는가? 다시 찾을 수 있는가? 공유 링크 미리보기(OG 태그)가 페이지를 잘 나타내는가?

모듈이 이 원칙을 적용하는 방법

각 모듈은 이 원칙의 도메인별 적용(DOMAIN-SPECIFIC APPLICATION)입니다:

모듈레이어 1-3 (콘텐츠)레이어 4-5 (경험)메타 (여정)
UX 디자인구도가 방문자의 주의를 제작자가 보여주고 싶은 것이 아니라 방문자가 가장 먼저 필요로 하는 것으로 안내함압도 방지: 총 시각적 부하 관리 가능. 익숙한 레이아웃 패턴 존중.기억 가능성: 독특한 시각적 아이덴티티
마케팅 콘텐츠카피가 방문자의 언어, 깊이, 어조로 방문자의 필요를 충족시킴. 대상-콘텐츠 적합성.투명성: 조작적 카피, 허위 긴박감 없음. 예측 가능성: CTA 레이블이 결과와 일치.헤드라인의 약속 = 페이지 콘텐츠
전환경로가 방문자의 결정 논리를 따름. 각 결정 지점에서 올바른 정보.통제감: 강제 게이트 없음. 피드백: 모든 양식 동작 확인. 용서: 실수 되돌리기 가능. 진행 상황 표시.노력 ≤ 가치. 신뢰는 요구 사항에 비례.
SEO 기술페이지 구조가 올바른 방문자를 올바른 페이지로 전달함.예측 가능성: 검색 스니펫이 페이지 콘텐츠와 일치.검색 수준에서 약속 = 현실
SEO 콘텐츠방문자의 질문에 필요한 깊이와 언어로 답변함.시간 존중: 콘텐츠가 불필요하게 늘어지지 않음. 모든 단락이 그 자리를 정당화함.방문자가 배운 것을 설명할 수 있음
접근성모든 방문자가 능력에 관계없이 콘텐츠에 접근함.통제감: 키보드 작동. 피드백: 스크린 리더가 알림을 받음. 용서: 오류 설명.궁극적인 사람 우선 레이어
성능페이지가 방문자의 의도를 보존할 만큼 충분히 빠르게 로드됨.시간 존중: 불필요한 대기 없음. 진행: 로딩 표시기 제공.모멘텀이 깨지지 않을 만큼 빠름
정보 아키텍처탐색이 조직도가 아닌 방문자의 정신 모델을 따름.익숙한 패턴: 표준 탐색 배치. 예측 가능성: 링크 레이블이 대상과 일치.방문자는 항상 자신이 어디에 있고 어디로 가야 하는지 앎
브랜드 일관성일관된 경험 = 방문자가 "이게 같은 사이트인가?"에 집중하지 않고 콘텐츠에 집중함.사이트 내에서 익숙함: 모든 곳에서 동일한 패턴.일관성을 통한 신뢰

에이전트를 위한 사용 방법

모든 페이지의 모든 요소를 평가할 때:

  1. 첫째 — 이 페이지를 보고 있는 사람이 누구이며 그들이 지금 무엇을 필요로 하는지 식별하세요
  2. 그런 다음 — 요소가 그 필요를 충족시키는지 확인하세요 (레이어 1-2-3)
  3. 그런 다음 — 요소가 여정 컨텍스트에서 작동하는지 확인하세요 (메타 레이어)
  4. 그런 다음에만 — 모듈의 특정 기술적 검사를 적용하세요

기술적 검사가 통과(PASSES)되었지만 원칙이 위반(VIOLATED)된 경우 — 그것은 발견 사항입니다. 기술적 검사가 실패(FAILS)했지만 원칙이 충족(SATISFIED)된 경우 — 주목하되 우선순위를 낮추세요.

원칙은 기술적 검사를 대체하지 않습니다. 그것은 기술적 검사에 우선순위를 부여하고 맥락을 제공합니다(PRIORITIZES and CONTEXTUALIZES).

도구 키트, 체크리스트 아님

모듈별 검사(FAIL/WARN 임계값)는 일반적인 패턴의 도구 키트(TOOLKIT)입니다 — 모든 페이지에서 기계적으로 실행해야 하는 필수 체크리스트가 아닙니다.

임계값 작동 방식:

  • 기본 원칙(Foundational Principle)이 항상 PRIMARY 가이드입니다.
  • 임계값(예: ">3 CTA = WARN")은 놓칠 수 있는 것을 잡아주는 도우미(HELPERS)입니다.
  • 임계값과 원칙이 일치(AGREE)하면 — 좋습니다, 발견 사항을 보고하세요.
  • 그들이 불일치(DISAGREE)하면 — 원칙이 우선합니다. 불일치를 간략히 설명하세요.
  • 오버라이드는 예상됩니다: 일반적인 감사에서 임계값 트리거의 약 15-20%는 무시하거나 낮추어야 하는 오탐(false positives)입니다. 0개의 임계값을 오버라이드한다면, 기계적으로 작업하고 있는 것입니다 — 그것이 실제 실패입니다.
  • 원칙이 달리 말할 때 오버라이드하지 않는 것은 잘못 오버라이드하는 것보다 더 나쁩니다.

목적 기반 평가: 모듈의 각 검사는 기계적으로 확인하는 방법(HOW)이 아닌 평가할 내용(WHAT)을 설명합니다.

  • "페이지의 행동 촉구가 명확한지 확인" — "버튼을 세고 3과 비교"가 아님.
  • "테이블이 사용 가능한지 확인" — "각 셀이 최소 대비를 가지고 있는지 확인"이 아님.
  • "양식이 접근하기 쉬운지 확인" — "필드를 세고 5와 비교"가 아님.

특정 숫자/임계값은 일반적으로 문제를 나타내는 예시(EXAMPLES)입니다. 에이전트는 원칙을 가이드로 사용하여 실제 페이지에 판단을 적용합니다.

예시: 4개의 CTA 버튼이 있는 가격 페이지는 각각이 다른 요금제를 명확하게 제공한다면 통과(PASS)할 수 있습니다. 1개의 CTA 버튼이 있는 가격 페이지는 보이지 않거나 오해의 소지가 있다면 실패(FAIL)할 수 있습니다. CTA 수는 지표입니다. 원칙("다음 단계가 명확한가?")은 테스트입니다.

알 수 없는 요소 프로토콜

에이전트가 모듈 도구 키트에 포함되지 않은 요소, 위젯 또는 패턴을 만났을 때:

건너뛰지 마세요. 기본 원칙을 직접 적용하세요:

  1. 식별: 이 요소는 무엇인가? (3D 투어, 모기지 계산기, 대화형 지도, 사용자 정의 위젯, 임베디드 앱, 데이터 시각화 등)
  2. 목적: 방문자를 위해 무엇을 해야 하는가?
  3. 5개 레이어를 통해 평가:
    • 레이어 1: 올바른 대상인가? 올바른 어조인가?
    • 레이어 2: 올바른 깊이로 올바른 콘텐츠를 포함하는가?
    • 레이어 3: 형식이 방문자의 모드에 적절한가?
    • 레이어 4: 방문자가 통제감을 느끼는가? 압도적인가? 충분히 익숙한가?
    • 레이어 5: 예측 가능한가? 투명한가? 피드백을 제공하는가? 용서하는가?
  4. 메타: 여정에 맞는가? 약속 = 현실인가?
  5. 문제가 발견되면 — 표준 템플릿을 사용하여 발견 사항을 생성하세요. [알 수 없는 요소]로 태그하여 SYNTHESIZE가 새로운 발견 사항을 추적할 수 있도록 하세요.

중요성 게이트: 이 프로토콜은 이 페이지에서 방문자의 목표에 의미 있는 요소에만 적용하세요. 장식/미적 요소는 건너뛰세요. 속성 페이지의 모기지 계산기 = 중요. 장식 애니메이션 = 건너뛰기.

원칙 하트비트 프로토콜

에이전트는 실행 중에 원칙을 잊을 것입니다. 이 프로토콜은 이를 방지합니다.

필수 체크포인트 — 에이전트는 반드시 이러한 정확한 순간에 멈추고 원칙을 다시 적용해야 합니다:

하트비트 1 — 각 페이지 분석을 시작하기 전:

[HB1] 페이지: {url} | 복잡성: {simple/standard/complex}
방문자: {who} | 필요: {what} | 상태: {emotion}
방문자 마음(5초): {첫 방문자로서의 첫인상 — 무엇이...

...

[번역을 위해 잘림]

관련 스킬