Communitygithub.com

MCERQUA/jam-skills - 本格的なNext.js 15 Webサイト構築スキル

Next.js 15 で本番環境向けWebサイトをゼロから構築。リサーチファーストのワークフロー(発見→深層リサーチ→デザイン計画→スキャフォールド→構築→デプロイ)を採用。

jam-skills - 本格的なNext.js 15 Webサイト構築スキル とは?

このスキルは、Next.js 15 を用いた本番品質のWebサイト構築を、データ駆動型のプロセスで実現するためのものです。キーワード調査、競合分析、コンテンツ戦略、トピックマップ作成といった徹底したリサーチフェーズを経てから、設計計画を策定し、コードを書くという順序を厳守します。これにより、デフォルトのテンプレートに頼った質の低いサイトではなく、検索エンジン最適化(SEO)とコンバージョン率最適化(CRO)を意識した、真に効果的なサイトを構築できます。主にClaude CodeなどのAIエージェント環境での利用を想定しており、13のフェーズからなるワークフローに従って進めます。特にローカルサービスビジネス向けのサイトでは、具体的なCROルールが定められており、リード獲得率の向上を図ります。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/MCERQUA/jam-skills/tree/HEAD/website-builder

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

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

ドキュメント

⚠️ 先に読むこと:このスキルディレクトリ内の PNPM_11_REQUIREMENTS.md 以降(Mikeがあなたのサイトをプレビューする)のWebdevコンテナは、2026-05-13よりpnpm 11.1.1で動作します。 すべての新しいプロジェクトは、package.jsonに pnpm.onlyBuiltDependencies を宣言しなければなりません(最低でも、Next.jsプロジェクトには ["sharp"] が必要)。 これを省略すると、開発サーバーが起動せず、コンテナが再起動ループに陥り、502エラーが発生し、ユーザーはあなたを責めるでしょう。 60秒で読めます。無視するのは危険です。

Webサイトビルダー — 完全版Next.js Webサイトスキル

リサーチ主導、デザインを意図したWebサイト構築。すべての判断はデータに基づき、すべてのセクションはリサーチによって正当化されます。

このスキルを使用するタイミング

以下のようなリクエストがあった場合にトリガーします:

  • 新しいWebサイトを構築する
  • 自分のビジネス用のWebサイトを作成する
  • 新しいWebプロジェクトを開始する
  • 「サイトを作って」

以下の用途では使用しないでください:

  • Canvasページ(代わりに canvas-web-design スキルを使用)
  • 既存のWebサイトプロジェクトの編集(そのプロジェクトの .claude/CLAUDE.md に従う)
  • Remotion動画プロジェクト(代わりに remotion-video スキルを使用)

絶対に守るべきルール

  1. リサーチとデザイン計画を完了する前に、決してコードを書かないこと。 フェーズ1〜4ではコードは一切生成しません。それが正しいやり方です。
  2. テンプレートのデフォルト値をそのまま使ったページを決して納品しないこと。 「ロゴ」「(555) 000-0000」「[email protected]」「サービス1」などを見かけたら、それは失敗です。
  3. キーワードリサーチなしにコピーを決して書かないこと。 すべての見出しは、フェーズ3で特定した特定のキーワードをターゲットにします。
  4. デザイン計画を決して省略しないこと。 すべてのセクション、色、アニメーションには、文書化された「理由」がなければなりません。
  5. 恐怖をあおる戦術や恐怖に基づく見出しを決して使わないこと。 ベネフィット重視、SEOを意識したコピーを書きましょう。
  6. サイトを提出する前に、必ずプレースホルダーの掃除を実行すること。 ゼロトレランスです。
  7. 必ずすべてのセクションをカスタマイズすること。 セクションが組み込みのデフォルト値をレンダリングしている場合、propsを渡すのを忘れています。
  8. 戻るボタンの乗っ取りを決して出荷しないこと。 history.pushState ループ、リダイレクトトラップ、ブラウザの戻るボタンがユーザーをSERPに戻すのを妨げるモーダル/オーバーレイチェーンは禁止です。これはGoogleのスパムポリシー違反(悪質な慣行、2026-06-15施行)であり、手動措置とランキング低下のリスクがあります。離脱インテントスクリプト、インタースティシャル、および含まれるアド/ライブラリコードを監査してください(多くの場合、違反はファーストパーティではなく、そこから発生します)。フェーズ12で検証してください。(developers.google.com/search/blog/2026/04/back-button-hijacking)

