Hyliox Pixel Perfect은(는) 무엇을 하나요?
UI 스크린샷을 프론트엔드 에이전트를 위한 길고 밀도 높으며 규정적인 빌드 명세서로 변환합니다. 최대 충실도에 최적화되었으며, 간결함을 추구하지 않습니다.
철학
이 스킬은 고정된 21개 섹션으로 구성된 약 1000줄 분량의 명세서를 생성합니다. Cursor / v0 / Lovable / Codex / Claude Code에 복사하여 붙여넣을 수 있습니다. 규정적이며 적응적이지 않습니다: 동일한 21개 섹션이 동일한 순서로 모든 출력에 나타납니다. 특정 이미지에 해당 섹션의 내용이 없으면(예: 애니메이션이 보이지 않음) 섹션을 건너뛰지 말고 "이 스크린샷에는 보이지 않음 — 정적으로 구현"이라고 명시적으로 작성합니다. 예측 가능한 구조가 변덕스러운 복잡함보다 우선합니다.
이 스킬은 두 개의 최고 품질 출력 예시(assets/gold-standard-kraken.md 및 assets/gold-standard-agentai.md)에서 역설계되었습니다. 형식, 길이, 세분성에 대해 의문이 있을 경우 먼저 gold standard를 읽으십시오. 그것들이 근본 진리입니다.
해석보다 충실도. 이미지에 있는 것을 설명합니다. 섹션, 복사본, 기능, 개선 사항을 발명하지 마십시오. 이미지에 세 개의 기능 카드가 있으면 세 개를 설명합니다. 브랜드 행에 로고가 반복되어 있으면 반복합니다. 탐색에 오타("Why Karken")가 있으면 그대로 보존합니다(재구성자에게 수정 선택권을 제공).
산문보다 세분성. 모든 시각적 속성(위치, 크기, 색상, 패딩, 폰트 두께)은 자체 레이블이 지정된 txt 코드 블록을 갖습니다. 인라인 코드는 충분하지 않습니다. 명세서는 수필이 아닌 복사-붙여넣기 아티팩트입니다.
기본 기술 스택
- Next.js 16.2 (App Router + Turbopack) + React 19 + TypeScript
- Tailwind CSS (설정 파일:
tailwind.config.ts) - shadcn/ui 프리미티브 (유용한 경우)
- Framer Motion (
motion/react) - lucide-react (아이콘)
- 정적 자산:
/public/images/및/public/icons/ - CSS 변수는 HSL 형식 (shadcn 규칙:
0 0% 100%원시 값, 변수 내부에hsl()래퍼 없음)
gold standard와의 차이점. 두 gold standard 예시는 React + Vite를 대상으로 합니다. 이 스킬은 대신 Next.js 16 App Router를 출력합니다. 변환 규칙은 간단하지만 일관되게 적용해야 합니다.
index.css→app/globals.css- 자산 경로는
<Image>또는<img>에서/public/...을 루트 상대 URL(/images/foo.png)로 참조합니다. - Framer Motion, React 훅(
useState,useEffect,useScroll,useInView), 이벤트 핸들러,<video>컨트롤, 또는 브라우저 API(hls.js)를 사용하는 컴포넌트는 최상단에'use client'를 선언해야 합니다. - 순수 레이아웃/정적 콘텐츠 컴포넌트는 서버 컴포넌트로 유지(
'use client'없음). - 페이지 구조는 App Router 파일 트리(
app/layout.tsx,app/page.tsx,app/globals.css,app/components/...)를 보여줍니다. - 정적 이미지에는
next/image를 사용(알려진 치수 필요); GIF, 동적 또는 애니메이션 콘텐츠에는 원시<img>를 사용합니다.
다른 모든 것(CSS 유틸리티, glass 패밀리, fadeUp 헬퍼, 애니메이션 패턴, 레이어드 배경, fine-border 트릭)은 동일하게 전송됩니다.
워크플로우
스킬이 트리거되면 다음 단계를 순서대로 실행합니다. 단계를 건너뛰지 마십시오.
1단계 — 참조 파일과 하나의 gold standard 읽기
무엇을 작성하기 전에 다음을 로드합니다.
references/section-templates.md— 역할, 콘텐츠 규칙, 각 섹션의 형식이 포함된 21개 섹션 템플릿references/idiom-library.md— 표준 CSS 스니펫 (glass 패밀리, fine-border, 레이어드 배경, fadeUp, floating motion)references/writing-patterns.md— 레이블이 지정된 코드 블록 패턴, 모호성 처리, 안티 패턴 형식- 하나의 gold standard — 길이, 밀도, 어조에 대한 구체적인 참조:
- 입력 이미지가 어둡고/시네마틱하며/에이전시 스타일인 경우 →
assets/gold-standard-agentai.md - 입력이 제품/SaaS/핀테크/결제인 경우 →
assets/gold-standard-kraken.md - 확실하지 않은 경우 →
assets/gold-standard-kraken.md(더 다양한 섹션 커버리지)
- 입력 이미지가 어둡고/시네마틱하며/에이전시 스타일인 경우 →
이 파일들은 큽니다. 시작할 때 한 번 읽고, 생성 중간에 다시 읽지 마십시오.
2단계 — 이미지 분석
작성하기 전에 내부적으로 다음 항목을 정리합니다.
- 분류 세 가지 축(인터페이스 유형, 아트 디렉션, 분위기 레지스터) — 자세한 레이블 용어는
references/section-templates.md의 "Pre-write" 섹션 참조. 분류는 글꼴 프리셋, 디자인 토큰 방향, 시작 부분의 "느낌이 들어야 하는" 목록을 결정합니다. - 브랜드 이름 및 로고 (탐색에 표시됨)
- 시각적 은유 — 페이지를 정의하는 핵심 이미지 (Kraken: 매달린 암호화폐 펜던트. AgentAI: 붉은 생물발광 해파리. 항상 페이지의 시각적 영혼을 한 문장으로 설명합니다.)
- 섹션 목록 — 위에서 아래로 (navbar, hero, proof, logo strip, services 등)
- 색상 팔레트 — 기본 배경색, 악센트 색상, 카드 표면 색상
- 타이포그래피 페어링 — 디스플레이 산세리프(제목용), 본문 산세리프(본문용), 선택적 세리프(이탤릭체 악센트용)
- 모든 보이는 복사본 — 오타 및 반복 포함 그대로 추출
- Glass / 블러 / 노이즈 / 그레인 처리
- 애니메이션 단서 — 움직임을 암시하는 모든 요소 (떠다니는 요소, 헤일로 광선, 호버 효과)
부분적으로 가려져 있거나 읽을 수 없는 내용이 있으면 명세서에서 이를 플래그로 표시하고 완곡한 표현을 사용할 계획을 세웁니다("...with your customers" — 사용자가 완전한 문장을 원하면 확장하고, 그렇지 않으면 그대로 유지).
3단계 — 명세서를 파일로 작성
단일 마크다운 파일을 /mnt/user-data/outputs/<slug>-spec.md에 생성합니다. 여기서 <slug>는 이미지에 보이는 브랜드에서 파생된 케밥-케이스입니다 (예: kraken-spec.md, agentai-spec.md, bloom-spec.md). 브랜드를 식별할 수 없는 경우에만 ui-rebuild-spec.md로 대체합니다.
파일은 references/section-templates.md의 고정된 21개 섹션 템플릿을 따릅니다. 길이 목표: 800–1300줄. 800줄 미만은 세분성을 놓친 것입니다. 1300줄 초과는 중복으로 채워진 것입니다.
4단계 — 파일 제시 및 채팅에 간결하게 응답
present_files를 호출하여 명세서 경로를 제공합니다. 채팅 응답은 최대 3–6줄입니다.
- 어떤 섹션이 다루어졌는지 (또는 "이 스크린샷에는 보이지 않음"으로 표시된 섹션)
- 명세서에 플래그된 불확실성 또는 가정
- 재구성자가 내려야 할 명시적 결정 (예: 오타 보존, 반복 로고)
채팅에 명세서를 복사하지 마십시오. 요약하지 마십시오. 파일이 결과물입니다.
충실도의 엄격한 규칙
이 규칙들은 협상 불가입니다. 편의성, 간결함, 예의보다 우선합니다.
복사본 그대로. 이미지에 보이는 모든 단어(제목, 버튼, 레이블, 바닥글, 마이크로카피)는 원래 언어로, 오타, 구두점 특성, 반복된 내용을 포함하여 명세서에 정확히 기록됩니다. 오타를 보존할 때, 재구성자에게 선택권을 선택적으로 제공합니다("보이는 스크린샷을 정확히 재현하려면 Why Karken을 사용하고, 그렇지 않으면 Why Kraken을 사용하십시오").
안티 패턴 명시. VISUAL DETAILS TO MATCH 섹션에는 항상 안티 패턴 목록이 포함됩니다: 피해야 할 것, 하지 말아야 할 것, 건너뛸 색상 방향. 예: "파란색, 녹색, 주황색 또는 여러 색상 그라데이션을 피하십시오. 팔레트를 검은색, 보라색, 라벤더, 흰색, 회색으로 엄격하게 제한하십시오. 만화처럼 보이지 않게 하십시오."
발명 금지. 이미지에 보이지 않는 섹션, 기능, 소셜 프루프, 사용후기 또는 콘텐츠를 추가하지 마십시오. 이미지가 섹션 중간에서 잘리면(아래쪽이 잘림) 보이는 부분만 설명하고 잘림을 알립니다.
읽을 수 없는 내용은 완곡하게 표현. 텍스트가 잘리거나, 부분적으로 가려져 있거나, 진정으로 모호한 경우 만들어내지 마십시오. 표시합니다: "이 카드는 스크린샷 하단에서 부분적으로 잘려 있습니다. 표시된 본문은 보이는 부분입니다. 사용자가 완전한 문장을 원하면 '...'로 자연스럽게 확장하고, 그렇지 않으면 그대로 유지하십시오."
레이어드 배경 분해. 모든 복잡한 배경은 N개의 명시적 절대 레이어(기본 색상, 방사형 그라데이션, 노이즈 오버레이, 비네트 등)로 분해되며, 쌓이는 순서가 명시됩니다. 집계하지 마십시오("점선-그리드 + 보라색-광선 + 픽셀-바닥"과 같이 작성). 각 레이어를 자체 스니펫으로 나열합니다.
Glass 패밀리 이름 지정. "liquid-glass"와 같은 단일 이름을 강요하지 마십시오. 이미지의 용도에 따라 glass 유틸리티 이름을 지정하십시오: .glass-nav, .glass-card, .glass-card-soft, .glass-pill, .glass-panel. 이미지가 이름을 안내합니다.
브랜드화된 색상 네임스페이스. 디자인에 강력한 브랜드 팔레트가 있는 경우 Tailwind 확장에 네임스페이스를 지정합니다: colors: { kraken: { black, panel, purple, ... } } 또는 colors: { redai: { DEFAULT, dark, soft } }. 이렇게 하면 명세서가 일반적이지 않고 의도적으로 느껴집니다.
Box-shadow를 명명된 토큰으로. Tailwind 설정에서 boxShadow: { 'red-glow': '...', 'glass': '...' }와 같이 정의하고, 전체에 shadow-[...] 문자열을 인라인으로 사용하는 대신 shadow-red-glow로 참조합니다.
gold standard를 중간에 참조해야 할 때
특정 섹션을 작성하려고 하는데 얼마나 밀도 있게, 세분화하여, 형식화해야 할지 확실하지 않은 경우 — 중단하고 일치하는 gold standard의 해당 섹션을 다시 읽으십시오. gold standard가 기준을 정의합니다. 예시:
- HERO 섹션을 작성하려고 하는데 하위 섹션(2a, 2b, 2c)이 몇 개나 있어야 할지 확실하지 않은 경우? 일치하는 gold standard가 hero를 어떻게 구성하는지 확인하십시오.
SPACING AND LAYOUT DETAILS를 작성하려고 하는데 JSON에 어떤 키가 속하는지 확실하지 않은 경우? gold standard에서 구조를 복사하고 값을 이미지에 맞게 조정하십시오.VISUAL DETAILS TO MATCH를 작성하려고 하는데 항목이 5개뿐인 경우? gold standard에는 15-25개가 있습니다. 더 찾으십시오.
gold standard는 보정 도구입니다. 사용하십시오.
전달 전 형식 확인 목록
present_files를 호출하기 전에 초안을 한 번 스캔합니다.
- 길이가 800–1300줄입니다 (더 짧음 = 과소 명세됨; 더 김 = 채워짐)
- 기술 스택과 핵심 미적 감각을 명시하는 "Build a..." 문장으로 시작합니다
- 21개 섹션이 모두 순서대로 존재하며, 일부가 "이 스크린샷에는 보이지 않음"이어도 됩니다
- 시작 부분 또는
GLOBAL PAGE DIRECTION에 시각적 은유가 명시됩니다 - 기술 스택이 Next.js 16 App Router에 맞게 조정되었습니다 (Vite 아님)
- 애니메이션/인터랙티브 컴포넌트에
'use client'알림이 포함됩니다 - 보이는 모든 복사본이 원래 언어로 그대로 추출되었습니다
- 제목의 이탤릭체 세리프 악센트가 감지되어 언급되었습니다
- CSS 유틸리티가 일반적인 "liquid-glass"가 아닌 용도에 따라 명명되었습니다
- Tailwind 설정에 브랜드화된 색상 네임스페이스가 있습니다
- Tailwind 설정에 box-shadow 명명된 토큰이 있습니다
- 배경이 N개의 절대 레이어로 분해되었습니다 (집계되지 않음)
- 모든 시각적 속성이 자체 레이블이 지정된
txt코드 블록에 있습니다 (Style:, Position:, Implementation:) -
EXACT VISUAL HIERARCHY가 요소를 시각적 가중치로 순위를 매깁니다 (번호 목록) -
SPACING AND LAYOUT DETAILS에 픽셀 형상을 포함하는 JSON 블록이 있습니다 -
VISUAL DETAILS TO MATCH에 안티 패턴이 포함됩니다 ("X를 피하고, Y를 하지 마십시오") -
COPYWRITING CONTENT가 모든 복사본을 스캔 가능한 블록으로 재구성합니다 - 잘리거나, 모호하거나, 읽을 수 없는 콘텐츠에 완곡한 표현이 적용되었습니다
- 비판, 개선 제안, 서문이 없습니다
- 명세서가
/mnt/user-data/outputs/<slug>-spec.md에 작성되었습니다 - 채팅 응답이 최대 3–6줄입니다