Communitygithub.com

fresh-eyes

웹 제품의 UI(앱 화면, 대시보드, 설정, 표, 양식, 온보딩, 빈 상태 및 오류 상태, 그리고 제품을 판매하는 랜딩, 홈, 가격 페이지)를 사용자의 작업과 실제 콘텐츠를 바탕으로 설계하고 검토하여, 템플릿이 아닌 사려 깊은 사람이 만든 것처럼 보이게 합니다. 각 화면은 실제 콘텐츠로 구성되고, 렌더링 검증과 새로운 시각으로 확인되며, WCAG 2.2 AA를 준수하고, 기계적인 느낌을 배제합니다. 누군가 웹 앱, SaaS 제품 또는 해당 웹사이트의 화면, 페이지, 컴포넌트를 만들거나, 디자인, 개선, 검토, 감사하거나 '더 낫게' 만들고 싶을 때, 혼란스럽거나 복잡한 인터페이스를 수정하거나, 인터페이스 카피를 작성하거나, 제품의 비주얼 시스템을 구축할 때 사용하세요. 로고, 슬라이드 데크, 네이티브 모바일 앱에는 적합하지 않습니다.

fresh-eyes란 무엇인가요?

Fresh Eyes는 Claude Code와 같은 AI 에이전트가 웹 제품 UI를 디자인하고 검토할 수 있도록 돕는 스킬입니다. 이 스킬은 단순히 미적 감각을 적용하는 것을 넘어, 사용자의 실제 작업과 콘텐츠를 중심으로 한 '판단'을 강조하며, 웹 접근성(WCAG 2.2 AA)과 최신 디자인 트렌드를 참조하고, 스크립트를 통한 자동 검증을 결합합니다. 주요 기능으로는 콘텐츠 우선 접근법, 구조와 계층을 고려한 단계별 UI 구축, Playwright를 활용한 렌더링 및 접근성 자동 검사, 그리고 '새로운 시각(Fresh Eyes)' 검토를 통한 객관적인 피드백 제공이 있습니다. 이 스킬은 템플릿이나 생성형 AI의 전형적인 패턴을 피하고, 각 제품에 고유한 시그니처를 부여하는 것을 목표로 합니다. 개발자는 이 스킬을 통해 더 완성도 높고, 사용자 중심적이며, 기계적이지 않은 웹 인터페이스를 효율적으로 제작할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bernardoo-soares/fresh-eyes/tree/HEAD

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

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

문서

Fresh eyes

화면을 사용할 사람을 위해, 그 사람이 수행할 작업과 보게 될 콘텐츠로부터 화면을 디자인하세요. 판단이 앞서고, 참고 자료는 이를 날카롭게 하며, 스크립트는 이를 확인합니다. 여기서 어떤 것도 상식보다 우선하지 않습니다: 화면이 혼란스러운데 어떤 규칙도 그 이유를 설명하지 못한다면, 여전히 혼란스러운 것입니다.

<skill>는 이 스킬의 디렉토리입니다: ${CLAUDE_SKILL_DIR} (이것이 리터럴 변수로 표시되면, 이 파일이 읽힌 폴더를 사용하세요).

설정

스크립트는 Node 20 이상이 필요합니다. 스크립트가 설정이 필요하다고 말하면, 출력된 내용을 실행하세요: npm --prefix "<skill>" install 및/또는 node "<skill>/node_modules/playwright/cli.js" install chromium이며, 이는 어떤 폴더와 어떤 셸에서도 작동합니다.

스크립트를 여기서 실행할 수 없는 경우 (셸 없음, Node 없음, 브라우저 다운로드용 네트워크 없음), 중단하지 마세요: 세션에서 사용 가능한 브라우저 도구로 스크린샷을 찍거나, references/floor.md에 대해 코드를 한 줄씩 확인하고, 보고서에 렌더링 검사가 실행되지 않았다고 명시하세요. 코드만으로 수행된 시각적 검사를 보고하지 마십시오.

루프