サイトタイプ

受け入れ時に識別します。すべてが変わります。

タイプ目標主要セクションコピーのスタイル
SEOリード獲得ランキング獲得+リード獲得ヒーロー+トラストバー+カバレッジグリッド+仕組み+FAQ+お客様の声+CTAキーワード豊富、ベネフィット重視、プロフェッショナル
ローカルサービス電話+フォームヒーロー+トラストバー+サービス+サービスエリア+レビュー+CTA直接的、信頼構築、地域ターゲット
ポートフォリオ作品の展示ヒーロー+プロジェクトグリッド+About+プロセス+お問い合わせビジュアル重視、コピーは最小限、作品で語らせる
SaaS / プロダクトサインアップ/トライアルヒーロー+機能+料金プラン+お客様の声+FAQ+CTAベネフィット重視、比較主導

ローカルサービスサイト: ホームサービスや請負業者のサイトを構築する前に、以下のローカルサービスCROルールセクションを参照してください。ほとんどのローカルサイトのコンバージョン率は1%未満です。これらのルールにより、3~5%を目指します。


ローカルサービスCROルール

出典: Noah Igler (@noahiglerSEO) によるホームサービスサイト(配管工、HVAC、屋根職人、電気工事士、造園業者など)のコンバージョン監査。ほとんどのサイトはトラフィックは良いが電話が鳴らない。それは、サイトがトラフィックではなくリードを逃しているからです。

ほとんどのホームサービスサイトのコンバージョン率は1%未満です。これらのルールは、同じトラフィックで3~5%を目指します。

ファーストビュー(コンバージョンの80%はここで決まるか失われる)

訪問者は着地から3秒以内に、何をしているのか、どこでしているのか、信頼できるのか、そしてどのように電話すればいいのかを理解しなければなりません。以下の要素はすべて必須であり、オプションではありません。

  • 見出しの形式: "[サービス] in [都市名]" または "[都市名]の信頼できる[サービス]会社" — "2003年以来のお客様の信頼できるホームサービスパートナー" ではありません。
  • 電話番号: 右上、大きなフォントで、スクロール時に固定。tel: リンクに直接配線します(モーダル、ポップアップ、確認ステップは不要。あるクライアントではモーダルが原因で電話が30%減少しました)。
  • トラストバー/サブ見出し: 星評価+レビュー数+営業年数+許可証番号+サービスエリア — すべてヒーローセクションに表示します。
  • プライマリCTA: "今すぐ電話" または "無料見積もりを取得" — 電話番号をボタンの上、またはすぐ下に表示します。
  • ヒーロー画像: ブランドシャツを着たチーム、現場のトラック、実際の作業のリアルな写真を使用します。笑顔の家族のストックフォトは使用しないでください(訪問者はすぐに見抜き、信頼はマイナスに転じます)。

電話の視認性 — 最大のレバレッジ

  • スティッキーヘッダー: モバイルでスクロール中も電話番号が常に表示されるようにします。
  • モバイルのスティッキーフッターバー: 2つのボタン — "今すぐ電話" (tel: リンク) と "オンライン予約" を常に表示します。
  • 長いページにはフローティングアクションボタンを設置します。
  • 実際には、発信量が15~25%増加します。

フォーム — 項目が1つ増えるごとに、コンバージョンが約10%減少する

ホームサービスリードフォームの最大項目数は4:

  1. 名前
  2. 電話番号
  3. 必要なサービス(ドロップダウン — 自由記述不可)
  4. 住所

絶対に追加してはいけないもの: メールアドレス、「折り返し電話に最適な時間」、「どこで知りましたか?」、コメント欄、住所確認、その他の質問。これは与信審査ではありません。折り返し電話をかけられるように電話番号を取得しているのです。絞り込みは電話で行います。

モバイル速度 — 絶対条件

  • モバイルでPageSpeed 50未満 = マップパックのスポットを2~3つ失う
  • PageSpeed 70未満 = モバイル訪問者の20~30%がページ読み込み前に離脱
  • 目標: モバイルPageSpeed 70以上、ページ読み込み2秒未満

