Communitygithub.com

husheng-web/personal-website-skills

포트폴리오 웹사이트 경로를 승인된 시각적 참조물과 데스크탑 및 모바일 크기에서 비교한 후, 증거 기반의 시각적 결함과 수정 방안을 보고합니다.

personal-website-skills란 무엇인가요?

이 스킬은 개발자가 포트폴리오 웹사이트의 특정 경로를 승인된 시각적 참조물(예: 디자인 시안, 스크린샷)과 데스크탑 및 모바일 뷰포트 크기에서 비교하여 시각적 결함을 체계적으로 발견하고 보고하도록 돕습니다. 코드 리뷰만으로는 놓치기 쉬운 레이아웃, 타이포그래피, 색상, 반응형 동작 등의 문제를 시각적으로 검증하는 데 중점을 둡니다. Claude Code, Cursor, Codex 등 AI 에이전트와 함께 사용할 수 있으며, SKILL.md 문서에 따라 설정, 비교, 보고의 세 단계로 진행됩니다. 최종적으로 우선순위(P1~P3)에 따라 분류된 증거 기반의 결함 목록과 최소한의 수정 방안을 제시하여 개발자가 효율적으로 문제를 해결할 수 있도록 지원합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/husheng-web/personal-website-skills/tree/HEAD/skills/portfolio-visual-qa

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

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

문서

포트폴리오 시각적 QA (Visual QA)

코드 리뷰만이 아닌 시각적 검증을 수행합니다.

설정

참조물, 경로, UI 상태, 뷰포트 크기, 그리고 작업이 구현을 허용하는지 여부를 확인합니다. 사이트를 설정된 명령어로 시작하고 요청된 크기에서 렌더링된 결과를 검사합니다. 요청에 특정 크기가 명시되지 않은 경우 모바일 크기 하나를 포함시킵니다.

비교

계층 구조, 타이포그래피 및 줄바꿈, 간격 및 기하학, 색상 및 대비, 에셋 충실도, 반응형 자르기/오버플로우, 그리고 상호작용 상태를 평가합니다. 동작 또는 탐색이 관련된 경우 키보드 접근성과 축소 모션 동작을 확인합니다.

보고

먼저 증거와 한계점을 명시합니다. 발견 사항을 우선순위별로 그룹화합니다.:

  • P1: 의도된 계층 구조, 접근성 또는 핵심 작업을 차단합니다.
  • P2: 중요한 시각적 또는 반응형 불일치입니다.
  • P3: 나중에 처리할 수 있는 세부 사항입니다.

각 발견 사항에 대해 영향을 받는 경로/상태, 관찰된 동작, 가능한 원인, 그리고 가장 작은 신뢰할 수 있는 수정 방안을 명시합니다. 영향을 받는 뷰포트에서 수정 사항을 재테스트합니다. 브라우저 캡처 또는 대상 참조물을 사용할 수 없을 때 시각적 검사가 통과했다고 주장하지 마십시오.

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

관련 스킬