Communitygithub.com

홈페이지 메이커

AI가 만든 티가 나는 페이지를 피하고, 실제 잘 만들어진 사이트를 분석하여 정보가 빠짐없이 담긴 홈페이지, 랜딩 페이지 또는 포트폴리오를 제작하는 스킬입니다.

홈페이지 메이커 是什么?

homepage-maker는 개발자와 AI 에이전트가 디자이너처럼 작업하여 겉보기만 그럴듯한 'AI스러운' 페이지(가운데 정렬 제목, 보라색 그라데이션, 카드 세 장)를 피하고, 실제 고품질 레퍼런스를 기반으로 구조화된 홈페이지를 만들 수 있게 해 줍니다. 이 스킬은 선행 조사(고객 기본 정보, 경쟁사 현황, 키워드 등)를 기반으로 브리핑→팩트 시트→레퍼런스 수집 및 캡처→세 가지 방향 제안→섹션별 제작→문구 윤문→검사→배포의 12단계 절차를 따릅니다. Claude Code, Cursor 등 MCP를 지원하는 환경에서 사용할 수 있으며, `scripts/homepage.mjs` 스크립트를 통해 init, ref, board, copy, check, shots, deploy 등의 명령을 제공합니다. 특히 한국 로컬 비즈니스(지역 매장)에 최적화되어 있어 네이버 지도, JSON-LD, 원산지 표시, 한글 줄바꿈 처리를 자동으로 검사하며, humanize-korean 도구와 연동하여 AI가 쓴 듯한 문구를 감지하고 개선합니다. Muzli MCP와 달리 여러 레퍼런스 소스를 사용하고, 출처를 강제하며, 법규·접근성·모바일 대응까지 검증하는 게이트 시스템을 갖추고 있어 품질 높은 결과물을 보장합니다.

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/min9lin9/min9maker-homepage/tree/HEAD

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

홈페이지 메이커 是做什么的?

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가 페이지에 들어가는 것을 막습니다.

절차

⛔ 표시 단계는 사람 승인 없이 넘어가지 않습니다.

  1. init — 선행 리서치가 끝났는지 위 표로 확인한 뒤, sites/<slug>에 brief.md, facts.md, refs.md, site/, refs/가 생깁니다.
  2. 브리프 — 사이트 목적은 방문자가 할 행동 하나(길찾기, 예약, 전화)로 정합니다. 누가 어떤 상황에서 들어오는지(예: 주말에 차로 오는 손님이 출발 전에 휴대폰으로 확인)를 적습니다.
  3. 팩트시트 — 주소·전화·영업시간·휴무·주차·예약 링크·네이버 지도 링크·메뉴·가격·원산지를 출처와 함께 적습니다. 확인 안 된 것은 "확인 필요"로 두고 페이지에 쓰지 않습니다. facts.md에 없는 숫자가 페이지에 있으면 check가 실패합니다.
  4. 레퍼런스 찾기 — references/sources.md의 출처 중 세 곳 이상에서 후보 8~12개를 찾습니다. 같은 업종만 보지 말고, 같은 문제(메뉴를 보여 주기, 위치를 알려 주기, 공정을 보여 주기)를 잘 푼 사이트를 고릅니다.
  5. 캡처와 기록 — 고른 5~8곳을 ref로 캡처합니다. 데스크톱·모바일 스크린샷과 글꼴·크기·색·본문 폭·움직임 정도가 refs/<slug>/에 저장되고 refs.md에 기록됩니다. 각 레퍼런스의 "가져온 것"을 한 줄로 적습니다. 레이아웃·사진·문구는 가져오지 않습니다. 방법은 references/moves.md.
  6. ⛔ 세 방향 제안 — board로 out/board.png와 공유용 폴더 out/board/(검색 제외 noindex, 카드마다 원 사이트 링크·가져온 것·쓰인 섹션)를 만들고, 서로 다른 레퍼런스에서 출발한 방향 세 개를 제안합니다. 각 방향에 어떤 레퍼런스의 무엇을 가져왔는지 적고, 사람이 하나를 고를 때까지 만들지 않습니다.
  7. 섹션별 제작 — site/index.html(+ site/ 안의 css·이미지)을 섹션 단위로 만듭니다. 모든 <section>에 data-ref="<refs 폴더 이름>"을 달아 출처를 밝힙니다. 섹션을 만들기 전에 해당 레퍼런스의 그 섹션을 다시 봅니다. 지역 매장 필수 블록은 references/korea-local.md.
  8. 문구 윤문 — 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/에 옮깁니다. 숫자·고유명사·인용은 고치지 않습니다. 도구가 없으면 이 단계는 문구 추출까지만 합니다.
  9. check — 실패(✗)가 0이 될 때까지 고칩니다. 작업 중에는 --draft로 실패를 경고로 낮춰 볼 수 있지만 납품·배포는 --draft 없이 통과해야 합니다.
  10. 눈으로 비교 — shots --compare로 out/compare.png를 만들어 고른 레퍼런스와 나란히 봅니다. out/site-mobile.png도 엽니다. 확인할 것: 첫 화면에 무엇을 하는 가게인지·어디인지가 보이는가, 레퍼런스에서 가져온 한 가지가 실제로 살아 있는가, 템플릿처럼 보이지 않는가. 고칠 점이 있으면 7로 돌아갑니다.
  11. ⛔ 승인 — compare.png, site-mobile.png, out/report.json으로 승인받습니다.
  12. 배포 — 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개 미만
attributiondata-ref 없는 섹션, 또는 refs/에 없는 레퍼런스를 가리킴
fact페이지 숫자가 facts.md에 없음
placeholder[...], 【...】, lorem, TODO가 남음
claim · origin근거 없는 독점 표현, 원산지 줄 없이 고기 메뉴+가격
localLocalBusiness/Restaurant JSON-LD, tel: 링크, 네이버·카카오 지도 링크, 영업시간 중 하나라도 없음
metaog:title·og:image, lang="ko", viewport 누락
koreanbody에 word-break: keep-all 없음
a11y · contrastalt 없는 이미지, WCAG AA 대비 미달
mobile390px에서 가로 스크롤, 본문 16px 미만 (버튼 44px 미만은 경고)
template · weight보라 그라데이션·상투 문구, 무거운 이미지 (경고)
copy-stylehumanize-korean 점수가 위험도 low가 아니거나, 경로가 light가 아니거나, 연결어미 뒤 쉼표 z>3, 'A가 아니라 B' 2회+ (경고). 도구가 없으면 건너뜀(i)

Muzli MCP와 비교

Muzli MCPhomepage-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만 디자이너 저장 기반 큐레이션, 내 저장 목록 활용공개 페이지만 써서 개인화가 없음

相关技能