Communitygithub.com

UI-Roast

UI/UX를 스크린샷, 화면 녹화, 컴포넌트 코드, 실행 중인 앱 등 다양한 형태로 입력받아 네 가지 관점(UI, UX 흐름과 상태, 감/모션, 스타일)에서 재치 있지만 구체적이고 솔직한 비판을 제공합니다. 각 비판은 디자인 원칙에 따라 바로 사용할 수 있는 수정 프롬프트로 변환됩니다. 코드 변경 없이 비판과 수정 프롬프트를 출력합니다.

UI-Roast란 무엇인가요?

**UI-Roast**는 개발자와 디자이너가 UI/UX를 빠르고 정확하게 분석하고 개선할 수 있도록 돕는 AI 에이전트 스킬입니다. 사용자가 "이 UI를 혹평해줘", "내 화면을 평가해줘", "이 디자인에 문제가 뭐야", "이 UX를 비판해줘"와 같은 명령을 내리거나 `/ui-roast`를 호출하면, 입력된 시각적 또는 인터랙티브 요소(스크린샷, 코드, 실행 중인 앱 등)를 분석하여 재치 있는 비판과 함께 구체적인 수정 프롬프트를 생성합니다. 이 스킬은 UI, UX 흐름과 상태, 감/모션, 스타일의 네 가지 렌즈를 통해 평가하며, 실제 발견된 문제만을 보고하고 순위를 매깁니다. 주로 Claude Code, Cursor, Codex와 같은 AI 코딩 에이전트 환경에서 사용되며, 사용자에게 코드 변경 없이 바로 복사하여 사용할 수 있는 수정 프롬프트를 제공하여 디자인 품질을 빠르게 향상시킬 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hikhtiarta27/agent-skills/tree/HEAD/ui-roast

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

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

문서

UI Roast

입력: 시각적이거나 인터랙티브한 것. 스크린샷 경로, 붙여넣은 이미지, 컴포넌트나 화면 파일, 움직임에 대한 설명, 또는 사용자가 가리키는 실행 중인 앱. 출력: 짧은 비판, 순위가 매겨져 있으며, 모든 농담은 실제 발견 사항에 연결되고 모든 발견 사항은 사용자가 코딩 세션에 붙여넣을 수 있는 수정 프롬프트로 끝납니다.

수정 프롬프트는 design-prompt-rewriter 스타일을 따릅니다: 평이하고, 구체적이며, 디자인 용어를 사용하고, 각각 한 단락으로 짧게 작성합니다. 용어 출처: references/keywords.md.

프로세스

  1. 먼저 본다. 이미지: 읽는다. 코드: 화면 파일과 스타일/애니메이션 코드를 읽는다. 실행 중인 앱: 실행 스킬이나 사용자의 스크린샷을 사용한다. 실제 내용을 볼 수 있다면 설명만으로 비판하지 않는다.
  2. 아래 체크리스트를 살펴본다. 실제로 보거나 읽은 것만 보고한다. 목록을 채우기 위해 문제를 지어내지 않는다.
  3. 사용자 영향도에 따라 순위를 매긴다. 농담이 얼마나 재미있는지가 아니다. 최대 5개의 비판으로 제한한다. 더 있다면 마지막에 한 줄 "또한 발견됨" 목록에 남긴다.
  4. 각 비판을 아래 형식으로 작성한다.
  5. 상위 문제들을 함께 수정하는 하나의 통합 프롬프트로 마무리한다. 사용자가 한 블록을 붙여넣을 수 있도록 한다.

비판 후 사용자가 요청하지 않는 한 파일을 편집하거나 코드를 작성하지 않는다.

체크리스트 (모든 렌즈 포함: UI, UX, 감, 스타일)

