사용 가이드로 건너뛰기
design-review작성자 Garry Tan

Design Review 스킬.

디자인 리뷰를 위한 Claude Code 및 Codex 스킬입니다. 완성된 페이지의 디자이너 시각 QA를 수행합니다: 불일치, 간격, 위계, 부주의한 패턴을 발견하고 수정합니다.

  • Design Review & Accessibility
  • 리뷰 리포트
garrytan/gstack · design-review/SKILL.mdSKILL.md
--- name: design-review description: Designer's eye QA: finds visual inconsistency, spacing issues, hierarchy problems, AI slop patterns, and slow interactions — then fixes them. (gstack) --- ## When to invoke this skill ## Confusion Protocol ## Claimed Limitations Need Evidence ## Continuous Checkpoint Mode ## Context Health (soft directive) ## Question Tuning (skip entirely if QUESTION_TUNING: false)
2026-09-14에 업스트림 파일에서 읽은 전문 및 섹션 제목 · 전체 126,647자

01 기능

Claude Code와 Codex에서 design-review 스킬이 하는 일

요약, 워크플로, 산출물을 모두 해당 스킬의 SKILL.md에서 그대로 읽어 정리한 내용입니다.

SKILL.md에서2026-09-14 읽음 · 실행 기록 아님

스킬 자체의 표현으로

실제 사이트를 대상으로 하는 디자이너 시점의 QA입니다. 사용자의 브라우저에서 페이지를 열어 375, 768, 1440 해상도로 스크린샷을 찍고, 시각적 계층 구조부터 인터랙션 상태까지 열 가지 항목을 채점한 다음, 발견한 문제를 소스에서 수정합니다. 수정 하나당 커밋 하나이며, 전후 스크린샷으로 다시 검증합니다.

깊이는 기본적으로 5-8개 페이지로 설정되며, 기능 브랜치에서 URL 없이 실행하면 diff 기반으로 전환됩니다. 결과에는 두 개의 헤드라인 점수, 가중치가 적용된 Design Score와 독립적인 AI Slop Score가 포함되며, 판단의 근거가 되는 [kicker-above-heading], [gradient-text]와 같은 30개의 명명된 감지 규칙도 함께 제공됩니다.

산출물

  • 실행 디렉터리에 작성되는 구조화된 마크다운 감사 보고서입니다.
  • 이후 실행 시 회귀 비교를 위해 작성되는 design-baseline.json 파일입니다.
  • 적용된 모든 수정 사항에 대한 전후 스크린샷 쌍입니다.
  • 사용자가 2단계 제안을 받아들일 경우, 추출된 관찰 내용을 바탕으로 작성되는 선택적 DESIGN.md입니다.
예시 프롬프트 보기 ↗

작동 방식

  1. 01
    분석 전에 먼저 반응하기

    1단계는 대상을 열어 전체 페이지 데스크톱 스크린샷을 찍은 다음, 시선이 가장 먼저 향하는 곳을 명시하는 구조화된 첫인상을 작성합니다.

  2. 02
    렌더링된 시스템 추출하기

    2단계는 페이지 내부의 폰트, 색상, 헤딩 스케일, 터치 타겟을 조사한 다음, 그 결과를 DESIGN.md로 저장할 것을 제안합니다.

  3. 03
    페이지별로 감사하기

    3단계는 페이지마다 콘솔 훅, 인터랙티브 스냅샷, 주석이 달린 스크린샷을 실행한 뒤, 세 가지 뷰포트 너비에서 이를 반복합니다.

  4. 04
    흐름을 체감하기

    4단계는 2-3개의 사용자 흐름을 따라가며 각 동작 후 스냅샷을 비교하고, 마찰과 복구에 대한 호감도 점수를 추적합니다.

  5. 05
    한 번에 하나씩 발견 사항 수정하기

    8단계는 최소한의 변경만 적용하여 단독으로 커밋한 다음, 다음 발견 사항으로 넘어가기 전에 다시 테스트합니다.

  6. 06
    두 개의 헤드라인 점수 매기기

    디자인 점수는 열 가지 항목에 대한 가중 평균이며, AI 슬롭 등급은 별도로 독립적으로 산정됩니다.

02 적합성 확인

design-review 스킬을 사용해야 하는 경우

이러한 종류의 디자인 검토가 작업일 때 Claude Code 또는 Codex에서 design-review 스킬을 사용하십시오. 아래의 적합성과 한계는 스킬 자체 파일에서 가져온 것입니다.

적합한 경우

  • 전체 사이트에 체계적인 점검이 필요한 출시 전 또는 리디자인 후 감사이며, 부분 점검이 아닙니다.
  • UI를 변경하는 기능 브랜치에서 작업 중이며, 변경된 라우트만 감사해야 하는 경우입니다.
  • 시각적 불일치를 언급하거나 실제 사이트를 다듬고 싶을 때, 이 스킬이 스스로 제안되어야 합니다.
  • 배포된 페이지가 AI가 생성한 것처럼 보이는지 판단하는 작업으로, 대부분의 개발자가 스스로 평가하기 어렵습니다.
  • 전체 점검을 할 시간이 없을 때의 빠른 상태 확인: 홈페이지와 핵심 페이지 두 개, 그리고 축약된 체크리스트입니다.

한계 인지하기

  • 빌드 전에 디자인을 검토하는 작업은 별도의 계획 모드 스킬입니다.
  • 서드파티 위젯이나 팀에서 제공해야 하는 문구처럼 소스 밖에 존재하는 문제는 수정 대상이 아니라 보류로 표시됩니다.
  • CI 설정은 건드리지 않으며 기존 테스트도 대상에서 제외됩니다. 새로 생성할 수 있는 것은 회귀 테스트 파일뿐입니다.

제공할 사항

  • 대상 URLlocalhost를 포함한 실제 주소입니다. 지정하지 않으면 스킬이 자동으로 감지하거나, main에서는 직접 물어봅니다.
  • 범위 재지정전체 투어를 원하지 않을 때 점검 범위를 하나의 페이지나 영역으로 좁힐 수 있습니다.
  • 깊이 플래그기본값은 standard이며, --quick은 세 페이지로 축소하고 --deep은 출시 전 전체 점검으로 확장합니다.
  • 존재하는 경우의 DESIGN.md리포지터리 루트의 디자인 문서를 먼저 읽어, 모든 판단이 명시된 시스템에 맞춰 보정되며 이탈에는 더 엄격한 평가가 적용됩니다.
  • 이미 로그인된 브라우저 세션감사는 사용자가 이미 보유한 세션 안에서 진행되므로, 인증이 필요한 페이지에도 별도의 로그인 절차가 필요하지 않습니다.

03 스킬 내부

design-review 스킬이 Claude Code와 Codex에 부여하는 규칙

SKILL.md가 에이전트에게 설정하는 8가지 구체적인 지시, 기본값, 제한 — 결과를 바꾸는 파일의 부분입니다.

  1. 저장소가 아니라 렌더링 결과를 판단합니다

    감사는 구현 파일을 읽지 않으며, 모든 결과는 렌더링된 페이지에서 나와야 합니다. 유일한 예외는 추출된 관찰 내용을 바탕으로 DESIGN.md를 작성하는 경우입니다.

  2. 수정 하나당 커밋 하나

    각 수정은 style(design): FINDING-NNN 형식에 짧은 설명을 덧붙인 메시지로 단독 커밋됩니다.

  3. 시작 전 깨끗한 작업 트리

    작업 트리가 깨끗하지 않으면 실행이 중단되며, 수정 커밋이 생성되기 전에 에이전트는 커밋할지, stash할지, 중단할지를 반드시 물어야 합니다.

  4. 실제 계정에 대한 작업 전 확인 요청

    로컬이 아닌 대상에서는 변경 작업마다 실행당 한 번, 정확히 무엇을 수행할지 명시한 동의 확인이 필요하며, 로그아웃 및 삭제 경로는 결코 따르지 않습니다.

  5. 자격 증명은 에이전트에 전달되지 않습니다

    사전에 로그인된 세션을 그대로 사용합니다. 비밀번호, 일회용 코드, 결제 정보, 쿠키, 토큰, localStorage는 모두 접근 대상에서 제외됩니다.

  6. 모든 발견 사항은 스크린샷으로 뒷받침됩니다

    스크린샷이 최소 하나도 없는 발견 사항은 인정되지 않으며, 이미지는 복사되어 읽혀 사용자가 인라인으로 확인할 수 있습니다.

  7. 상황이 악화되는 순간 즉시 되돌립니다

    회귀가 감지되면 즉시 git revert HEAD를 실행하며, 해당 발견 사항은 임시로 수정하지 않고 보류로 표시합니다.

  8. 30건 수정 시 중단

    루프는 5건 수정마다 단계를 높이며, 디자인 수정 위험도가 20%를 넘거나 수정 건수가 30건에 도달하면 완전히 중단합니다.

04 활용하기

Claude Code 또는 Codex에 design-review 설치

npx skills add 명령 한 번 실행 후, 에이전트에서 첫 번째 작업을 수행하고 결과 체크리스트를 확인합니다.

Claude Code, Codex 또는 귀하의 에이전트에 design-review 추가

프로젝트에서 실행합니다. 설치 프로그램이 어떤 에이전트에 추가할지 묻습니다.

Terminal
npx skills add https://github.com/garrytan/gstack --skill design-review

design-review/SKILL.md에 대한 일반적인 skills CLI 형식이며, 저장소마다 자체 경로를 문서화할 수 있습니다.

스킬에 첫 번째 디자인 리뷰 작업 부여

스킬 자체의 용어로 작성되었습니다. 대괄호 부분은 각자의 자료로 교체합니다.

