Communitygithub.com

BitCrowder/website-builder-skill

AIエージェントがプロダクトストラテジスト兼デザインディレクターのように誘導し、漠然としたアイデアから完成度の高いウェブサイトを構築するためのスキルです。

website-builder-skill とは?

このスキルは、AIエージェント(Claude Code、Coder、Cursorなど)がウェブサイト制作をゼロからプロフェッショナルに導くためのワークフローを提供します。単にコードを生成するのではなく、プロジェクトの明確化、ビジュアルリファレンスの分析、情報設計、アセット管理、段階的な反復、レスポンシブQA、そしてデプロイ準備までを、デザインディレクターのような役割で段階的に実行します。具体的には、まずユーザーに対して的確な質問を投げかけ、プロジェクトのポジショニングを定義。次に、ワイヤーフレームではなく「なぜユーザーが読み進めるか」に基づいた情報設計テーブルを作成します。参照画像が提供された場合は、スタイル、配色、タイポグラフィなどを分析し、コピーではなくプロジェクトに合わせたビジュアル方向性を合成します。その後、実際に動作するスケルトンコードを生成し、画像を分類・マッチング。コードレビューではなく視覚的な観点から3〜5つの課題ずつ反復改善を行い、最終的にはVercelやNetlifyなどのデプロイプラットフォームを選定して公開準備を整えます。このスキルは、ランディングページ、ポートフォリオ、プロダクトサイト、ローカルサービスサイト、ECショーケース、コース販売ページ、AIツールディレクトリなど、あらゆるWebプロジェクトに適用可能で、「デザイン意図を実装で損なわない」ことを重視します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BitCrowder/website-builder-skill/tree/HEAD/build-website-with-ai

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

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

ドキュメント

AIでウェブサイトを構築する

概要

このスキルを使用して、漠然としたウェブサイトのアイデアを、ディレクターのようなワークフローを通じて実際に使えるウェブサイトに変えます。プロジェクトの明確化、リファレンスの分析、構造化されたドラフトの構築、実際のアセットのマッピング、小規模なパスでの反復、デスクトップ/モバイル品質の確認、デプロイの準備を行います。

ユーザーがすでに明確なプロジェクト概要、ビジュアルの方向性、コンテンツ、ビルドターゲットを提供していない限り、いきなりコードに飛びつかないでください。このスキルの主な価値は、AIが適切な質問をし、実装中にデザインの意図を保持することにあります。

ワークフロー

1. 構築前に明確化する

プロジェクトが漠然としている場合は、まず8〜12の重要な質問をすることから始めてください。以下のトピックをカバーします。

  • ターゲットユーザー
  • ユーザーがサイトにアクセスした際の意図
  • 望ましいコンバージョンアクション
  • 競合他社やカテゴリとの違い
  • ホームページのメッセージ
  • 必要なページまたはセクション
  • 必須コンテンツ
  • ビジュアルの個性
  • サイトを本物らしく見せるために不足している情報

ユーザーが答えられない場合は、明示的に合理的な仮定を立て、それらを仮定としてラベル付けします。

答えをプロジェクトのポジショニング概要に変換します。

  • 一行のポジショニング
  • ターゲットユーザー
  • ペインポイント
  • コアオファーまたはセールスポイント
  • コンバージョン目標
  • ページ構造
  • ホームページのセクション順序
  • ビジュアルキーワード
  • 必要なコンテンツ
  • 後回しにするコンテンツ

明確化とポジショニングのフェーズで使用可能な中国語のプロンプトが必要な場合は、references/prompts.mdを参照してください。

2. 情報設計を行う

コーディングの前に、以下の情報を含むテーブルを作成します。

  • セクションの順序
  • セクション名
  • ユーザーが見るもの
  • ユーザーが読み進める理由
  • 必要なアセット

ホームページが、一般的なモジュールの単なる寄せ集めではなく、自然な意思決定のパスのように読めるようにします。各セクションは、ユーザーの質問に答え、信頼を構築するか、ユーザーをコンバージョンアクションに近づける必要があります。

3. ビジュアルリファレンスを分析する

ユーザーがスクリーンショット、ウェブサイト、アプリ画面、ポスター、ブランド画像、競合他社のページを提供した場合は、構築する前にそれらを分析してください。直接コピーしないでください。

以下の点を抽出します。

  • スタイルキーワード
  • 色とコントラストの振る舞い
  • タイポグラフィの階層
  • スペーシングとレイアウトのリズム
  • カード、ボタン、ナビゲーション、セクションパターン
  • 画像とテキストの比率
  • モーションやプレミアム感の手がかり
  • このプロジェクトに適合するものと、破棄すべきもの