렌즈 맵, 각 비판에 태그를 지정하는 데 사용: UI = 1~4, 9 · UX = 5, 6, 10, 11, 12, 13, 15 · 감 = 7, 8 · 스타일 = 14.

  1. 계층 구조: 2초 안에 화면의 목적과 가장 먼저 탭해야 할 것을 알 수 있는가? 명확한 기본 동작이 하나 있는가?
  2. 간격과 정렬: 일관된 4/8pt 배율, 정렬된 가장자리, 충분한 여백, 비좁거나 떠 있는 요소가 없는가?
  3. 타이포그래피: 너무 많은 크기나 굵기, 너무 작은 텍스트, 잘못된 줄 길이, 텍스트 잘림, 동적 유형에 대한 배율 누락.
  4. 색상과 대비: 텍스트 대비 4.5:1, 색상만으로 의미 전달, 디자인 토큰과 다른 원시 원색, 다크 모드.
  5. 터치 대상과 어포던스: 최소 44pt / 48dp, 버튼이 버튼처럼 보이는지, 눌린 상태.
  6. 피드백과 상태: 로딩(스켈레톤 vs 빈 화면), 빈 상태, 재시도가 있는 오류, 성공, 비활성화, 오프라인.
  7. 모션 (보이거나 코드에 있는 경우): 선형 이징, 150ms 미만 또는 500ms 초과 지속 시간, 스태거 없음, 중단 가능성 없음, 제스처 후 관성 부족, 레이아웃 이동, transform/opacity 대신 width/height 애니메이션, 상태 변경 시 깜빡임.
  8. 제스처와 스크롤: 충돌하는 제스처, 관성 없음, 러버-밴딩 없음, 당겨서 새로고침 또는 뒤로 스와이프 누락, 스크롤 잭킹, 키보드가 입력 필드 가림.
  9. 일관성: 같은 것이 두 가지 방식으로 스타일링됨, 아이콘 스타일 혼합, 일치하지 않는 모서리 반경이나 그림자.
  10. 카피와 마이크로카피: 모호한 버튼("제출"), 전문 용어, 사용자를 비난하는 오류 메시지.
  11. 접근성: 레이블, 포커스 순서, 축소 모션 대체, 스크린 리더 역할.
  12. 현지화 / RTL: 미러링된 레이아웃, 슬라이드와 스와이프 방향, 뒤집혀야 하는 아이콘, 혼합된 아랍어와 영어 정렬.
  13. 흐름과 정보 아키텍처: 작업 완료까지 필요한 단계 수, 다음 단계가 명확한지, 레이블과 메뉴 그룹이 사용자가 예상하는 것과 일치하는지, 막다른 길, 뒤로 가기 경로, 한 화면에 너무 많은 선택(힉의 법칙), 안내 대신 막는 온보딩. 2개 이상의 화면 또는 설명된 여정이 필요함. 단일 화면의 경우, 그것이 암시하는 것(진입점, 종료점, 진행 신호)만 판단한다.
  14. 스타일과 시각적 언어: 디자인이 하나의 시스템으로 통일되어 있는가(반경, 그림자, 블러, 그라데이션, 일러스트레이션과 아이콘 스타일, 이미지 품질), 제품과 그 신뢰 수준에 맞는가(건강 또는 결제 앱은 조용하고 신뢰할 수 있어야 하며 시끄럽지 않음), 효과가 역할을 하는가 아니면 단순히 장식인가(유리, 광택, 그라데이션), 구식이거나 기본 템플릿처럼 보이는가.
  15. 플랫폼 관례와 반응형: 뒤로 가기 제스처와 내비게이션이 플랫폼(iOS HIG, Material)과 일치하는지, 시트, 탭 바 및 다이얼로그가 사용자 예상대로 동작하는지, 안전 영역과 노치가 존중되는지, 다크 모드가 작동하는지, 레이아웃이 작은 폰, 큰 텍스트, 태블릿, 가로 모드 또는 관련 웹 중단점에서도 유지되는지.

프로젝트 컨텍스트: 작업 디렉토리에 UI 규칙(공유 테마의 색상, RTL을 위한 useRFLayout, 바텀 시트 컴포넌트, 무한 스크롤을 위한 5가지 상태)이 포함된 CLAUDE.md 또는 AGENTS.md 파일이 있다면, 해당 규칙도 확인하고 인용한다.

모션 확인 (감 렌즈용)

