hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-uiux-design
hyper-uiux-design
VerifiedUse this skill when the user asks to design an app or web screen and wants both a picture of it and the screen as HTML before real code - a login, onboarding, dashboard, or checkout screen, or a short flow of screens, for mobile, tablet, or web, in light or dark. It reads public UI references (UIBowl, Mobbin public pages) for patterns, settles tokens, has hyper-imagegen render one mockup image per screen, then builds one standalone HTML file per screen that matches that mockup, checks the match with a browser screenshot, and saves both with handoff notes under `.hyper/uiux-design/[slug]/`. Do not use it for one image that is not a product screen, a visual-direction brief or audit, production frontend or native code, or a requirements document.
| File | Kind | Size |
|---|---|---|
| SKILL.ko.md | markdown | 25.6 KB |
| SKILL.md | skill md | 23.0 KB |
| assets/evals/hyper-uiux-design-cases.jsonl | other | 23.1 KB |
| references/html-match.ko.md | markdown | 13.5 KB |
| references/html-match.md | markdown | 12.2 KB |
| references/mockup-brief.ko.md | markdown | 11.6 KB |
| references/mockup-brief.md | markdown | 10.3 KB |
| references/reference-sites.ko.md | markdown | 8.5 KB |
| references/reference-sites.md | markdown | 7.3 KB |
| references/review-checklist.ko.md | markdown | 9.1 KB |
| references/review-checklist.md | markdown | 8.3 KB |
| references/visual-quality-recipe.ko.md | markdown | 22.5 KB |
| references/visual-quality-recipe.md | markdown | 20.9 KB |
| rules/mockup-is-evidence.ko.md | markdown | 9.0 KB |
| rules/mockup-is-evidence.md | markdown | 8.2 KB |
| rules/mockup-workflow.ko.md | markdown | 16.0 KB |
| rules/mockup-workflow.md | markdown | 14.2 KB |
| rules/reference-use.ko.md | markdown | 8.6 KB |
| rules/reference-use.md | markdown | 7.3 KB |
references/review-checklist.ko.md
View on GitHub# 검토 체크리스트
이미지가 돌아오면 검토할 때마다 이 참조를 읽습니다. 생성한 화면 시안에서 무엇을 점검하는지, 항목을 어떻게 기록하는지, 어떤 이미지가 승인 후보가 되는지를 적습니다.
## Contents
1. 기록 방법
2. 브리프 충실도
3. 가독성
4. 시각 품질
5. 생성 이미지 티
6. 접근성
7. 세트 일관성
8. 레퍼런스 독립성
9. 판정
## 1. 기록 방법
반환된 이미지를 열어서 직접 봅니다. 도구 호출이 성공했다는 것은 검토가 아닙니다. 항목마다 한 행을 기록합니다.
| 열 | 내용 |
|---|---|
| Item | 아래 id로 적은 점검 |
| Result | `pass`, `fail`, `not checkable in an image` 중 하나 |
| Label | `seen` 또는 `computed` |
| Note | 관찰한 것을 몇 단어로. `fail`이면 다음 브리프가 바꿀 것 |
`not checkable in an image` 항목은 인계에 요구사항으로 옮겨 적습니다. 통과로 세지 않습니다.
4절이 화면이 출시된 것처럼 보이는지를 결정합니다. 시안은 충실도와 가독성 항목을 모두 통과하고도 와이어프레임일 수 있고, 그것을 잡는 것이 4절입니다.
## 2. 브리프 충실도
| Id | 점검 |
|---|---|
| F1 | 브리프의 모든 영역이 밝힌 순서와 상대 크기대로 있다 |
| F2 | 단 하나의 주 동작이 밝힌 자리에 강조색으로 있다 |
| F3 | 컴포넌트가 이름을 적은 것과 같다. 여분의 탭 바, 배너, 카드, 단계가 없다 |
| F4 | 캔버스 방향과 플랫폼 프레임이 일치하고, 둘레에 기기가 없다 |
| F5 | 테마가 브리프의 토큰 열과 일치한다. 배경, 표면, 강조가 밝힌 색으로 읽힌다 |
| F6 | 보고된 픽셀 크기를 기록했고, 요청 비율과 다르면 메모에 적었다 |
| F7 | 상태 바가 밝힌 내용을 담고 있고, 선택된 내비게이션 상태가 밝힌 대로 그려져 있다 |
## 3. 가독성
| Id | 점검 |
|---|---|
| R1 | 밝힌 문자열이 한글 음절 하나하나까지 브리프와 한 글자씩 일치하고 한 번씩 나온다 |
| R2 | **모든 글자 자리에 실제 콘텐츠가 있다.** 문자열·숫자·날짜·이름이 있어야 할 자리에 막대, 블록, 회색 도형이 있으면 `fail`이고 추상이 아니다 |
| R3 | 위계가 헤드라인, 섹션, 행, 주 동작 순서로 읽힌다 |
| R4 | 글자가 겹치거나 가장자리에서 잘리거나 아이콘과 부딪히지 않는다 |
| R5 | 가장 작은 글자도 이미지 원래 크기에서 읽힌다 |
| R6 | 오른쪽 정렬 숫자가 오른쪽 끝 하나를 공유하고 등폭으로 읽힌다 |
## 4. 시각 품질
와이어프레임과 출시된 화면을 가르는 절입니다. 여기서 `fail`이 나오면 나머지가 모두 통과해도 그 화면은 되돌아갑니다.
| Id | 점검 |
|---|---|
| Q1 | 화면 유형이 기대하는 요소 수를 갖춘다([visual-quality-recipe.md](visual-quality-recipe.md) 7절). 실용 화면이 9개 미만, 콘텐츠 화면이 6개 미만이면 미달이다 |
| Q2 | 모든 금액·개수·퍼센트·날짜·이름이 있고 그럴듯하며, 앞뒤가 맞는다. 부분의 합이 총액이고 퍼센트의 합이 100이다 |
| Q3 | 가장 큰 요소가 정확히 하나이고, 헤드라인과 본문의 크기 비율이 2.5~2.8 근처다 |
| Q4 | 강조색이 화면의 약 10분의 1을 덮고, 주 동작과 활성 상태와 배지 최대 하나에만 나타난다 |
| Q5 | 아이콘이 한 스타일, 한 선 두께, 역할별 한 크기를 공유하고, 각각이 뜻하는 글리프로 읽힌다 |
| Q6 | 카드·필드·행이 브리프가 밝힌 대로 채움과 모서리를 갖고 구분선이 있어야 할 곳에 있다 |
| Q7 | 화면 유형이 기대하는 보조 디테일이 있다. 섹션 헤더의 개수, 행 제목 아래 캡션 줄, 이동 가능한 행의 값이 해당한다 |
| Q8 | 제품이 시각적이면 사진이 주된 무게이고, 평평한 자리표시자 블록이 아니라 구도가 있는 사진이다 |
| Q9 | 요소가 있어야 할 자리에 큰 빈 띠가 없고, 프레임 가장자리에 닿는 요소가 없이 가득하되 붐비지 않는다 |
| Q10 | 표면이 토큰이 밝힌 평면 색이고, 브리프가 요청하지 않았으면 텍스처·필름 그레인·노이즈가 없다 |
## 5. 생성 이미지 티
시안을 기계가 만든 것처럼 보이게 하는 표시이고, 구현자를 잘못된 방향으로 이끕니다.
| Id | 점검 |
|---|---|
| G1 | 지어낸 로고, 브랜드 이름, 마스코트, 앱 아이콘이 없다 |
| G2 | 토큰에 없는 장식이 없다. 그라데이션 번짐, 빛 번짐, 유리 흐림, 떠다니는 덩어리, 스톡 풍 일러스트가 해당한다 |
| G3 | 브리프가 요청하지 않은 요소가 없다. 신호 막대, 두 번째 탭 바, 소셜 로그인 행, 프로모션 배너가 해당한다 |
| G4 | 아이콘이 실제 컨트롤이 있을 자리에 있고, 반쯤 그려지거나 옆 글리프와 붙은 것이 없다 |
| G5 | 간격이 규칙적이다. 같은 종류의 항목 사이 간격이 같고, 좌우 여백이 하나이며, 가장자리가 정렬돼 있다 |
| G6 | 반복되는 컴포넌트의 모양이 같다. 모든 카드, 행, 입력란이 형제와 일치한다 |
| G7 | 중복된 요소가 없고 같은 이미지에 두 번째 화면이 없다 |
| G8 | 글자 흔적이 없다. 반복된 음절, 두 번 찍힌 라벨, 컨테이너를 벗어나는 문자열이 없다 |
## 6. 접근성
| Id | 점검 | 라벨 |
|---|---|---|
| A1 | 토큰의 글자와 배경 쌍이 각각 대비 최소 기준을 충족한다 | `computed` |
| A2 | 사진이나 그라데이션 위의 글자 뒤에 단색이나 스크림 층이 있다 | `seen` |
| A3 | 상태를 색만으로 전달하지 않는다. 선택된 탭에 모양이 있고 오류에 아이콘이나 글자가 있다 | `seen` |
| A4 | 컨트롤이 플랫폼의 대상 크기를 충족할 만큼 크게 그려져 있다. 정확한 크기는 인계 요구사항이다 | `not checkable in an image` |
| A5 | 포커스, 스크린 리더 이름, 키보드 순서 | `not checkable in an image` |
A1을 위해 이미지에서 색을 추출하지 않습니다. 비율은 토큰 값에서 나옵니다.
## 7. 세트 일관성
이미지마다 따로 통과한 뒤에 세트의 모든 이미지에 함께 적용합니다.
| Id | 점검 |
|---|---|
| S1 | 배경, 표면, 강조가 모든 화면에서 같아 보인다 |
| S2 | 글자 처리가 같다. 서체 성격이 하나이고 제목과 본문 크기 체계가 같다 |
| S3 | 공통 컴포넌트가 모든 화면에서 같다. 버튼 모양과 높이, 입력란 모양, 카드 모서리가 해당한다 |
| S4 | 시스템 바와 내비게이션이 같은 자리에 같은 스타일로 있다 |
| S5 | 한 화면의 라이트와 다크 버전은 색만 다르다 |
| S6 | 샘플 데이터가 세트 전체에서 맞물린다. 한 사람의 이름, 한 달, 하나의 누적 합계다 |
흔들린 화면은 흔들린 불변 요소를 다시 적어 재생성합니다. 기준 화면을 그 화면에 맞춰 바꾸지 않습니다.
## 8. 레퍼런스 독립성
| Id | 점검 |
|---|---|
| I1 | 시안이 어느 한 레퍼런스로 오인되지 않는다. 구도는 베껴 그린 것이 아니라 패턴 요약에서 만들었다 |
| I2 | 참고한 제품의 이름, 로고, 일러스트, 문구, 고유한 색·서체 조합이 나오지 않는다 |
| I3 | 브리프에 제품 이름, 레퍼런스 URL, 레퍼런스 이미지가 없다 |
## 9. 판정
- 후보: 2절부터 8절까지 `fail`이 없습니다.
- 재생성: `fail`이 하나라도 있고 그 화면에 상한 안의 브리프가 남아 있습니다. 다음 브리프는 한 가지를 바꾸며, 실패한 절 가운데 다음 순서에서 가장 앞선 것을 고릅니다. 시각 품질, 레퍼런스 독립성, 브리프 충실도, 가독성, 생성 이미지 티, 세트 일관성 순서입니다.
- 정지: 상한에 닿았습니다. 실패 항목이 가장 적은 시도를 남기고 그 항목을 나열합니다.
후보는 승인된 시안이 아닙니다. 승인은 사용자의 몫입니다.
## Sources
> Checked 2026-11-15.
| Claim | Source |
|---|---|
| 검토는 시각 품질, 생성 이미지 티, 가독성, 접근성, 일관성을 다루고 재생성 상한이 있음 | user instruction, 2026-11-15 (new skill request) |
| 콘텐츠 자리의 막대는 실패이고, 요소 수와 크기 비율 기준 | 이 패키지의 전후 비교 실험, `.hyper/uiux-design/quality-2026-11-15/`, 2026-11-15 |
| 대비는 밝힌 최소 기준에 맞춰 계산하고, 색이 상태를 전달하는 유일한 수단이 아님 | <https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html>, <https://www.w3.org/WAI/WCAG22/Understanding/use-of-color.html> |
| 반환된 이미지는 도구 호출 결과를 믿지 않고 직접 살피며, 틀린 글자는 재생성으로 고침 | this package's image-generation skill contract, restated for screens |
### Evidence grade
`LOCAL`: 항목 목록, id, 절 순서, 판정 순서는 이 패키지가 고른 검토입니다. 요소 수 범위와 2.5~2.8 비율은 공개된 표준이 아니라 다섯 화면에서 측정한 이 패키지의 기본값입니다.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |