Communitygithub.com

craft-ui

디자인 스킬입니다. '이 스타일을 참고해서', '이런 레이아웃으로 만들어줘', '이 랜딩 페이지 수정해줘', '운영 중인 사이트를 봐줘'와 같은 요청을 처리하며, Pinterest/Dribbble 핀, 스크린샷, 이미지 링크를 공유하거나 대시보드 CRM, 랜딩 페이지, GSAP/Figma 효과, 로고 스플래시를 요청하는 경우에도 작동합니다. 사용자가 '스킬'이라는 단어를 언급하지 않아도 반응합니다. 레퍼런스와 컨텍스트에 기반한 레이아웃을 생성하며, 코드 작성 전에 세 가지 발견 에이전트(운영 사이트 분석, 요청/레퍼런스 분석, 스킬/경제 라우터)가 설계 계약(Design Contract)을 생성합니다. SaaS 앱, CRM 대시보드 등을 지원합니다.

craft-ui란 무엇인가요?

Craft UI는 AI 에이전트(Claude Code, Cursor, Codex 등)가 레퍼런스 이미지, 사용자 요청, 운영 중인 제품 사이트를 바탕으로 실제 콘텐츠가 포함된 전문적인 UI 레이아웃을 생성할 수 있도록 설계된 스킬입니다. 이 스킬의 핵심은 '증거 기반 디자인'입니다. 무분별한 기본값이나 관행에 의존하지 않고, 모든 디자인 결정이 운영 사이트 분석, 사용자 브리프, 실제로 본 레퍼런스라는 세 가지 출처 중 하나로부터 도출되어야 합니다. 코드 작성 전에 반드시 설계 계약(Design Contract)을 완료하도록 강제하며, 이 계약은 세 가지 병렬 발견 에이전트(프로덕션 사이트 분석, 요청 및 레퍼런스 분석, 스킬 라우터)로부터 정보를 수집합니다. 결과물은 단일 HTML 파일(또는 기존 프로젝트 구조에 맞춰), 실질적인 콘텐츠, 하나의 기억에 남는 모션, 반응형 디자인, WCAG AA 접근성을 만족해야 하며, 전문적인 품질 기준(references/quality-bar.md)에 따라 검증됩니다. 이 스킬은 특히 레퍼런스 기반 디자인, 기존 사이트 개선, 그리고 'AI 슬롭'을 방지하는 구조적 사고가 필요한 작업에 적합합니다.

지원 대상✓Claude Code✓Codex CLI✓Cursor✓OpenCode
npx skills add https://github.com/Fast4gc/craft-ui/tree/HEAD/skills/craft-ui

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

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

문서

Craft UI

레퍼런스 이미지 입력, 작동하는 레이아웃 출력 — 단, 제품과 요청이 이해된 후에만 가능합니다.

이 스킬이 해결하려는 문제: 무작위 섹션, 자리 표시자 카피, 기본 그라데이션, 빈 영역으로 구성된 그럴듯해 보이지만 내용이 없는 페이지가 만들어지는 것입니다. 이는 에이전트가 증거 대신 장르 관습에 따라 디자인할 때 발생합니다. 여기서 모든 구조적, 시각적 결정은 다음 세 가지 출처 중 하나로 추적 가능해야 합니다: 실제 운영 중인 제품, 사용자의 브리프, 또는 실제로 본 레퍼런스. 출처가 없으면 수집하거나 요청해야 합니다. 빈 공간을 기본값으로 채우지 마십시오.