생성 및 검토 모두에 사용하세요. 검토의 경우 먼저 references/review.md를 읽으세요: 그 단계들은 1단계부터 4단계를 대체하며, 개선된 버전은 요청자가 파일 변경을 요청하지 않는 한 원본 옆에 복사본으로 둡니다.

  1. 이해. 누가, 어떤 작업을 위해, 얼마나 자주, 어떤 기기에서, 어떤 실제 콘텐츠로 이 화면을 사용하는지 파악하세요. DESIGN-CONTEXT.md 파일이 있다면 읽으세요 (references/design-context.md). 없다면, 코드, 카피 및 요청 사항에서 추론하고 가정 사항을 기록하세요. 사용자를 먼저 인터뷰하기 위해 중단하지 마세요.
  2. 스타일링 전에 결정. 만들기 전에, 작업 노트나 답변에 간략히 기록하세요: 이 화면의 단일 목적; 시선이 가장 먼저 닿아야 할 곳; 첫 화면이 데스크톱과 휴대폰에서 주요 결정을 위해 반드시 담아야 할 것; 나머지 모든 것의 순서; 단일 기본 동작; 생략할 것. 이 카테고리의 사용자들이 이미 좋아하는 제품 두세 개를 이름과 함께 적고, 그 구조를 따르며, 이 제품이 소유한 하나의 시그니처 움직임을 적으세요 (references/modern.md). 이것이 당신의 의도이며, 6단계에서 이를 테스트합니다.
  3. 먼저 단어를 작성. 실제 데이터에서 가져온, 사용자의 언어로 된 제목, 레이블, 버튼, 빈 상태 및 오류 상태 (references/words.md). 숫자, 이름, 사용 후기, 트렌드를 절대 만들어 내지 마세요; 실제 데이터가 없으면, 보이는 플레이스홀더를 사용하세요.
  4. 순서대로 구축: 구조, 다음 계층, 그 다음 장인 정신, 프로젝트 자체의 컴포넌트와 토큰을 사용하여 (React와 shadcn/ui의 경우 references/stacks/react-shadcn.md를 읽으세요). 새로운 시각적 시스템은 node "<skill>/scripts/tokens.mjs" --accent "<hex>" --out <dir>에서 시작하며, 모든 색상 쌍을 확인합니다.
  5. 렌더링하고 살펴보기. 앱의 경우, 개발 서버를 시작하고 URL을 전달하세요. --out을 프로젝트 외부의 스크래치 폴더에 작성하세요: node "<skill>/scripts/render.mjs" <page.html | url> --out <dir> (설정이 필요하거나 실행할 수 없는 경우 설정 참조); 로그인 뒤에 있는 경우, --storage-state <file>을 추가하세요. 데스크톱 및 휴대폰, 라이트 및 다크 스크린샷을 저장하고, 측정 가능한 문제(대비, 포커스, 가로 스크롤, 작은 타겟, 경쟁하는 기본 버튼, 가장자리 줄무늬, 엠 대시)를 출력한 다음, "육안 확인" 목록을 출력합니다. 모든 문제를 수정하거나, 보고서에 하나가 남는 이유를 명시하세요; 검토는 바닥 문제, 줄무늬 및 엠 대시를 수정하고, 다른 측정된 징후들을 결과로 제시합니다. 라이트와 다크가 동일하게 보인다고 경고하면, --theme-mode class로 다시 실행하세요. 스크린샷, 특히 네 개의 -first.png를 먼저 보고, 각 "육안 확인" 항목을 살펴보세요: 빈 목록은 바닥이 깨끗하다는 뜻이지 화면이 좋다는 뜻이 아닙니다. 스트레스 콘텐츠(가장 긴 실제 이름, 가장 큰 금액, 빈 계정)로 한 번 렌더링하세요.
  6. 새로운 시각. 이 대화의 맥락이 전혀 없는 (포크가 아닌) 새로운 하위 에이전트를 시작하세요; 사용 가능한 경우 first-look 에이전트 유형을 사용하세요. 전체 프롬프트: <skill>/agents/first-look.md를 읽고 따르세요. 작업: <한 문장>. 이미지: <절대 경로, 첫 화면 우선>. 다른 파일은 열지 마세요. 당신의 의도나 구축/변경한 내용에 대해 아무것도 추가하지 마세요. 그 답변을 2단계와 비교하세요: 잘못된 "이게 뭐지", 잘못된 첫 클릭, 망설임 또는 "이상함"은 수정 사항입니다; 이미 작동하는 페이지 검토에서, 작업을 막거나 오도하지 않는 망설임은 선택적 제안이지 수정 사항이 아닙니다. 하위 에이전트 없이, 첫 화면 이미지만 보고 코드를 다시 읽기 전에 직접 first-look 질문에 답하세요.
  7. 수정하고 멈추기. 먼저 구조(레이블, 목록, 시각 자료, 재그룹화)로 각 망설임을 수정하세요; 다른 방법으로 해결할 수 없을 때만 문장을 추가하세요. 이름에 대한 의심은 그 아래 설명 줄이 아닌 더 나은 이름으로 해결되며, 메뉴 내에서는 절대 설명하지 않습니다. 5단계와 6단계를 최대 두 번 더 반복한 후, 여전히 열려 있는 문제를 명명하세요. references/modern.md의 테스트 세 가지 질문(어떤 카테고리 제품이 이것을 현재형이라고 부를지; 시그니처가 어디에 있는지; 이것이 어떤 스타트업에 속할 수 있는지)에 답하고 보고하세요.

가장 간단한 경로를 먼저. 기본 동작은 화면이 열리는 순간 작동합니다; 추가 기능(모든 행 편집, 벌크 도구)은 한 단계 아래에 위치하며, 첫 화면을 방해하지 않습니다 (references/structure.md).

완성, 비어 있지 않음. 기계적 느낌을 피하는 것이 목표가 아닙니다. 화면은 완성된 제품처럼 보여야 합니다: 사람이 행동할 단위가 각자의 컨테이너 안에 있고, 의미를 전달하는 아이콘과 작은 시각 자료가 있으며, 전체 결정이 첫 화면에 있어야 합니다. 회색 문장의 넓은 열은 또한 실패입니다 (references/hierarchy.md).

요청에 맞게 확장. 단어만 (레이블, 오류 메시지): 13단계. 컴포넌트 또는 작은 수정: 15단계. 전체 화면 또는 검토: 7단계 전체.

대부분의 화면을 결정하는 질문들

질문읽기
누가, 얼마나 자주, 어떤 작업을 위해 여기에 오는가? 얼마나 조밀해야 하는가(포스처)? 사물들은 어떻게 그룹화되고, 명명되며, 접근되는가?references/structure.md
시선이 가장 먼저 닿아야 할 곳은 어디인가? 정확히 하나의 기본 동작이 있는가? 모든 숫자에 비교 대상, 단위 및 날짜가 있는가?references/hierarchy.md
처음 사용자가 이것이 무엇인지, 자신이 어디에 있는지, 다음에 무엇을 해야 하는지 알 수 있는가?references/clarity.md
각 영역의 상태는 무엇이며, 정확히 하나의 상태인가? 누군가 잘못했을 때, 실행 취소 또는 확인을 하는가?references/states.md
단어가 사용자가 사용하는 방식으로 사물을 명명하는가? 각 오류가 해결 방법을 알려주는가?references/words.md
타입, 간격, 색상, 다크 모드 및 모션이 의도적인가?references/craft.md
완성된 것처럼 보이는가, 아니면 문서처럼 보이는가? 첫 화면이 결정을 담고 있는가?references/hierarchy.md
현재 시점처럼 보이면서 생성된 것처럼 보이지 않는가? 그것의 시그니처는 무엇인가?references/modern.md
이 화면이 어떤 제품에나 속할 수 있는가? 무엇을 제거할 수 있는가?references/tells.md
랜딩, 홈 또는 가격 페이지인가? 방문자가 무엇을 결정해야 하는가?references/landing.md
두 테마 모두에서 키보드, 대비, 리플로우, 이름, 타겟이 적절한가?references/floor.md

질문이 현재 보고 있는 화면에서 열려 있을 때만 참조를 읽고, 한 번에 모두 읽지 마세요. 각 카드에는 결정, 수행할 작업, 출처가 있는 이유, 찾아볼 것, 그리고 적용되지 않는 경우(단, 다음의 경우 제외)가 있습니다. 예외는 규칙만큼 중요합니다.

절대 변하지 않는 원칙

  • 실제 콘텐츠만: 발명된 숫자, 사람, 인용문 또는 실적 없음.
  • 접근성 바닥(references/floor.md)은 라이트와 다크에서 모두 유지됩니다.
  • 요소의 한쪽 가장자리에 색상 줄무늬를 강조로 사용하지 않으며, 카피에 엠 대시를 사용하지 않습니다 (references/tells.md).
  • 검토 시, 페이지에 있던 모든 데이터와 모든 동작을 유지하세요; 이동하거나 격하시킬 수는 있지만 제거하지는 마세요.
  • "변경 불필요"는 사용자에게 아무런 비용이 들지 않을 때 완전한 검토입니다. 취향만을 위해 절대 변경하지 마세요.

보고서

평범한 단어로, 간결하게:

  • 구축하거나 변경한 사항, 각각을 사용자의 작업 및 절약되는 시간과 연결하여 설명; 검토의 경우, 모든 변경 사항(크기, 간격, 색상 등 아주 작은 것까지)을 예를 들어 '이전, 이후, 사용자에게 절약되는 것'의 짧은 표 형태로 제시: 명명하지 않은 변경은 깨진 약속입니다;
  • 가정한 사항, 최대 세 가지 항목, 그리고 가정이 틀렸을 때 변경될 사항;
  • 확인한 사항: 수정 전후의 렌더링 문제, 그리고 새로운 시각 검토가 당신의 의도와 어떻게 비교되었는지;
  • 테스트하지 않은 것 (제스처, 실제 휴대폰, Safari, 스크린 리더), 그리고 렌더링이 실행되었는지 여부.

점수, ID 또는 규칙 번호 없음. 프로젝트에 DESIGN-CONTEXT.md가 없으면, 당신의 가정을 바탕으로 하나 작성하겠다고 제안하세요.

관련 스킬