速度改善策(効果の高い順):

  1. ヒーロー画像を200~400KBに圧縮(ほとんどのサイトは2~3MBのヒーロー画像を配信している)
  2. 不要なプラグインとトラッキングスクリプトを削除する
  3. 本物のCDNを使用する(ホストのバンドルオプションだけではない)
  4. ファーストビューより下はすべて遅延読み込みする
  5. サードパーティのウィジェット(ライブチャット、ソーシャル埋め込み、レビューアグリゲーター)を最小限にする — 読み込みが遅く、電話番号を隠してしまう

レビュー / ソーシャルプルーフ — すべてのスクロール深度で表示する必要がある

すべてのプルーフを途中の1つのお客様の声セクションにまとめないでください。訪問者はあらゆるレベルでそれを見る必要があります。

  • ファーストビュー: "Googleレビュー312件、評価4.9" — ヒーローのトラストバーに件数と評価を表示します。
  • ヒーローセクション: 実際のレビューからの短い引用を2~3つ、できればGBPから動的に表示します。
  • サービスページ: その特定のサービスに言及した引用を集めた専用のレビューセクション。
  • フォームのそば: 呼びかけの直前にプルーフを再度表示します。

目標: フォームにたどり着くまでに、プルーフを5~6回見た状態にすること。

写真 — ストックよりもリアルな写真を常に

  • 現場でブランドシャツを着たチームのリアルな写真
  • 実際の顧客宅に停めてあるトラック
  • ビフォーアフター写真(排水管清掃、配電盤作業、エアコン設置、ダクト工事、屋根交換)
  • 許可証、メーカー認定証、保険証書を写真に撮って表示する
  • サイトは、マーケティング代理店がロゴを挿入したテンプレートではなく、実際の従業員がいる物理的なビジネスのように見えるべきです。

資金調達 — 高額サービス(50万円以上)には必須

交換レベルの仕事では、顧客の約60%が資金調達を希望します。競合他社がSynchrony/GreenSky/Wisetackのロゴを表示していて、あなたが表示していなければ、あなたが見積もりを出す前に彼らが契約を成立させてしまいます。

  • 資金調達パートナーのロゴをサービスページのファーストビューに表示する
  • "0%金利でのお支払いが可能" または "月額たったの1万円から" といった文言をヒーローセクションに表示する
  • メインナビゲーションからリンクされた専用の資金調達ページを用意する
  • 高額サービスページに事前審査ウィジェットを埋め込む

コンバージョンを損なうよくある間違い

これらは監査で頻繁に発生します。絶対に出荷しないでください。

  • リードを「絞り込む」ための長いフォーム — 絞り込むのではなく、失っているのです
  • フォーム入力を強制するために電話番号を隠す — 訪問者はただ離脱するだけです
  • ヒーローセクションでの動画の自動再生 — モバイル速度を低下させ、訪問者をいらだたせます
  • 初回訪問時のポップアップ — モバイルではすぐに戻るボタンを押されます
  • ライブチャットウィジェット — 読み込みに4秒かかり、電話番号を隠し、ホームサービスには何の価値も追加しません

技術スタック(すべてのプロジェクト)

ツールパッケージ目的
Next.js 15nextApp Router、サーバーコンポーネント、サーバーアクション
React 19reactUIフレームワーク
TypeScripttypescript型安全性
Tailwind CSS v3tailwindcssユーティリティファーストスタイリング(v3 — v4は不可、v4はPostCSSに問題があります)
shadcn/uishadcn (CLI)コンポーネントライブラリ(Radix + Tailwind)
Motionmotionアニメーション(スプリング物理、スクロール、レイアウト)
Lenislenisスムーススクロール(4kb未満、アクセシブル)
Lucide Reactlucide-reactSVGアイコン

オプション(必要なときにインストール)