불가침 규칙

  1. 설계 계약(Design Contract, 2단계) 전에 코드를 작성하지 마십시오. '빠른' 페이지도 예외는 아닙니다: discovery: lite는 계약을 단축할 뿐, 제거하지 않습니다. 경제성은 라우터가 처리하며, 컨텍스트를 건너뛰는 방식으로 처리하지 않습니다.
  2. 기본값보다 증거. 모든 토큰, 섹션, 카피 라인은 출처를 명시해야 합니다. "랜딩 페이지에 일반적인 것"은 출처가 아닙니다.
  3. 구조는 척추이지 뷔페가 아닙니다. 섹션은 방문자의 질문에 답하거나 브리프의 목표를 달성할 때만 존재합니다. references/anti-ai-slop.md를 참조하세요.
  4. 실제 콘텐츠. 제품명, 레이블, 데이터, 언어는 사이트/브리프에서 가져옵니다. 로렘 입숨, 가짜 로고, 조작된 지표, 사용자가 플레이스홀더를 승인하지 않은 이상 "Seu produto aqui"는 사용하지 마십시오.
  5. 사용자의 언어로 응답하고, 제품의 언어로 UI를 구축하십시오 (pt-BR 제품은 pt-BR 카피를 사용).
  6. 모든 섹션에 페이드-업 효과를 적용하는 대신, 하나의 기억에 남는 모션을 사용하십시오.
  7. 컴포넌트보다 토큰을 먼저. 색상, 반경, 서체, 간격, 그림자, 이징은 CSS 변수에 저장하고, 컴포넌트는 해당 변수만 읽습니다.
  8. 경제성은 결정 사항입니다. 라우터가 상세도(verbosity)와 실행할 스킬을 결정합니다. 적용되는 레퍼런스 섹션만 읽으십시오.
  9. 전문적인 품질 기준. references/quality-bar.md는 완료의 정의입니다 — 콘텐츠, 시각적 충실도, 반응형, WCAG AA, 성능, 인계. terse 모드에서는 자동으로 검사하며 절대 건너뛰지 않습니다.

워크플로우

0. 분류 (Triage, 메인 에이전트, 몇 초)

  • 사용자의 요청을 그대로 캡처하고, URL, 첨부 파일, "não quero" 제약 조건, 상세도 힌트("só o código", "rápido", "me explica")를 기록합니다.
  • 사용 가능한 도구를 확인합니다: 서브에이전트/Task 도구, 브라우저 또는 웹 페치, 로컬 저장소, 스킬/MCP 목록.
  • 요청이 기존 파일에 대한 사소한 수정(색상 하나, 간격 값 하나)인 경우 라우터에 알립니다 — discovery: lite로 설정될 수 있습니다. 새 페이지나 재디자인은 항상 discovery: full을 받습니다.
  • 사용자가 기존 레이아웃이 "amador", "precisa melhorar", "conserta essa landing"이라고 말하거나 코드가 있는 라이브 사이트를 가리키는 경우, references/polish-existing-site.md를 읽고 해당 경로를 따르십시오: 실제 코드베이스에 덧붙이는 방식으로 연마(polish)하고 재구축하지 마십시오. 파일을 건드리기 전에 git status를 실행하십시오.

1. 세 가지 발견 에이전트 (병렬 실행)

서브에이전트 도구(OpenCode subagent, Claude Code Task/Agent, Codex spawn_agent, Cursor 백그라운드 에이전트)를 사용하십시오. 서브에이전트 도구가 없으면 메인 에이전트에서 세 가지 패스를 순차적으로 실행하고 각 패스에 해당 제목을 레이블로 붙이십시오. 발견 에이전트는 코드를 작성하지 않습니다.

에이전트임무계약에 제공하는 정보
A — 프로덕션 사이트 분석가프로덕션 환경의 사이트 이해: 제품, 대상, 실제 카피, 현재 구조, 브랜드 토큰, 제약 조건.사이트 컨텍스트 브리프
B — 요청 및 레퍼런스 분석가실제 요청을 해독하고, 실제로 본 레퍼런스에서만 스타일 DNA 추출; 레퍼런스가 없으면 검색.요청 브리프 + 스타일 DNA
C — 스킬 라우터 / 경제성이번 실행에 필요한 최소한의 추가 스킬/도구를 선택하고 상세도 설정.라우팅 결정

전체 사양, 출력 스키마, 단어 예산: references/agents.md. 각 에이전트에 절대 스킬 루트 경로, 역할 사양, 사용자의 원시 요청, URL/첨부 파일을 전달하십시오. 반환값을 단어 예산 이내로 제한하십시오.