ユーザーのプロジェクトに合ったビジュアルの方向性を合成します。ホワイトスペース、階層、抑制、リズム、モーションなどの有用な品質を保持しつつ、実際のビジネス目標に合わせて構造とコピーを再設計します。

4. ウェブサイトの骨格を構築する

完全なセクション順序、実際の見出し、ドラフトコピー、コールトゥアクション、基本的なインタラクション、画像プレースホルダーを備えた、実行可能な最初のバージョンを作成します。

各プレースホルダーには、ヒーロービジュアル、プロダクト写真、ケーススタディ画像、チーム画像、プロセス図、ロゴ、お客様の声のポートレート、背景テクスチャなど、意図された画像の種類をラベル付けします。

以下の点を優先します。

  • プロジェクトのロジック
  • ページのリズム
  • ファーストスクリーンの明瞭さ
  • ビジュアルの方向性
  • レスポンシブ構造
  • 読みやすく具体的なコピー

完璧な画像を待ってから役立つドラフトを作成するのではなく、先に進めてください。

5. 画像を処理してマッチングする

ユーザーが多くの画像を提供した場合は、オリジナルを assets/raw-images/ に配置するよう依頼してください。元のファイルは保持します。

次に以下の手順を実行します。

  1. 画像の内容を検査する
  2. 用途別に分類する
  3. 明確な英語のファイル名で処理バージョンをリネームまたはコピーする
  4. 最適化されたウェブ対応バージョンを assets/processed/ に配置する
  5. 画像をページセクションにマッチングする
  6. 画像の引き伸ばしや歪みを避ける
  7. 不確かな配置はプレースホルダーとして残し、不足しているものを説明する

コード変更の前またはそれと同時に、画像割り当てテーブルを出力します。ユーザーが画像の配置を修正した場合は、マッピングと必要なスタイルのみを変更し、ページ全体を書き換えないでください。

6. デザインディレクターのように反復する

コードだけでなく、視覚的な結果をレビューします。以下の点を確認します。

  • ファーストスクリーンが、誰のためのものか、何を提供しているかを3秒以内に説明しているか
  • モジュールの順序が自然な販売または信頼構築のパスをサポートしているか
  • コピーが一般的なAIマーケティングテキストではなく、具体的に聞こえるか
  • 画像がコンテンツとマッチしているか
  • ボタンとコンバージョンパスが明確か
  • デスクトップとモバイルのレイアウトが両方とも機能しているか
  • テキストの重なり、画像の歪み、スペーシングの乱れがないか

一度に3〜5の問題を小さな反復で行うことを優先します。すでに機能している強力なビジュアル特性(階層、ホワイトスペース、カードのリズム、控えめなモーションなど)は保持します。

最終QAを準備するとき、またはユーザーが何を検査すべきか尋ねたときは、references/checklists.mdを参照してください。

7. 起動前に検証して準備する

サイトを完成と呼ぶ前に、以下の手順を実行します。

  • プロジェクトで利用可能なビルドまたは静的検証コマンドを実行する
  • ブラウザツールが利用可能な場合は、デスクトップビューとモバイルビューを検査する
  • 画像パス、リンク、ボタン、フォーム、ナビゲーションを確認する
  • 実際のコンテンツが存在する場合は、未使用のプレースホルダー専用コンテンツを削除する
  • 残っている仮定や不足しているアセットを報告する

デプロイには、プロジェクトまたはユーザーのリクエストに合ったプラットフォーム(Vercel、Netlify、Cloudflare Pages、GitHub Pages、既存のホスティング設定など)を選択します。クリーンアップ中にソースアセットを削除しないでください。

推奨プロジェクトフォルダ構成

ゼロから始める場合は、この構造を使用するか、それに適合させてください。

my-website/
  references/        ビジュアルリファレンスと競合他社のスクリーンショット
  assets/
    raw-images/      未加工の元の画像
    processed/       最適化されたウェブ対応画像
  notes/             プロジェクトノートとコピー
  prompts/           保存されたプロンプトと決定事項
  website/           生成されたウェブサイトのコード

一般的な開始点

  • ポートフォリオ:個人のポジショニング、仕事のカテゴリ、サービス、証明、連絡先パスを明確化します。
  • プロダクトサイト:プロダクト名、ペインポイント、差別化、証明、コンバージョンパスを明確化します。
  • ローカルサービスサイト:サービスエリア、信頼の証拠、予約または相談のフローを明確化します。
  • ECショーケース:プロダクトカテゴリ、購入動機、カードコンテンツ、詳細ページの構造を明確化します。
  • コースランディングページ:学習者の悩み、約束された成果、カリキュラム、証明、価格設定、サインアップパスを明確化します。

関連スキル