Communitygithub.com

homepage-maker

エージェントが、実際の優れたWebサイトを調査・分析し、出典を明示しながら、地域密着型の店舗ホームページやランディングページを制作する手順を示すスキルです。

homepage-maker とは?

このスキルは、AIエージェントが「AIっぽさ」を排除し、デザイナーのように質の高いランディングページやポートフォリオページを制作するためのワークフローを提供します。事前調査(顧客情報、競合分析、法規制など)をもとに、実際の優れたWebサイトを参照し、そのデザインの根拠(レイアウト、フォント、配色などの「ムーブ」)を明確にしながら、地域の店舗に必須の情報(住所、電話、営業時間、駐車場、メニュー、原産地表示など)を漏れなく組み込みます。`scripts/homepage.mjs` というCLIツールを中心に、初期化、参照サイトのキャプチャ、ボード作成、コピーライティング抽出、チェック、スクリーンショット比較、Vercelへのデプロイまでを自動化します。特に、韓国のローカルビジネスに特化したチェック(JSON-LD構造化データ、telリンク、Naver/Kakao地図、原産地表示、ハングルの禁則処理など)や、humanize-koreanツールによる「AIらしさ」のスコアリングが特徴で、出典の明示や事実に基づく情報管理を厳格にルール化することで、信頼性の高い成果物を効率的に生み出せます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/min9lin9/min9maker-homepage/tree/HEAD

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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がページに含まれるのを防ぎます。

手順

⛔ マークのあるステップは、人間の承認なしに進みません。

  1. init — 事前調査が完了しているか、上記の表で確認した後、sites/<slug> に brief.md、facts.md、refs.md、site/、refs/ を作成します。
  2. ブリーフ — サイトの目的は、訪問者が取る行動1つ(道案内、予約、電話)に絞ります。誰がどのような状況でアクセスするか(例: 週末に車で来る客が、出発前にスマートフォンで確認する)を記述します。
  3. ファクトシート — 住所、電話、営業時間、休業日、駐車場、予約リンク、Naver地図リンク、メニュー、価格、原産地を出典とともに記述します。確認できていないものは「確認必要」とし、ページに使用しません。facts.md にない数字がページにあると、checkが失敗します。
  4. リファレンス探し — references/sources.md のソースの中から3つ以上のサイトで、候補を8~12個見つけます。同じ業種だけを見るのではなく、同じ課題(メニューを見せる、場所を知らせる、工程を見せる)をうまく解決しているサイトを選びます。
  5. キャプチャと記録 — 選んだ5~8サイトを ref でキャプチャします。デスクトップ・モバイルのスクリーンショットと、フォント・サイズ・色・本文幅・動きの程度が refs/<slug>/ に保存され、refs.md に記録されます。各リファレンスの**「取り入れたもの」を1行で**記述します。レイアウト、写真、文言はそのまま取り入れません。方法は references/moves.md を参照。
  6. ⛔ 3方向提案 — board で out/board.png と共有用フォルダ out/board/(検索除外の noindex、カードごとに元サイトへのリンク・取り入れたもの・使用セクション)を作成し、それぞれ異なるリファレンスから出発した3つの方向性を提案します。各方向にどのリファレンスの何を取り入れたのかを記述し、人間が1つを選ぶまで作成を進めません。
  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 も開きます。確認項目: 最初の画面で何の店か・どこにあるかがわかるか、リファレンスから取り入れた1つの要素が実際に活きているか、テンプレートのように見えないか。修正点があれば7に戻ります。
  11. ⛔ 承認 — compare.png、site-mobile.png、out/report.json で承認を受けます。
  12. デプロイ — 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つ未満
attributiondata-ref のないセクション、または refs/ にないリファレンスを指している
factページの数値が facts.md にない
placeholder[...]、【...】、lorem、TODO が残っている
claim・origin根拠のない独占的表現、原産地行なしで肉料理+価格
localLocalBusiness/Restaurant JSON-LD、tel: リンク、Naver・Kakao地図リンク、営業時間のうちいずれかが欠如
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 編集キュレーション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万デザイナーの保存に基づくキュレーション、自分の保存リスト活用公開ページのみ使用のためパーソナライズなし

関連スキル