Starter prompt
Audit the design of [https://myapp.com/dashboard] at standard depth. Focus on the settings page. I'm signed in as [[email protected]] in Aside. Flag the AI slop patterns and anything that breaks the spacing scale, then fix what you can.

출처: 스킬 자체의 용어로 SKILL.md에서 작성했습니다.

첫 번째 결과 확인

SKILL.md 자체가 올바른 결과의 모습으로 제시하는 내용:

  • 각 수정 후 영향을 받은 페이지를 재테스트하여 콘솔 오류 목록이 비어 있거나 기준선보다 나쁘지 않은지 확인합니다.
  • 목표 목업이 생성된 경우, 수정된 스크린샷을 목업과 비교하여 통과 또는 실패를 기록합니다.
  • 모든 수정은 분류됩니다: 재테스트에서 새로운 오류 없이 확인되면 검증됨으로 분류됩니다.
  • 9단계는 영향을 받은 페이지를 재점검하며, 최종 등급이 기준선보다 낮아진 경우 강하게 경고합니다.
  • 보고서는 검출기 건수를 처음부터 끝까지의 변화량으로 기재하거나, 검출기가 설치되지 않았거나 꺼져 있었음을 명시합니다.

OpenDesign에서는 design-review가 기본 포함되어 있습니다: Plugins → Skills에서 상단 바를 통해 선택합니다.

05 오픈 소스, 추적 가능

출처, 라이선스 및 검증

이 페이지의 사실이 어디에서 왔으며 언제 마지막으로 확인되었는지 안내합니다.

Author
Garry Tan
Repository
github.com/garrytan/gstack 브랜치 main
스킬 파일
design-review/SKILL.md 검증 시점에 기록된 콘텐츠 체크섬; 커밋 71f6048
License
MIT LICENSE에서 확인.
리포지토리 스타
132,921 이 카탈로그에 7개의 스킬을 포함하는 전체 garrytan/gstack 저장소에 대한 2026-09-14 GitHub 스냅샷입니다. design-review의 평가나 사용 횟수가 아닙니다.
OpenDesign에서 검증됨
2026-09-14 소스 파일, 경로, 라이선스 텍스트 및 별 개수가 확인되었습니다. OpenDesign 메인에 번들로 포함됨(2026-08-28 확인됨); 이 페이지에 실시간 실행이 기록되지 않았습니다.

SKILL.md 내부

  1. 설정URL, 범위, 깊이 및 인증을 파싱하고, DESIGN.md, 클린 트리, 브라우저, 테스트를 확인합니다.
  2. 모드전체, 빠른, 심층, 차이 인식 및 회귀 범위에 따라 방문할 페이지가 결정됩니다.
  3. 1단계: 첫인상전체 페이지 데스크톱 스크린샷을 촬영한 후, 구조화된 직관적 반응과 페이지 영역 테스트를 진행합니다.
  4. 2단계: 디자인 시스템 추출글꼴, 색상, 헤딩 스케일, 터치 타깃을 점검한 후 DESIGN.md 저장을 제안합니다.
  5. 3단계: 페이지별 시각 감사스냅샷, 주석 및 반응형 촬영, 트렁크 테스트를 진행한 후 10개 항목 체크리스트를 확인합니다.
  6. 4단계: 인터랙션 플로우 검토2~3개의 플로우를 진행하며 각 단계를 비교하고, 70점부터 시작하는 호감도 점수를 산정합니다.
  7. 5단계: 페이지 간 일관성페이지 전반에 걸쳐 내비게이션, 푸터, 컴포넌트, 톤, 여백 리듬을 비교합니다.
  8. 6단계: 보고서 작성각 항목을 A-F로 채점하고 보고서와 design-baseline.json을 작성합니다.
  9. 7단계: 우선순위 분류발견 사항을 영향도에 따라 정렬하고, 소스 편집으로 해결할 수 없는 항목은 보류합니다.
  10. 8단계: 수정 루프소스를 찾아 최소한의 수정을 하고, 커밋, 재테스트, 분류를 거쳐 스스로 조절합니다.
  11. 9단계: 최종 디자인 감사영향을 받은 페이지를 재점검하고 점수와 검출기 건수를 재계산하며, 회귀 발생 시 경고합니다.
  12. 10단계: 보고서전체 보고서, 프로젝트 인덱스 요약, PR 라인, 검출기 변화량을 작성합니다.
스킬 자체 설명
"디자이너의 시각으로 하는 QA: 시각적 불일치, 간격 문제, 계층 구조 문제, AI 생성 패턴, 느린 인터랙션을 찾아내고 수정합니다. (gstack)"

SKILL.md의 프론트매터 설명입니다. 전체 파일은 약 126,647자입니다. GitHub에서 전체 파일 읽기.

Design Review

실제 디자인 리뷰 작업에서 design-review를 실행합니다.

design-review 스킬은 OpenDesign에 포함되어 있습니다. 앱을 다운로드하고, Plugins → Skills에서 스킬을 선택하고, 위의 프롬프트를 붙여넣은 다음 결과 전에 계획을 읽습니다.

터미널
npx skills add https://github.com/garrytan/gstack --skill design-review