homepage-maker は何をしますか?
AIが作ったとわかるページ(中央揃えのタイトル、紫色のグラデーション、3枚のカード)を避けるために、デザイナーのようにまず優れた実際のサイトを見て、何をどこから持ってきたのか明らかにし、店舗ホームページに必ず必要な情報が欠けないように作るスキルです。レンダリングと検査は scripts/homepage.mjs が行います。
SK=.claude/skills/homepage-maker/scripts/homepage.mjs
node $SK init sites/<slug>
node $SK ref sites/<slug> <url> --note "このサイトから取り入れる1つの要素"
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 を参照。
| タイミング | 必要なリサーチ |
|---|---|
| ブリーフ前 | 顧客基本情報(住所・電話・営業時間・駐車・予約・メニュー・価格・原産地)、訪問者の状況(誰がどのような状況でアクセスするか)、業種の広告規制 |
| 3方向提案前 | 競合・代替店舗のチャネル状況(レビュー・紹介文・ホームページの有無)、ブランド定義 |
| 文言確定前 | キーワード・検索露出 |
| デプロイ前 | ドメイン・ホスティング名義、必須の告知(予約・問い合わせフォームがある場合) |
確認されていない値は facts.md に「確認必要」と記載しておけば、checkがページに含まれるのを防ぎます。
手順
⛔ マークのあるステップは、人間の承認なしに進みません。
- init — 事前調査が完了しているか、上記の表で確認した後、
sites/<slug>にbrief.md、facts.md、refs.md、site/、refs/を作成します。 - ブリーフ — サイトの目的は、訪問者が取る行動1つ(道案内、予約、電話)に絞ります。誰がどのような状況でアクセスするか(例: 週末に車で来る客が、出発前にスマートフォンで確認する)を記述します。
- ファクトシート — 住所、電話、営業時間、休業日、駐車場、予約リンク、Naver地図リンク、メニュー、価格、原産地を出典とともに記述します。確認できていないものは「確認必要」とし、ページに使用しません。facts.md にない数字がページにあると、checkが失敗します。
- リファレンス探し —
references/sources.mdのソースの中から3つ以上のサイトで、候補を8~12個見つけます。同じ業種だけを見るのではなく、同じ課題(メニューを見せる、場所を知らせる、工程を見せる)をうまく解決しているサイトを選びます。 - キャプチャと記録 — 選んだ5~8サイトを
refでキャプチャします。デスクトップ・モバイルのスクリーンショットと、フォント・サイズ・色・本文幅・動きの程度がrefs/<slug>/に保存され、refs.mdに記録されます。各リファレンスの**「取り入れたもの」を1行で**記述します。レイアウト、写真、文言はそのまま取り入れません。方法はreferences/moves.mdを参照。 - ⛔ 3方向提案 —
boardでout/board.pngと共有用フォルダout/board/(検索除外の noindex、カードごとに元サイトへのリンク・取り入れたもの・使用セクション)を作成し、それぞれ異なるリファレンスから出発した3つの方向性を提案します。各方向にどのリファレンスの何を取り入れたのかを記述し、人間が1つを選ぶまで作成を進めません。 - セクションごとの制作 —
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も開きます。確認項目: 最初の画面で何の店か・どこにあるかがわかるか、リファレンスから取り入れた1つの要素が実際に活きているか、テンプレートのように見えないか。修正点があれば7に戻ります。 - ⛔ 承認 —
compare.png、site-mobile.png、out/report.jsonで承認を受けます。 - デプロイ —
deployは check が通過した場合のみ Vercel にアップロードします。初回はフォルダ名(sites/<slug>の slug)で Vercel プロジェクトを接続します。Vercel は新規プロジェクトの初回デプロイを必ず production(<slug>.vercel.app)として公開するため、仮情報がある場合はページ上部に「仮情報」の案内を入れてデプロイします。2回目以降はプレビューURLが生成され、--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 と同じルールです。
- 画像は1枚あたり500KB以下(WebP/AVIF推奨)、サイト全体で3MB以下を目標とします。
ゲート
| ゲート | 失敗条件 |
|---|---|
| refs | 「取り入れたもの」が記載されたリファレンスが3つ未満 |
| attribution | data-ref のないセクション、または refs/ にないリファレンスを指している |
| fact | ページの数値が facts.md にない |
| placeholder | [...]、【...】、lorem、TODO が残っている |
| claim・origin | 根拠のない独占的表現、原産地行なしで肉料理+価格 |
| local | LocalBusiness/Restaurant JSON-LD、tel: リンク、Naver・Kakao地図リンク、営業時間のうちいずれかが欠如 |
| 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 編集キュレーション1箇所 | Muzli 公開コレクション + SiteInspire・Land-book・Lapa Ninja・One Page Love・Awwwards |
| 出典明示 | 会話で伝える | セクションごとに data-ref で強制、ない場合は失敗 |
| リファレンス分析 | 画像と説明 | デスクトップ・モバイルキャプチャ + フォント・サイズ・色・幅トークン |
| 結果検査 | なし | ファクト・法規・地域店舗情報・モバイル・コントラスト・ハングルゲート + 文言のAIらしさスコア(humanize-korean) |
| 視覚レビュー | なし | リファレンスと並べた比較画像 |
| デプロイ | muzli.space(検索非表示、フォーム不可、10件制限) | Vercel(検索表示可、独自ドメイン接続可) |
| 韓国業種対応 | なし | Naver地図・予約、JSON-LD、原産地、ハングルの禁則処理 |
| Muzli の優位点 | 90万デザイナーの保存に基づくキュレーション、自分の保存リスト活用 | 公開ページのみ使用のためパーソナライズなし |