ツールパッケージ使用時
Pretext@chenglou/pretextDOMリフローなしのテキスト測定 — 仮想化リスト、チャットUI、メーソンリーグリッド、自動サイズ調整テキストコンテナ、canvasテキストレンダリング。getBoundingClientRectより約500倍高速。依存関係ゼロ。/mnt/shared-skills/pretext/SKILL.md を参照
GSAPgsap複雑なスクロールシーケンス、SplitText、MorphSVG
Three.jsthree + @react-three/fiber3D背景またはヒーロー要素
MDX@next/mdxリッチコンテンツのブログ
Prismaprismaデータベースアクセス

13フェーズのワークフロー

これらのフェーズを順番に実行してください。フェーズをスキップしないでください。フェーズ1〜4ではコードは一切生成しません。リサーチと計画を生成します。それが重要なポイントです。

フェーズ1: 発見

読む: instructions/brand-intake.md

何よりも先に、クライアントにブランドインテイクの質問をします。

  • ビジネスアイデンティティ、業界、ターゲット顧客
  • ブランドカラー、トーン、個性
  • SEO目標、競合他社、顧客が何を検索しているか
  • 必要なページ、特別な機能、プライマリCTA
  • サイトタイプ(SEOリード獲得、ローカルサービス、ポートフォリオ、SaaS)

成果物: 入力済みのインテイク回答

フェーズ2: セットアップ

読む: instructions/folder-setup.md

プロジェクトディレクトリ内に ai/ フォルダ構造を作成します。

  1. すべてのリサーチディレクトリ(01-07)を作成する
  2. デザイン、コンテンツ、ブログリサーチのディレクトリを作成する
  3. research-status.json を初期化する
  4. インテイク回答から 01-business-profile/profile.md に入力する

成果物: ビジネスプロフィールが入力された完全な ai/ フォルダ構造

フェーズ3: リサーチ(基礎 — 急がないこと)

読む: instructions/research-plan.md

後続のすべてに影響を与える6つのリサーチタスク。

  1. キーワードリサーチ — プライマリ、セカンダリ、ロングテール、ロケーションカテゴリにわたって50〜100以上のキーワードを見つける。ai/research/02-keyword-research/ に文書化する。Googleを検索し、PAAの質問を取得し、キーワードクラスターを構築する。

  2. 競合他社の詳細分析 — 5〜10の競合サイトを詳細にレビューする。各サイトについて、ホームページのセクション、ヒーローレイアウト、CTA、ビジュアルデザイン、タイポグラフィ、アニメーション、コンテンツ品質、強み、弱みを文書化する。ai/research/03-competitor-analysis/site-reviews/ に競合ごとのレビューファイルを作成する。その後、pattern-analysis.md(ニッチ全体の共通パターン)と gaps-opportunities.md(我々が活用するギャップ)にまとめる。

  3. コンテンツ戦略 — すべてのページをマッピングする: URL、キーワード、セクション、H1、メタタグ。ai/research/04-content-strategy/content-briefs/ にページごとのコンテンツブリーフを作成する。PAA、Reddit、フォーラムからFAQの質問をリサーチする。

  4. トピックマップ — トピッククラスターアーキテクチャを構築する: ピラーページ、クラスターコンテンツ、内部リンク戦略。ai/research/05-topical-map/ に文書化する。

  5. ローカルSEO(該当する場合) — ターゲットサービスエリア、ローカル競合他社、都市別キーワード。ai/research/06-local-seo/ に文書化する。

  6. コンバージョンパターン — 競合他社のCTA、トラストシグナル、ソーシャルプルーフパターンを分析する。コンバージョンファネルをマッピングする。ai/research/07-conversion-patterns/ に文書化する。

成果物: 7つのディレクトリに20〜40のリサーチファイル。research-status.json を更新する。

フェーズ4: デザイン計画(思考フェーズ — すべての決定に意図がある)

読む: instructions/design-plan.md

