homepage-maker은(는) 무엇을 하나요?
AI가 만든 티가 나는 페이지(가운데 정렬 제목, 보라색 그라데이션, 카드 세 장)를 피하려고, 디자이너처럼 먼저 잘 만든 실제 사이트를 보고, 무엇을 어디서 가져왔는지 밝히고, 매장 홈페이지에 꼭 필요한 정보가 빠지지 않게 만드는 스킬입니다. 렌더와 검사는 scripts/homepage.mjs가 합니다.
SK=.claude/skills/homepage-maker/scripts/homepage.mjs
node $SK init sites/<slug>
node $SK ref sites/<slug> <url> --note "이 사이트에서 가져올 한 가지"
node $SK board sites/<slug>
node $SK copy sites/<slug>
node $SK check sites/<slug> [--draft]
node $SK shots sites/<slug> --compare <ref1>,<ref2>
node $SK deploy sites/<slug> [--prod]
처음 설치: 스킬 폴더에서 npm install && npx playwright install chromium(README의 설치 절차). 명령은 프로젝트 루트에서 실행합니다. 문구 AI 티 점수는 프로젝트에 humanize-korean이 .claude/skills/humanize-korean/에 있을 때만 돕니다(다른 위치는 HUMANIZE_KOREAN_ROOT).
선행 리서치
이 스킬은 조사 결과로 페이지를 만듭니다. 직접 하는 조사는 디자인 레퍼런스 수집뿐이고, 아래는 먼저 끝나 있어야 합니다. 항목별 내용·쓰이는 곳·없을 때 생기는 일은 references/prerequisites.md.
| 시점 | 필요한 리서치 |
|---|---|
| 브리프 전 | 고객 기본 정보(주소·전화·영업시간·주차·예약·메뉴·가격·원산지), 방문자 상황(누가 어떤 상황에서 들어오는가), 업종 광고 규제 |
| 세 방향 제안 전 | 경쟁·대체 매장 채널 현황(리뷰·소개문·홈페이지 유무), 브랜드 정의 |
| 문구 확정 전 | 키워드·검색 노출 |
| 배포 전 | 도메인·호스팅 명의, 필수 고지(예약·문의 폼이 있을 때) |
확인 안 된 값은 facts.md에 "확인 필요"로 두면 check가 페이지에 들어가는 것을 막습니다.
절차
⛔ 표시 단계는 사람 승인 없이 넘어가지 않습니다.
- init — 선행 리서치가 끝났는지 위 표로 확인한 뒤,
sites/<slug>에brief.md,facts.md,refs.md,site/,refs/가 생깁니다. - 브리프 — 사이트 목적은 방문자가 할 행동 하나(길찾기, 예약, 전화)로 정합니다. 누가 어떤 상황에서 들어오는지(예: 주말에 차로 오는 손님이 출발 전에 휴대폰으로 확인)를 적습니다.
- 팩트시트 — 주소·전화·영업시간·휴무·주차·예약 링크·네이버 지도 링크·메뉴·가격·원산지를 출처와 함께 적습니다. 확인 안 된 것은 "확인 필요"로 두고 페이지에 쓰지 않습니다. facts.md에 없는 숫자가 페이지에 있으면 check가 실패합니다.
- 레퍼런스 찾기 —
references/sources.md의 출처 중 세 곳 이상에서 후보 8~12개를 찾습니다. 같은 업종만 보지 말고, 같은 문제(메뉴를 보여 주기, 위치를 알려 주기, 공정을 보여 주기)를 잘 푼 사이트를 고릅니다. - 캡처와 기록 — 고른 5~8곳을
ref로 캡처합니다. 데스크톱·모바일 스크린샷과 글꼴·크기·색·본문 폭·움직임 정도가refs/<slug>/에 저장되고refs.md에 기록됩니다. 각 레퍼런스의 "가져온 것"을 한 줄로 적습니다. 레이아웃·사진·문구는 가져오지 않습니다. 방법은references/moves.md. - ⛔ 세 방향 제안 —
board로out/board.png와 공유용 폴더out/board/(검색 제외 noindex, 카드마다 원 사이트 링크·가져온 것·쓰인 섹션)를 만들고, 서로 다른 레퍼런스에서 출발한 방향 세 개를 제안합니다. 각 방향에 어떤 레퍼런스의 무엇을 가져왔는지 적고, 사람이 하나를 고를 때까지 만들지 않습니다. - 섹션별 제작 —
site/index.html(+site/안의 css·이미지)을 섹션 단위로 만듭니다. 모든<section>에data-ref="<refs 폴더 이름>"을 달아 출처를 밝힙니다. 섹션을 만들기 전에 해당 레퍼런스의 그 섹션을 다시 봅니다. 지역 매장 필수 블록은references/korea-local.md. - 문구 윤문 —
copy로 페이지에 보이는 문구를 블록 단위로 뽑아sites/<slug>/_workspace/<날짜>-NNN-<tag>/01_input.txt에 저장합니다(사진 출처·라이선스 줄과data-copy-skip영역은 빠집니다). 프로젝트에 humanize-korean(epoko77-ai/im-not-ai)이 있으면 같은 명령이 경로(light·standard·heavy)와 위험도를 보여 줍니다. 그 run 폴더를 humanize-korean 스킬로 윤문해final.md를 만들고verify_gates.py를 통과시킨 뒤, 바뀐 문장만site/에 옮깁니다. 숫자·고유명사·인용은 고치지 않습니다. 도구가 없으면 이 단계는 문구 추출까지만 합니다. - check — 실패(✗)가 0이 될 때까지 고칩니다. 작업 중에는
--draft로 실패를 경고로 낮춰 볼 수 있지만 납품·배포는--draft없이 통과해야 합니다. - 눈으로 비교 —
shots --compare로out/compare.png를 만들어 고른 레퍼런스와 나란히 봅니다.out/site-mobile.png도 엽니다. 확인할 것: 첫 화면에 무엇을 하는 가게인지·어디인지가 보이는가, 레퍼런스에서 가져온 한 가지가 실제로 살아 있는가, 템플릿처럼 보이지 않는가. 고칠 점이 있으면 7로 돌아갑니다. - ⛔ 승인 —
compare.png,site-mobile.png,out/report.json으로 승인받습니다. - 배포 —
deploy는 check가 통과해야만 Vercel에 올립니다. 처음에는 폴더 이름(sites/<slug>의 slug)으로 Vercel 프로젝트를 연결합니다. Vercel은 새 프로젝트의 첫 배포를 무조건 production(<slug>.vercel.app)으로 올리므로, 임시 정보가 있으면 페이지 상단에 "임시 정보" 안내를 넣고 배포합니다. 두 번째부터는 미리보기 주소가 생기고,--prod는 승인 후에만 씁니다. 자체 도메인 연결도 승인 후입니다.
규칙
- 레퍼런스 출처는
references/sources.md의 허용 목록만 씁니다. robots.txt가 Claude 에이전트를 막는 곳(Godly, GDWEB)은ref가 거부합니다. 사람이 직접 보고 메모만 남깁니다. - 레퍼런스 캡처는 분석용입니다.
refs/는 저장소에 올리지 않고(.gitignore), 레퍼런스의 사진·문구·로고를 사이트에 쓰지 않습니다. - 납품본 사진은 가게에서 직접 찍은 것만 씁니다. AI 생성 음식 사진·합성 인물은 쓰지 않습니다. 시안 단계에서는 라이선스가 분명한 자리표시 사진(CC 등)을 쓸 수 있고, 페이지에 "자리표시" 표기와 사진 출처를 넣고 facts.md에도 출처 줄을 둡니다.
- 확정 전 정보로 시안을 만들 때는 facts.md에 임시로 표시하고 페이지에 "임시 정보" 안내를 둡니다. 전화번호는 누구의 번호도 아닌 값(예: 031-000-0000)만 씁니다.
- 독점 표현(최초·최대·유일·원조·N위)은 facts.md 근거가 있을 때만, 메뉴와 가격을 쓰면 원산지 표시(원산지법). carousel-maker와 같은 규칙입니다.
- 이미지는 장당 500KB 이하(WebP/AVIF 권장), 사이트 전체 3MB 이하를 목표로 합니다.
게이트
| 게이트 | 실패 조건 |
|---|---|
| refs | "가져온 것"이 적힌 레퍼런스가 3개 미만 |
| attribution | data-ref 없는 섹션, 또는 refs/에 없는 레퍼런스를 가리킴 |
| fact | 페이지 숫자가 facts.md에 없음 |
| placeholder | [...], 【...】, lorem, TODO가 남음 |
| claim · origin | 근거 없는 독점 표현, 원산지 줄 없이 고기 메뉴+가격 |
| local | LocalBusiness/Restaurant JSON-LD, tel: 링크, 네이버·카카오 지도 링크, 영업시간 중 하나라도 없음 |
| meta | og:title·og:image, lang="ko", viewport 누락 |
| korean | body에 word-break: keep-all 없음 |
| a11y · contrast | alt 없는 이미지, WCAG AA 대비 미달 |
| mobile | 390px에서 가로 스크롤, 본문 16px 미만 (버튼 44px 미만은 경고) |
| template · weight | 보라 그라데이션·상투 문구, 무거운 이미지 (경고) |
| copy-style | humanize-korean 점수가 위험도 low가 아니거나, 경로가 light가 아니거나, 연결어미 뒤 쉼표 z>3, 'A가 아니라 B' 2회+ (경고). 도구가 없으면 건너뜀(i) |
Muzli MCP와 비교
| Muzli MCP | homepage-maker | |
|---|---|---|
| 레퍼런스 | Muzli 편집 큐레이션 한 곳 | Muzli 공개 컬렉션 + SiteInspire·Land-book·Lapa Ninja·One Page Love·Awwwards |
| 출처 명시 | 대화로 말하게 함 | 섹션마다 data-ref로 강제, 없으면 실패 |
| 레퍼런스 분석 | 이미지와 설명 | 데스크톱·모바일 캡처 + 글꼴·크기·색·폭 토큰 |
| 결과 검사 | 없음 | 팩트·법규·지역 매장 정보·모바일·대비·한글 게이트 + 문구 AI 티 점수(humanize-korean) |
| 시각 검토 | 없음 | 레퍼런스와 나란히 비교 이미지 |
| 배포 | muzli.space(검색 비노출, 폼 불가, 10개 제한) | Vercel(검색 노출, 자체 도메인 연결 가능) |
| 한국 업종 | 없음 | 네이버 지도·예약, JSON-LD, 원산지, 한글 줄바꿈 |
| Muzli 쪽이 나은 점 | 90만 디자이너 저장 기반 큐레이션, 내 저장 목록 활용 | 공개 페이지만 써서 개인화가 없음 |