레퍼런스 이미지가 포함된 경우, references/pattern-transfer.md도 읽으십시오. 스타일 토큰은 이동하지만, 구성 레시피는 그렇지 않습니다. 레퍼런스만을 근거로 히어로나 섹션 패턴을 절대 채택하지 마십시오 — 제품(A)과 요청(B)에 의해 정당화되어야 합니다.

2. 설계 계약 — 하드 게이트

references/design-contract.md를 읽으십시오. A + B + C를 하나의 계약으로 병합합니다. 그런 다음 다음을 확인하십시오:

  • 구조적 척추(spine)가 정렬되어 있고, 각 섹션은 역할, 출처, 레퍼런스에서 문자 그대로 복사된 토폴로지, 실제 콘텐츠를 가지며, 빈 영역이 없습니다.
  • 모든 토큰과 카피 라인은 출처를 인용하며, 알 수 없는 것은 표시되고 발명되지 않습니다.
  • 에이전트/사이트/레퍼런스 간 충돌은 사용자에게 하나의 통합된 질문(최대 3개 항목)을 통해 해결되었으며, 추측하지 않았습니다.
  • 상세도와 스킬 목록은 C에서 오며, "존재한다는 이유만으로" 스킬을 실행하지 않습니다.
  • 패턴 채택 원장(ledger)이 있습니다: 모든 채택/적응/폐기는 A와 B를 인용합니다; 레퍼런스만으로 히어로/섹션 레시피를 가져오지 않았습니다 (references/pattern-transfer.md 참조).
  • 구성이 관련 없는 다른 분야의 제품에 대해 그럴듯하지 않습니다. 토큰은 이식 가능하지만, 히어로 레시피는 그렇지 않습니다.

발견 하위 에이전트는 사용자에게 절대 질문하지 않습니다 — 격차(Gaps) / 알 수 없음(Unknowns)만 보고합니다. 메인 에이전트는 세 가지 브리프를 모두 수집하고, 하나의 통합된 질문(최대 3개 항목)을 한 후 답변을 받을 때까지 게이트를 닫아둡니다. 중요한 사실(제품명, 대상, 실제 콘텐츠, 레퍼런스 이미지)이 아직 알려지지 않은 경우, 질문하고 중단하십시오. 3단계를 시작하지 마십시오.

3. 계획

간결한 계획: 토큰, 스파인의 ASCII 와이어프레임, 실제 카피/데이터 뱅크, 하나의 모션 순간(트리거와 이유 포함). 레퍼런스 및 사이트 브리프와 비교하십시오; 관찰된 것이 아닌 기본값인 것은 수정하거나 제거하십시오.

4. 빌드

  • 기본적으로 하나의 자체 포함된 HTML 파일(CSS 변수(토큰 역할), 실제 대체 폰트가 있는 Google Fonts). 사용자의 프로젝트가 이미 React/Tailwind를 사용하는 경우에만 기존 프로젝트 구조를 사용하십시오.
  • 모션 레시피: references/motion-and-effects.md. 고정된 cdnjs 버전의 GSAP 사용.
  • 코드는 간결하게 유지: 레이아웃에 필요하지 않은 라이브러리나 추상화는 사용하지 마십시오.
  • 1440 / 768 / 390에서 반응형, 가시적인 포커스 상태, prefers-reduced-motion 존중.
  • 빌드하는 동안 references/anti-ai-slop.md를 다시 읽으십시오 — 특히 빈 영역(empty-band)과 섹션 뷔페(section-buffet) 행을 주의하십시오.

5. 시각적 검증

렌더링하고 레퍼런스 및 사이트 브리프와 나란히 비교하십시오. 가능한 경우 브라우저 도구를 사용하십시오(C가 라우팅). references/quality-bar.md의 검증 프로토콜을 실행하십시오: 1440 / 768 / 390에서 전체 페이지 스크린샷, 섹션 순서 및 콘텐츠 존재 여부, 빈 영역이나 잘린 텍스트 없음, 가로 스크롤 없음, 실제 픽셀 대비, 키보드 포커스, 축소 모션, 콘솔 오류. 계층 구조, 간격 리듬, 반경/그림자 일관성, 밀도, 언어를 확인하십시오. 수정 라운드: 상세도가 terse일 때 1회, full일 때 최대 3회; 가장 큰 시각적 차이점부터 먼저 수정하고 체크리스트가 통과하면 중단하십시오.

