hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-design
hyper-design
Verified[Hyper] Use this skill when the user wants interface design work that must not look AI-generated - designing a new screen, page, or component, restyling an existing UI, building faux product UI for a hero, feature card, or demo, or auditing, cleaning, or verifying generic template patterns in an interface - driven by a written design direction, a numeric craft floor, static detection, and evidence-separated review, with briefs and reports saved under `.hyper/design/[slug]/`. Do not use it for backend or data work with no visual surface, accessibility-only or performance-only QA, brand strategy with no interface, or a reusable skill folder.
rules/design-direction.ko.md
View on GitHub# 디자인 방향
`design`, `restyle`, `mockup`, `brief-only`에서 첫 token이나 마크업 전에 읽는다. 이 파일은 브리프, 방문 모드, 참조, 토큰 계획, 버린 대안, 수렴 방지 검사를 소유한다. 결과는 `assets/design-brief-template.ko.md`를 써서 `.hyper/design/<slug>/brief.md`로 저장한다.
## 1. 방향이 먼저인 이유
"예쁜 페이지"를 요청받은 모델은 자신이 본 가장 흔한 페이지를 표집한다. "모던하고 깔끔하고 프리미엄한" 같은 형용사는 그 분포의 한 영역을 설명할 뿐 한 점을 가리키지 않는다. 기본값 하나를 금지하면 출력은 다음 기본값으로 옮겨 간다. 해법은 마크업 전에 글로 정하는 것이다. 누구를 위한 것인지, 무엇을 해야 하는지, 구체적인 무언가를 참조해 어떻게 보이는지, 어떤 뻔한 선택지를 버렸는지.
## 2. 브리프 문장
문장 하나를 쓰고 미지수를 옆에 나열한다.
> 이 [표면]은 [대상 사용자]가 [상황]에서 [작업]을 하도록 돕는다. [확인된 정체성, 데이터, 동작]을 유지한다. [미지수]는 검증되지 않았다.
입력은 `references/context-signals.md`의 순서로 읽는다. 겉모습에 관한 사용자 자신의 말이 이 파일의 모든 것보다 우선한다.
## 3. 방문 모드
제품이 아니라 표면에서 하나를 고른다.
| 모드 | 방문자가 원하는 것 | 야심이 드러나는 방식 |
|---|---|---|
| Persuade | 행동하도록 설득되는 것(랜딩, 요금제, 가입) | 기억에 남는 아이디어 하나, 강한 위계, 실제 근거 |
| Operate | 반복해서 작업을 끝내는 것(대시보드, 설정, 관리자, 폼) | 정밀함, 데이터에 맞는 밀도, 익숙한 패턴, 빠른 피드백 |
| Read | 내용을 이해하는 것(문서, 글, 보고서) | 측정, 리듬, 타이포 위계, 조용한 크롬 |
| Experience | 즐기거나 탐색하는 것(포트폴리오, 캠페인, 미디어) | 의도해 만든 순간, 원인이 있는 모션이나 이미지 |
애플리케이션 UI에서는 `Operate`를 기본값으로 둔다. `Operate` 화면을 "표현적으로" 만든 것은 야심이 아니라 실패다.
## 4. 참조
방향을 지탱하는 구체적 참조 하나를 이름과 함께 밝히고, 무엇을 가져올지 적는다.
- 좋음: "인쇄된 기차 시간표: 고정폭 숫자, 머리카락 같은 실선, 지연에만 쓰는 신호색 하나"
- 좋음: "제품 자체의 온보딩 일러스트 스타일과 이미 쓰는 6px 반경"
- 약함: "미니멀하고 모던함", "Linear처럼", "애플처럼"
`restyle`에서 제품의 기존 시스템은 언제나 첫 번째 참조다. 유명 제품의 겉모습을 베끼는 것은 방향이 아니다. 다른 중간값에 도착할 뿐이다. 제3자 브랜드의 로고, 표시, 독점 자산은 절대 재현하지 않는다.
## 5. 토큰 계획
방향을 마크업 전에 프로젝트의 스타일링 시스템 안에서 이름 붙은 값으로 바꾼다. 최소 세트는 다음과 같다.
| 묶음 | 정할 것 |
|---|---|
| 색 | 중립 램프(canvas, surface, raised, line, text strong/default/muted), on 색을 붙인 accent 하나, 상태 색. 각 텍스트 조합의 대비 |
| 타이포 | 고정된 역할과 참조에 붙인 이유가 있는 서체 하나 또는 둘. 크기, 행간, 굵기, 자간을 붙인 역할 스케일(display, heading 단계, body, small, label) |
| 간격 | 스케일 하나(4px 기반 또는 플랫폼 자체). 섹션, 묶음, 요소 간격 |
| 모양 | 요소 크기에 붙인 반경 스케일. 중첩 반경 = 바깥 반경 - 패딩 |
| 깊이 | 고도 단계는 최대 몇 개. 테두리 또는 그림자 중 하나를 골라 한 번만 |
| 모션 | 용도별 지속 시간 사다리와 easing. 절대 움직이지 않는 것 |
| 아이콘 | 세트 하나, 선 굵기 하나, 맥락별 크기 하나 |
`restyle`에서는 기존 token을 먼저 대응시키고, 표면 전체를 움직이는 가장 적은 token만 바꾼다. 컴포넌트 라이브러리 프로젝트에서는 컴포넌트를 건드리기 전에 라이브러리 token을 고친다. 정석 수치가 숫자를 정하는 곳에서는 값을 `rules/craft-floor.md`에서 가져온다.
## 6. 레이아웃 계획과 상태
- 모든 섹션에 역할을 준다. hook, explain, prove, explore, convert, navigate, operate 중 하나다. 역할이 없는 섹션은 제거한다.
- 내용을 중요도 순으로 배열한다. 위계는 상자와 색보다 크기, 굵기, 간격, 위치에서 먼저 나오게 한다.
- 표면이 가진 상태와 각 상태의 모양을 나열한다. default, hover, focus-visible, active, disabled, loading, empty, error, success, offline이 해당한다. 정상 경로만 보여 주는 디자인은 끝난 것이 아니다.
- 실제 콘텐츠나 분명히 표시한 placeholder를 쓴다. 근거를 지어내지 않는다.
## 7. 버린 대안
고려했다가 버린 뻔한 선택지를 이유와 함께 최소 하나 기록한다("특징 카드 세 개 행, 버림: 제품에 주요 특징 하나와 부수 특징 둘이 있다"). 버린 선택지가 없는 브리프는 결정을 내리지 않은 것이다.
## 8. 수렴 방지 검사
만들기 전에 `brief.md`에서 답한다.
1. 같은 계획이 이 분류의 다른 제품에도 나올까? 그렇다면 제품이 다른 지점에서 계획을 바꾼다.
2. 여기 어떤 선택이 알려진 기본값인가(`references/anti-pattern-catalog.md`를 본다. 크림색 배경에 기울인 세리프 display, 탈출구로서의 벤토 그리드, "안전한" accent로서의 에메랄드 같은 2차 물결 기본값을 포함한다)? 그렇다면 브리프나 참조에서 온 이유가 있을 때만 유지한다.
3. 모든 표현 요소(그라디언트, 글로우, 모션, 일러스트)에 브리프에서 온 역할이 있는가? 없으면 제거한다.
기본값을 제거해도 빈약하거나 생기 없는 결과가 나오면 안 된다. 피드백 모션, 실제 상태, 위계는 살려 둔다.
## 9. 한국어 인터페이스
제품 언어가 한국어이면 계획은 `rules/craft-floor.md` §6의 한글 폰트 스택, 본문 크기, 행간, 줄바꿈 규칙도 밝힌다.
## 10. 디자인 읽기, 다이얼, 레버
기본값을 걷어내면 빈자리가 남는다. 생동감은 의도해서 더한다. 마크업 전에 `brief.md`에 디자인 읽기(Design Read) 줄 하나를 쓴다.
> [화면 종류]를 [대상 사용자]를 위해 [시각 언어] 방식으로 읽는다. 방문 모드 [모드], 다이얼 ENERGY [1-3] / RHYTHM [1-3] / MOTION [1-3].
| 다이얼 | 1 (차분함) | 2 (균형) | 3 (과감함) | 답하는 질문 |
|---|---|---|---|---|
| ENERGY | 조용한 공공 서비스나 도구 화면 | 자신감 있는 제품 마케팅 | 포트폴리오나 캠페인 | 디자인이 얼마나 강하게 인사하는가? |
| RHYTHM | 획일적이고 예측 가능한 그리드 | 일관되되 몇 번 끊는 구성 | 비대칭이고 뒤섞인 구성 | 섹션끼리 얼마나 다른가? |
| MOTION | hover와 상태 피드백만 | 전환과 등장 하나 | 의도해 만든 안무 | 모션이 얼마나 있고 왜 있는가? |
세 단계를 쓰는 이유는 검토자가 "획일적인가 다양한가"는 확인할 수 있지만 "6인가 7인가"는 확인할 수 없기 때문이다. 방문 모드별 시작점은 Operate와 Read가 1 / 1 / 1, Persuade가 2 / 2 / 1, Experience가 3 / 3 / 2다. `Dial: ENERGY 2 / RHYTHM 3 / MOTION 1` 같은 `DESIGN.md` 줄이 있으면 적힌 그대로 쓴다.
다음 레버로 다이얼을 맞춘다.
- **화면마다 초점 하나:** 정확히 한 요소가 분명히 가장 중요하고 나머지는 그에 양보한다.
- **위계 대비:** 크기, 굵기, 색이 무작위가 아니라 의도해서 달라진다.
- **구조로서의 여백:** 여백이 묶음을 나누고 리듬을 만든다. 남은 공간이 아니다.
- **의도한 강조 하나:** 핵심 순간에 색이나 제스처 하나. 강조가 없으면 무미건조하고 어디에나 있으면 기본값이다.
- **정체성 모티프 하나:** 화면을 이 제품의 것으로 만드는 구체적이고 반복되는 패턴, 제스처, 타이포 목소리 하나.
다이얼을 정하는 방법은 다음과 같다.
1. 방향이 있다(`DESIGN.md`, 브랜드 가이드, `restyle`의 기존 제품, 분위기를 담은 브리프). 그로부터 다이얼을 추론한다.
2. 새 제품이라 방향이 열려 있고 사용자에게 물을 수 있다. 결정적인 질문을 정확히 하나 한다(예: "차분한 도구에 가깝나요, 표현적인 캠페인에 가깝나요?"). 질문 목록은 절대 내지 않는다.
3. 방향도 없고 물을 기회도 없다. 결과를 방향 없는 초안("draft without direction")으로 표시하고 ENERGY 1 / RHYTHM 1 / MOTION 1을 쓰며 납품물로 내지 않는다.
중립적이고 무미건조한 기본값으로 조용히 물러나지 않는다. 밋밋한 거의 흰색, 얇은 회색 테두리, 작은 반경, 일반적인 서체, 정체성 없음은 안전한 결과가 아니라 실패다.
## 11. 결정 이유
디자인이 끝났다고 말하기 전에 `brief.md`에 주요 결정마다 한 줄을 쓴다. 색, 레이아웃, 타이포, 간격, 컨테이너(카드 여부), 모든 일러스트와 아이콘 세트가 해당한다. 이유가 한 줄에 들어가지 않는 결정은 다시 본다. "기본값이라서"나 "모던해 보여서"는 이유가 아니다. 로고 바꾸기 시험이 목록을 닫는다. 로고와 제품 이름을 바꿔도 디자인이 이 제품으로 읽혀야 한다.
`DESIGN.md`, 브랜드 가이드, 사용자 견본이 `rules/delivery-gate.md`가 금지하거나 상한을 두는 패턴을 요구하면 그 요소와 해당 줄을 밝히고 한 번 묻고 답을 여기에 기록한다. 과감한 팔레트나 특이한 서체는 정체성이며 문제 삼지 않는다.
## Sources
> 확인 2026-11-07.
| 주장 | 출처 |
|---|---|
| 모델은 통계적으로 흔한 선택으로 수렴하고, 기본값 하나를 금지하면 다른 기본값으로 옮겨 간다 | <https://claude.com/resources/articles/improving-frontend-design-through-skills> (Anthropic, 2025-11-12) |
| 계획 먼저, "비슷한 페이지에도 이렇게 나올까" 확인, 브리프 자체의 말이 우선 | <https://github.com/anthropics/skills> (`frontend-design`, commit `2c5958e`) (Apache-2.0) |
| 디자인 읽기 줄, 세 다이얼과 그 레버, 다이얼 1 / 1 / 1을 쓰는 "방향 없는 초안", 결정적인 질문 하나, 실패로서의 무미건조한 기본값, 한 줄 결정 이유, 로고 바꾸기 시험, 이름 붙인 패턴을 요구하는 브리프의 충돌 처리 규약 | <https://github.com/miqdadbadjuber/anti-slop> (commit `9504989`, `antislop/SKILL.md` Part 3, R-31, R-37; MIT). The starting dials per visitor mode are this package's mapping. |
| 방문 모드 Persuade, Operate, Read, Experience를 표면에서 고른다 | <https://github.com/pbakaus/impeccable/tree/687bc381bc9091bf252c0a05303640561014a425/.agent/skills/impeccable> (Apache-2.0) |
| 구체적 참조가 형용사보다 많은 것을 전달한다. `DESIGN.md`의 token과 순서 있는 섹션 | <https://github.com/google-labs-code/design.md/tree/1ed38aa9dd4451b9039f9aeb9ed1d2579edafddf> (Apache-2.0) |
| 섹션 역할과 기록된 버린 대안 | <https://github.com/changeroa/StyleGallery> |
| 라이브러리 token 몇 개를 고치면 모든 화면의 겉모습이 바뀐다 | <https://freedesignmd.com/blog/shadcn-looks-generic> (2026-04-28) |
| 2차 물결 기본값: 크림색, 기울인 세리프, 벤토, 에메랄드 | <https://github.com/febbhav/signs-of-ai-design/tree/854b46f18dee5cc174d45cec8cd4f3142fe46984> (CC BY-SA 4.0), <https://solodesign.cc/blog/ai-design-slop-the-tells/> |
### Evidence grade
절차는 이 패키지의 종합이다. 흔한 선택으로 수렴한다는 기제는 모델 공급자가 공개 측정 없이 밝힌 것이다. 출처들은 단계의 순서에는 동의하지만 단일 체크리스트에는 동의하지 않는다.
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: 470k | 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: 470k | 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: 470k | 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 |