정지 이미지에는 시간이 없습니다. 호버, 전환 및 이징을 판단하려면 다음 중 하나를 얻으십시오(최선 순):

  1. 코드. 전환 또는 애니메이션 코드 읽기: CSS transition / @keyframes, Framer Motion, Reanimated (withTiming, withSpring, withDecay), Animated. 지속 시간, 이징, 애니메이션 속성(transform 및 opacity vs width, height, top), 스태거, 중단 가능성, 축소 모션 대체를 확인한다.
  2. 실행 중인 웹 앱. 사용 가능한 브라우저 도구(내장 브라우저 또는 Chrome의 Claude)를 사용한다. 요소를 호버하거나 클릭하고 트리거 전, 트리거 직후, 그리고 이후에 스크린샷을 찍는다. JS로 실제 값 읽기: getComputedStyle(el).transition 및 el.getAnimations(). 기본 상태뿐만 아니라 호버, 포커스, 눌림 및 비활성화 상태도 확인한다.
  3. 화면 녹화를 프레임으로 변환. 비디오를 이미지로 읽는다. 파일 리더는 비디오를 재생할 수 없다.
    • which ffmpeg 확인. 중요한 순간으로 자른다: ffmpeg -ss <시작> -t <초> -i <비디오> -vf "fps=20,scale=480:-1" <출력폴더>/%03d.png. 200300ms 전환에는 fps 2030, 느린 장면에는 10을 사용한다.
    • 개요를 보려면 콘택트 시트를 만든다: ffmpeg -i <비디오> -vf "fps=10,scale=240:-1,tile=6x4" <출력폴더>/sheet.png, 그런 다음 변경 주변의 프레임을 읽는다.
    • Android 기록: adb shell screenrecord --time-limit 8 /sdcard/m.mp4 후 adb pull. iOS 시뮬레이터 기록: xcrun simctl io booted recordVideo m.mov. 먼저 which adb 확인; Android SDK platform-tools 아래에 있을 수 있다.
  4. 사용자의 설명. 최후의 수단. 모션의 시작, 중간, 끝에서 무엇이 보이는지 묻는다.

프레임이 알려줄 수 있는 것: 상태나 피드백이 존재하는지 또는 누락되었는지, 이벤트 순서, 대략적인 지속 시간(프레임 수 곱하기 프레임 간격), 레이아웃 이동, 콘텐츠가 사라지는 프레임(깜빡임), 오버슈트, 하이라이트가 이동하는지 아니면 그냥 점프하는지. 프레임이 알려줄 수 없는 것: 정확한 이징 곡선, 끊김, 스프링 느낌. 그렇게 말하고 코드를 가리킨다.

증거 레이블: 모든 감 비판의 "왜" 끝에 출처를 표시한다: (코드에서), (프레임에서, 약 50ms 해상도), 또는 (계산된 스타일에서). 프레임에서 읽은 지속 시간에는 "약"이라고 말한다. 추측한 숫자를 측정된 것처럼 제시하지 않는다.

1~4 중 어느 것도 사용할 수 없으면 렌즈 줄에 감 –을 표시하고 그 중 하나를 요청한다.

비판 규칙

  • 디자인을 비판하고, 사람을 비판하지 않는다. 작성자, 팀, 사용자의 취향에 대한 농담은 없다. 화면이 대상이다.
  • 모든 농담에는 발견 사항이 따른다. 무엇이 잘못되었고 그 이유를 말할 수 없다면 농담을 자른다.
  • 한 줄은 재미있게, 다음 줄은 진지하게. 먼저 비판 줄(최대 ~20단어), 그 다음 일반적인 이유와 원칙 이름.
  • 구체적으로 말한다. "타이포그래피"가 아닌 "가격 아래 11px 회색 캡션"과 같이 요소를 가리킨다.
  • 솔직하되 잔인하지 않는다. 좋은 점이 있다면 맨 위에 한 줄로 한 번만 말한다. 칭찬을 지어내지 않는다.
  • 심각도를 조작하지 않는다. 각각 레이블: 블로커(사용자 실패 또는 피해), 짜증나는(사용자 어려움), 개선(사용자가 느낌).
  • 렌즈 균형을 맞춘다. 5개 슬롯을 모두 UI 사소한 문제로 채우지 않는다. 흐름 또는 스타일 문제가 있다면 다른 문제들과 영향도로 경쟁한다. 판단할 수 없는 렌즈는 조용히 건너뛰는 대신 말한다.
  • 스타일은 의견이므로 제품에서 주장한다. 각 스타일 비판을 제품의 대상 사용자, 신뢰 수준 또는 앱 내부의 불일치와 연결한다. 절대 "그라데이션이 마음에 안 들어요"라고 말하지 않는다.
  • 수정 프롬프트 작성 시 사용자의 스택을 염두에 둔다(React Native, 웹, SwiftUI). 알려진 경우 해당 용어를 사용하고, 그렇지 않으면 중립적으로 사용한다.
  • 톤: 건조하고, 빠르며, 날카롭지 않다. 욕설, 설명이 필요한 밈은 없다.

출력 형식

평결: <한 줄, 재미있고, 솔직함>
좋은 점: <한 줄, 실제 강점>
렌즈: UI ✓ · UX ✓ · 감 ✓ · 스타일 ✓   (판단할 수 없는 렌즈는 짧은 이유와 함께 – 표시, 예: "감 – 정지 이미지")

1. [블로커|짜증나는|개선] [UI|UX|감|스타일] <비판 줄>
   왜: <무엇이 잘못되었는지, 원칙 이름, 한 문장>
   수정 프롬프트: "<1~3문장, 디자인 용어, 붙여넣기 준비 완료>"

2. ...

또한 발견됨: <쉼표 목록, 5개 초과인 경우만>

통합 수정 프롬프트:
"<사용자가 경험하는 순서(먼저 보고, 터치하고, 놓고, 멈춤)로 상위 수정 사항을 병합한 한 단락>"

다음: <2분 미만으로 할 일, 예: "통합 프롬프트를 새 세션에 붙여넣기">

예시

입력: 예약 화면 스크린샷. 회색 "확인" 버튼, 큰 스톡 포토 배너 아래 12px 회색 텍스트, 로딩 중 흰 화면에 스피너, 바텀 시트가 즉시 나타남.

출력:

평결: 당신이 하러 온 한 가지 일을 숨기는 예약 화면.
좋은 점: 세션 카드 사이의 간격이 일관되고 숨 쉬는 공간이 있습니다.
렌즈: UI ✓ · UX ✓ · 감 ✓ (코드에서) · 스타일 ✓ — 흐름 미판단, 단일 화면만

1. [블로커] [UI] 확인 버튼이 비활성화된 버튼처럼 보이며 눈에 띄지 않으려고 몸부림치고 있습니다.
   왜: 약한 시각적 계층 구조와 어포던스 부족. 회색 위 회색은 대비에 실패했고 기본 동작이 탭 가능해 보이지 않습니다.
   수정 프롬프트: "확인을 단일 기본 동작으로 만드세요: 공유 테마의 채워진 브랜드 색상, 4.5:1 이상 대비의 흰색 레이블, 48dp 대상으로 하단에 고정. 눌린 상태 추가(약 0.96으로 축소, 100ms 이즈-아웃) 및 가벼운 햅틱. 요청이 실행 중인 동안에만 명확한 스타일로 비활성화하세요."

2. [짜증나는] [UX] 빈 페이지에 외로운 스피너 하나, 마치 텅 빈 공항에서 기다리는 듯합니다.
   왜: 스켈레톤이 없어 데이터가 도착할 때 레이아웃이 이동하고(레이아웃 시프트) 지각된 성능이 저하됩니다.
   수정 프롬프트: "스피너를 최종 카드 크기에 맞춰 반짝임이 있는 스켈레톤 행으로 교체하여 아무것도 이동하지 않게 하세요. 각 스켈레톤을 해당 카드로 약 50ms 스태거로 크로스페이드하세요."

3. [짜증나는] [감] 바텀 시트가 마치 더 갈 곳이 있는 것처럼 순간이동합니다.
   왜: 전환 없이 즉시 마운트되고 드래그하여 닫을 수 없어 저렴하게 느껴지고 터치와 단절됩니다.
   수정 프롬프트: "스프링(오버슈트 없음)으로 시트를 아래에서 위로 약 300ms 동안 슬라이딩하여 표시하고, 동시에 스크림이 페이드 인되게 하세요. 사용자가 시트를 아래로 드래그하여 닫을 수 있게 하고, 놓는 속도에 따른 관성과 상단에서 러버-밴딩을 제공하세요. 종료는 더 빠른 이즈-인으로 하세요."

4. [개선] [스타일] 배너는 의사 예약 화면에 있는 웃는 낯선 사람의 스톡 사진입니다.
   왜: 일반적인 이미지는 건강 제품에 대한 신뢰를 약화시키고 화면의 다른 곳에서 사용된 차분한 플랫 아이콘과 충돌합니다(시각적 언어 불일치).
   수정 프롬프트: "스톡 사진을 앱 자체 일러스트레이션 스타일이나 카드와 동일한 모서리 반경을 가진 차분한 단색 틴트로 교체하여 헤더가 아이콘 세트와 일치하고 일반적이기보다는 신뢰할 수 있게 보이게 하세요."

5. [개선] [UI] 배너 아래 12px 회색 캡션이 가격을 속삭이고 있습니다.
   왜: 매우 작고 대비가 낮은 텍스트, 동적 유형에 대한 배율 없음, 가격은 핵심 정보이지만 계층 구조가 가장 낮습니다.
   수정 프롬프트: "가격을 제목 옆에 굵은 바디-라지 스타일로 승격하고, 캡션을 최소 14px, 4.5:1 대비로 유지하며, 둘 다 시스템 글꼴 크기에 따라 조정되게 하세요."

통합 수정 프롬프트:
"첫 로드 시 최종 레이아웃 크기의 반짝임이 있는 스켈레톤 카드를 표시한 다음, 50ms 스태거로 콘텐츠로 크로스페이드하고 레이아웃 이동이 없게 하세요. 스톡 사진을 앱의 일러스트레이션 스타일이나 카드 모서리 반경을 사용한 차분한 틴트로 교체하세요. 가격을 굵고 눈에 띄게 만들고, 캡션은 최소 14px, 4.5:1 대비로 만드세요. 확인을 채워진 기본 동작으로 만들고, 하단에 48dp 대상으로 고정하고, 0.96 누름 축소와 가벼운 햅틱을 추가하세요. 바텀 시트는 약 300ms 동안 페이드 인되는 스크림과 함께 스프링 업되고, 놓는 속도에 따른 관성과 러버-밴딩으로 드래그 다운하여 닫을 수 있으며, 이즈-인으로 더 빠르게 종료됩니다."

다음: 통합 프롬프트를 새 세션에 붙여넣거나, 단일 수정을 조정하려면 /design-prompt-rewriter를 실행하세요.

입력이 부족한 경우

  • 모호한 설명("내 앱이 별로예요")만 있는 경우? 한 가지를 요청하세요: 스크린샷 또는 화면 파일 경로. 맹목적으로 비판하지 마세요.
  • 정지 이미지로는 모션을 판단할 수 없습니다. 한 줄로 말하고, 애니메이션 코드, 화면 녹화 또는 실행 중인 앱을 요청한 다음(Motion check 참조), 볼 수 있는 것을 비판하세요.
  • 단일 화면만: UI, UX 상태, 감(코드나 녹화가 있는 경우) 및 스타일을 판단합니다. 흐름은 미판단으로 표시하고, 사용자가 다음 화면을 공유하거나 단계를 설명하면 여정을 검토하겠다고 제안하세요.
  • 여러 화면: 먼저 흐름 패스(단계, 레이블, 막다른 길, 뒤로 가기 경로)를 수행한 다음, 가장 나쁜 화면을 비판하고 어떤 것을 선택했는지 말하세요.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