ここで、サイトが「また別のテンプレート」から「機能するもの」へと変わります。6つのデザインドキュメント。

  1. 競合他社ビジュアル監査 (ai/design/competitor-visual-audit.md) — すべての競合サイトのビジュアルパターンをレビューする: ヒーロータイプ、セクション順序、カラースキーム、タイポグラフィ、アニメーション、写真スタイル。ビジュアル品質でランク付けする。打ち負かすべき点を特定する。

  2. スタイルの方向性 (ai/design/style-direction.md) — 理由を添えて美学を選択する。色、フォント、ダーク/ライトモード、スペーシング — すべての選択は、ブランドインテイク+競合分析+業界のコンテキストに遡ることができる。

  3. コンポーネント計画 (ai/design/component-plan.md) — 必要なすべてのコンポーネントを順番に、その目的とともに。なぜこのヒーローレイアウトなのか?なぜこのトラストバースタイルなのか?なぜこれらのセクションがこの順序なのか?コンバージョンファネルにマッピングする。

  4. アニメーション計画 (ai/design/animation-plan.md) — 何が、なぜ、どのように動くか。エントランスアニメーション、ホバー状態、スクロールエフェクト。意図的なモーションであり、ランダムな装飾ではない。

  5. ページワイヤーフレーム (ai/design/page-wireframes.md) — すべてのページのセクションバイセクションのレイアウト。構造を示すASCIIワイヤーフレーム。

  6. デザインブリーフ (ai/design/design-brief.md) — マスタードキュメント。すべてのデザイン決定を要約し、このサイトを競合他社よりも「目立たせる」ものをリストアップし、すべての選択をリサーチに結び付ける。

成果物: 6つのデザインドキュメント。デザインブリーフはビルド全体のリファレンスとなります。

フェーズ5: スキャフォールド

読む: instructions/architecture.md 使用する: templates/project/ ディレクトリ

  1. templates/project/ を Websites/<project-name>/ にコピーする
  2. pnpm install を実行する
  3. shadcnをインストールする: pnpm dlx shadcn@latest init
  4. コアshadcnコンポーネントをインストールする: pnpm dlx shadcn@latest add button card badge separator input textarea label
  5. アニメーションの依存関係をインストールする: pnpm add motion lenis
  6. gitを初期化し、スキャフォールドをコミットする
  7. プライベートGitHubリポジトリを作成し、プッシュし、web-dev ブランチを作成する
  8. templates/config/claude-project.md を使用して .claude/CLAUDE.md を記入する

フェーズ6: デザインシステム

読む: instructions/design-system.md 使用する: templates/config/design-system.json

  1. templates/config/design-system.json を自分のものとしてコピーする
  2. デザインブリーフで決定した色、フォント、スペーシング、角丸で設定する
  3. CSS変数を global.css に実装する
  4. 全てのセクションで使用するベースコンポーネント(Button, Card, Badge, Input など)にスタイルを適用する
  5. ライトモードとダークモードの両方のバリエーションをテストする

フェーズ7: レイアウト

読む: instructions/layout.md

  1. ルートレイアウト (app/layout.tsx) を設定する。メタデータ、フォント、プロバイダーを含める。
  2. ナビゲーションバーを作成する。ワイヤーフレームの構造に従う。
  3. フッターを作成する。すべての必須リンクと情報を含める。
  4. ページトランジションまたはアニメーションプロバイダーを設定する(Motion/Lenisを使用)。

フェーズ8: セクション構築

読む: instructions/sections.md

デザインブリーフとワイヤーフレームに従って、一度に1セクションずつ構築する。一般的な順序:

  1. ヒーロー
  2. トラストバー/ソーシャルプルーフ
  3. サービス/製品/カバレッジグリッド
  4. 仕組み/プロセス
  5. FAQ
  6. お客様の声/レビュー
  7. CTA/お問い合わせ
  8. About/
  9. ブログ/リソース(該当する場合)
  10. ギャラリー/ポートフォリオグリッド(該当する場合)
  11. 価格設定/比較(該当する場合)

フェーズ9: コンテンツとコピー

読む: instructions/copywriting.md

  1. キーワードリサーチで特定した特定のターゲットキーワードを使用して、すべてのコピー(見出し、サブ見出し、本文)を書く。
  2. 見つかったプレースホルダーコンテンツをすべて置き換える。
  3. フェーズ3のコンテンツブリーフに従って、内部リンクとアンカーテキストを実装する。
  4. CTAのコピーを洗練させ、行動を促すものにする。
  5. すべての画像altテキストが説明的でキーワードが含まれていることを確認する。

フェーズ10: レスポンシブ QA

  1. すべてのページをモバイル、タブレット、デスクトップでテストする。
  2. 壊れたレイアウト、はみ出したテキスト、重なった要素を修正する。
  3. ヒーロー画像がすべての画面サイズで正しく表示されることを確認する。
  4. 電話番号とCTAがモバイルで常に表示され、タップ可能であることをテストする。
  5. モバイルデバイスでタッチターゲットが十分な大きさであることを確認する。

フェーズ11: パフォーマンス

  1. PageSpeed Insightsでテストする。
  2. 画像を圧縮し、フォーマットを最適化する(WebP/AVIF)。
  3. JavaScriptのバンドルサイズを分析する。
  4. クリティカルCSSをインライン化し、フォント読み込みを最適化する。
  5. 目標: モバイルPageSpeed 70以上、読み込み時間2秒未満。
  6. Lighthouseのアクセシビリティスコアを確認し、問題を修正する。

フェーズ12: 監査

  1. プレースホルダースイープを実行する — すべてのテキスト、画像、リンクを確認する。
  2. CRO監査を実行する — ローカルサービスルールを確認する。
  3. 戻るボタンハイジャックをテストする。ループ、トラップ、モーダルチェーンがないことを確認する。
  4. アクセシビリティ監査を実行する — キーボード操作、ARIAラベル、色のコントラスト。
  5. モバイルQA — 実際のデバイスかエミュレーターですべてのページを確認する。
  6. 最終レビュー — すべてがデザインブリーフとワイヤーフレームに一致していることを確認する。

フェーズ13: デプロイ

  1. 本番環境用にビルドする (pnpm build)
  2. Vercelでデプロイする(またはクライアントのホスティング)
  3. 環境変数が設定されていることを確認する
  4. 本番URLで最終テストを実行する
  5. サイトを引き渡す

インテリジェントなトークン管理

読む: instructions/token-management.md

  • リサーチフェーズ(1〜4)は、プロジェクトの成否を左右するため、最大のコンテキストを消費します。これらのフェーズを急がないでください。
  • フェーズ5〜13では、前のフェーズからの関連する設計上の決定のみを含む、焦点を絞ったプロンプトを使用します。
  • 各フェーズの開始時に、research-status.json を参照して、何が完了しているかを確認します。
  • コード生成中にトークンが不足しそうになった場合:
    1. 最も重要なセクション(ヒーロー、CTA)を優先する
    2. 標準的なセクションには最小限のプレースホルダーコメントを使用する
    3. 必要に応じて continue を使用する
    4. 不足している場合は、最も影響の大きいコンポーネントを完了させてから停止することをユーザーに通知する

ディレクトリ構造

Websites/
└── <project-name>/
    ├── ai/
    │   ├── research/
    │   │   ├── 01-business-profile/
    │   │   ├── 02-keyword-research/
    │   │   ├── 03-competitor-analysis/
    │   │   │   └── site-reviews/
    │   │   ├── 04-content-strategy/
    │   │   │   └── content-briefs/
    │   │   ├── 05-topical-map/
    │   │   ├── 06-local-seo/
    │   │   └── 07-conversion-patterns/
    │   ├── design/
    │   └── blog-research/
    ├── app/
    ├── components/
    ├── lib/
    ├── public/
    ├── styles/
    ├── .claude/
    │   └── CLAUDE.md
    └── package.json

フェーズ進行の依存関係

graph TD
    P1[Phase 1: 発見] --> P2[Phase 2: セットアップ]
    P2 --> P3[Phase 3: リサーチ]
    P3 --> P4[Phase 4: デザイン計画]
    P4 --> P5[Phase 5: スキャフォールド]
    P5 --> P6[Phase 6: デザインシステム]
    P6 --> P7[Phase 7: レイアウト]
    P7 --> P8[Phase 8: セクション構築]
    P8 --> P9[Phase 9: コンテンツとコピー]
    P9 --> P10[Phase 10: レスポンシブ QA]
    P10 --> P11[Phase 11: パフォーマンス]
    P11 --> P12[Phase 12: 監査]
    P12 --> P13[Phase 13: デプロイ]

重要: フェーズ1〜4の前にコードを書いたり、デフォルトのセクションをレンダリングしたりすると、サイトの品質が低下します。抵抗してください。プロセスを信じてください。

関連スキル