6. 응답

C의 상세도에 따라 형식을 지정합니다. terse: 3–5줄 — 무엇이 구축되었는지, 사용된 증거, 검증 결과. full: 또한 어떤 레퍼런스 특성이 어디에서 왔는지, 사용/생략된 스킬, 제안된 다음 변경 사항 하나를 나열합니다. references/quality-bar.md의 인계 기준을 따르고, 알려진 제한 사항을 한 번 명시한 후 항상 사용자의 언어로 작성하십시오.

다른 스킬 사용

에이전트 C가 실행별로 결정하며, 먼저 세션에서 실제로 사용 가능한 스킬을 확인하십시오. 스킬이 없는 경우 → 대체 방안을 사용하고 마지막에 한 번 언급하십시오.

단계C가 사용을 결정한 경우대체 방안
계획/디자인 방향Impeccable (/impeccable shape, 이후 craft); 세션당 한 번 컨텍스트 단계 실행frontend-design 또는 3단계 계획
리뷰 및 연마Impeccable critique, polish, audit계약에 대한 자체 리뷰
모션 품질emil-design-eng (이징, 지속 시간, 스프링, 호버/프레스용)references/motion-and-effects.md
시각적 검증Browser MCP (Chrome DevTools / Claude in Chrome / developer-mcp-chrome): 3가지 너비에서 스크린샷, 콘솔 확인검사 내용을 설명하고 사용자에게 스크린샷 요청
3D 로고 또는 객체img2threejs (레퍼런스에 재구축할 가치가 있는 3D 객체가 있는 경우에만; 한계 명시: 하나의 이미지는 숨겨진 측면을 드러낼 수 없음)평면 SVG 또는 CSS
코드 크기 유지ponytail (종속성 추가 전)일반 CSS + 하나의 GSAP 타임라인

해당 단계에 적용될 때만 스킬을 호출하십시오. 정적 랜딩 페이지에는 img2threejs가 필요하지 않습니다.

독창성과 안전성

  • 패턴을 재현하되, 자산은 재사용하지 마십시오. 레퍼런스의 로고, 일러스트레이션, 브랜드 이름, 정확한 카피를 절대 재사용하지 마십시오. 사용자의 브랜드와 A/B의 실제 콘텐츠를 사용하십시오.
  • 많은 핀이 상업용 UI 키트로 연결됩니다. 스타일과 구조만 일치시키십시오.
  • 레퍼런스의 외관은 시작점일 뿐입니다. 사용성을 해친다면(낮은 대비, 작은 글씨체), 분위기는 유지하고 문제를 해결한 후 그렇게 명시하십시오.

파일

  • references/agents.md — 세 가지 발견 에이전트, 스키마 및 예산.
  • references/design-contract.md — 병합 템플릿 및 하드 게이트.
  • references/anti-ai-slop.md — 일반적이고, 쌓아올리기만 하며, 내용이 없는 레이아웃의 증상과 해결책.
  • references/quality-bar.md — 전문적인 완료 정의 및 검증 프로토콜.
  • references/pattern-transfer.md — 레퍼런스 이미지가 동일한 히어로 레시피를 관련 없는 제품에 이식하는 것을 방지.
  • references/polish-existing-site.md — 기존 프로덕션 레이아웃을 개선해야 할 때의 추가 워크플로우.
  • references/categories.md — 장르 기준(섹션 메뉴가 아닌 최소 실행 가능성).
  • references/style-dna.md — 레퍼런스 읽기 템플릿; 증거 필요.
  • references/motion-and-effects.md — CSS 효과 및 GSAP 레시피.
  • assets/refs.json — 알려진 레퍼런스 링크 (여전히 시청 필요).

관련 스킬