Communitygithub.com

webbuild

事業主が料金を払いたくなる本格的なビジネスウェブサイトを構築します。AIらしさを排除し、スクロールで制御する「3D」ヒーロー(AI動画をスクロールで同期)、Three.js / React Three Fiber のリアルタイムシーン、GSAP + Lenis アニメーション、ビデオシェーダーなどを駆使。企画立案から、リファレンスサイトのリバースエンジニアリング、デザインシステム、ヒーロー制作、パフォーマンス・アクセシビリティ、視覚QA、スロップチェッカー、デプロイ、そして地元企業への提案まで対応します。ユーザーがウェブサイト構築・リデザイン・磨き上げ、3Dウェブサイト、スクロールアニメーション、Awwwards風や高額サイト、Three.js/GSAP/Spline を扱いたい、他のサイトを参考にしたい、ビジネスサイトを売り込むために再構築したい、あるいはサイトがAIスロップのように見えると不満を言うときはいつでも使用してください。

webbuild とは?

webbuild は、Claude Code などの AI エージェント向けに設計された、高品質なビジネスウェブサイトを構築するためのスキルです。このスキルの核となるのは、「AI が作った」と一目でわかるような安っぽいサイトではなく、実際に事業主が費用を支払いたくなるような、洗練された個性的なサイトを作ることです。具体的には、企画段階での綿密なヒアリング、リファレンスサイトの自動分析(テクノロジースタック、フォント、カラーパレット、シェーダーなどを解析)、AI らしさを排除するデザインシステムの適用、スクロール連動型の3Dヒーロー動画や Three.js シーンといった高度な演出、そして厳格な QA プロセスを備えています。特に、出力品質を保証するために、スクリーンショットによる視覚チェックや、AI スロップ(安っぽいAI生成感)を検出する専用リンター(slop_check.py)が組み込まれている点が特徴です。また、デプロイから最終的なプレゼンテーション資料の作成までをサポートし、開発から顧客への提案まで一貫したワークフローを提供します。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Harishisonline/webbuild-skill/tree/main

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

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

ドキュメント

webbuild は何をしますか?

事業主が料金を払いたくなるウェブサイトを作る:そのビジネスに特化し、スマホで高速、一つの記憶に残る瞬間を持ち、「AI が作りました」と叫ぶような要素は一切排除します。技術のほとんどは、コードを書く前の選択と、結果を正直に評価することにあります。

以下のパスは、このスキルのフォルダ(scripts/、references/、assets/)からの相対パスです。

0. プロジェクトのセットアップ(2分)

  • 新規サイト → assets/starter/ をプロジェクトフォルダにコピー(プレーンなHTML + CSS + ESモジュール、バージョン固定のCDNインポート、ビルドステップ無し:どこにでもデプロイでき、編集も簡単)。ユーザーが明示的に希望するか、プロジェクトが既にそれらを使用している場合のみ、Next.js / Astro / R3F を使用します(references/3d-playbook.md §5)。
  • 既存プロジェクト → フレームワーク、トークン、コンポーネントはそのまま維持。このスキルは方向性、モーション、QAを追加するものであって、書き換えではありません。
  • プロジェクトのルートに BUILD_NOTES.md を作成します。これはコンテキストリセット間のメモリとして機能します:概要、決定事項、未解決の質問、うまくいった修正内容を記録します。

1. ブリーフ — 本当のビジネスを理解する

(ユーザー、ビジネスの現在のサイト、Googleビジネスプロフィール、Instagramから)以下の情報を収集します:会社名、提供内容、所在地、創業時期、最も重要なアクション(電話 / 予約 / 注文 / 見積もり / 来店)、実際の証拠(評価と件数、実績年数、ライセンス、掲載実績)、実際の写真、ロゴ/カラー、営業時間、住所、電話番号。references/design-system.md §2 の5行のブリーフを BUILD_NOTES.md に書き込みます。

事実を決して捏造しないでください。捏造されたレビュー、統計、価格、住所は、オーナーが読んだ瞬間に信頼を破壊します。代わりに以下のようにします:

  • 不明な点は回避して記述し、デモが完成しているように見せます:架空の番地ではなく「プネ、コレガオンパーク」;架空の引用ではなく「Google評価4.7」;価格不明のサービス名、または確実に分かっている場合のみ「₹…から」。
  • 事実が本当に必要な場合(電話番号、正確な住所、営業時間)は、可視の {{プレースホルダ}} を使用します — slop_check.py はこれが埋められるまで出荷をブロックします。
  • 全ての不明点と仮定は、最終報告用の「クライアントに確認する」リストにまとめます。

クリエイターやチャンネルサイトの場合、事前に(またはデータを取得して)ダッシュボードの数値とプロフィール写真を入手します:YouTube Studio / Instagramインサイトのスクリーンショット、およびvidIQ等の接続済みツール。実際の数字から構築された「結果」セクションが、提案を成功させます。

ブリーフが薄く、ユーザーがそばにいる場合は、最大3つの質問をします(ビジネスと都市、主要アクション、気に入っているサイト)。ユーザーに「とにかく進めて」と言われた場合は、合理的な仮定を立て、それを書き留めて、先に進みます。

2. リファレンス(ユーザーがサイト名を挙げた、録画を送った、または「リビルド」を希望した場合)

references/reverse-engineer.md に従います:node scripts/teardown.mjs <url> でスタック、フォント、パレット、メディア、シェーダーの証拠を測定し、スクロールのスクリーンショットを撮ります;画面録画はフレームとして読み取り、拍ごとのモーション仕様に変換します。簡単なパスで効果を説明できない場合は、REAのエンジンを使ってさらに深く掘り下げます:scripts/rea-teardown.sh <url> はページをキャプチャし、バンドルをフィンガープリントし、すべてのスクリプトをエクスポートして、どのように実際に構築されているかを読めるようにします(ガイドは references/rea/)。OBSERVED → INFERENCE → DECISION を記録します。テクニックを学びますが、ブランド、コピー、アセット、コードを決してコピーしないでください。

3. 方向性 — 計画を立て、計画を攻める

references/design-system.md(スロップ防止ルール — 古典的なものと、「趣味の良いAI」の兆候(クリーム×テラコッタ、大文字のアイブロー、エディトリアルなヘアライン))を読みます。BUILD_NOTES.md に以下を書きます:

  • ビジネスから取った4~6個の名前付きカラートークン、タイプペアリングと役割、角丸のルール
  • 各セクションのASCIIワイヤーフレーム(リズムを変える — ヒーロー → 3つのカード → ロゴ → お客様の声、の繰り返しにしない)
  • 特徴的な瞬間(正確に一つ)と、それがこのビジネスに適している理由
  • 個性的にするための3つの原則

次に、計画をスロップ兆候リストと照らし合わせてレビューし、デフォルトと読める選択については、このビジネスにとって正当化するか、変更します。「ロゴを入れ替えたら別のビジネスにも当てはまるだろうか?」と自問することで、ここでの問題のほとんどを低コストで発見できます。

ユーザーが方向性を決めかねている場合は、構築する前に2~3の真に異なる方向性(各静止画または簡単なHTMLスケッチ)を示します — 21st-ui-explore がインストールされていれば役立ちます。

4. ヒーロー — ビジネスに最適なモードを選ぶ

references/3d-playbook.md §1 に判断基準表があります。簡略版:

  • 静止画(優れた写真/タイポグラフィ)— 飲食店、食品、サロン、クリニック、サービス業。多くの場合、正しい選択です。
  • 動画 — 雰囲気ループ。理想的には assets/starter/grade.js で処理して、AI/ストック映像に特注のグレーディング(粒子、ハレーション、リフト/ガンマ/ゲイン、ビネット)を施します。LOOKを選び、控えめに保ちます。
  • フレーム — 「$10Kの3Dウェブサイト」:AIの開始/終了キーフレーム → 最初/最後のフレームの動画 → scripts/frames.sh → スクロールで操作するキャンバス。キーフレームのルール、プロンプト、ブレンドについては references/scroll-video-playbook.md を読んでください。
  • シーン — 3Dが製品のストーリーである場合(設定可能な製品、建築、テクノロジー)のライブThree.js / R3F。被写体はビジネスの核となるものでなければならず、プレースホルダーの結び目であってはなりません。
  • ページ全体 — オーナーが「3Dウェブサイト」を希望する場合、通常は3Dヒーローではなく、サイト全体に3Dを意味します。セクションごとに固定カメラステーションを持つ1つの固定シーンを使用します(references/3d-playbook.md §6)。

接続されているもの(Higgsfield / Kling / kie.ai / Nano Banana MCPsやスキル)でアセットを生成するか、ユーザーにファイルをドロップするよう依頼します。何も利用できない場合は、明確にラベル付けされたプレースホルダーで構築し、生成するアセットをプロンプトと共に正確にリストします。

5. 構築

順序:トークン(styles.css :root)→ 実際のコピーを含むセマンティックなHTMLセクション → 390pxと1440pxでのレイアウト → ヒーローモード → モーションは最後。

  • コピーのルール:references/design-system.md §8(成果 + 場所 + 具体性、実際のCTA動詞、禁止ワード)。
  • ビジネスサイトに必須:ページ上部と最後に明確なCTAを一つずつ、tel: / 予約 / フォーム、営業時間 + 住所 + マップリンク、実際の証拠、タイトル + 説明 + OG画像、LocalBusiness JSON-LD、ファビコン、アクションが電話の場合のモバイル用スティッキーな電話/予約バー。
  • モーション:一つの特徴的な瞬間 + 控えめな150~300msのマイクロフィードバック;イーズアウト、バウンスは禁止;transform/opacity のみ;動きの軽減設定では終了状態を表示。
  • コンポーネント:複雑なエフェクトを手書きする前に、references/resources.md のレジストリ(21st.dev、React Bits、Aceternity、Motion Primitives…)を検索し、トークンに再スタイリングします。静的サイトでは、一つのエフェクトのためにReactを追加するのではなく、Reactコンポーネントをバニラで再構築します。
  • フッター:references/design-system.md §11 に従って構築します(ブランドブロック、プラットフォームロゴ付きリンク列、お問い合わせボタン、特大ワードマーク、最下行)。オーナーはフッターでサイト全体を判断します。小さなビルダークレジットはスターターに既に含まれています;クライアントは削除を依頼できます。
  • ボタンとスクロール:references/design-system.md §12 に従います(触感のある0.16秒のボタン、スターターの cursor.js によるカーソルリング、ネイティブスクロールバー無し:スターターの blockbar.js が置き換えます)。
  • 完了と呼ぶ前に、references/design-system.md §10 を読み直してください:すべてのルールをパスしてもオーナーがまだスロップと呼ぶものです。

6. 確認する — ここで良いサイトが作られる

ローカルでサーブし(npx serve . またはプロジェクトの開発サーバー)、次に:

  1. node scripts/shoot.mjs http://localhost:3000 ./shots — スマホ / ノートPC / デスクトップのスクロールに沿ったスクリーンショット + コンソールエラー、オーバーフロー、LCP、重量。PNGを読んでください。(利用可能な場合はブラウザペインやPlaywright MCPも使用可。)また、--reduced-motion を付けて一度実行します。
  2. python3 scripts/slop_check.py . — 0 FAILで終了しなければなりません。WARNは質問として扱います。(npx impeccable detect もインストールされていれば良い二次チェックです。)
  3. ブリーフに照らして正直に批評します:階層、タイポグラフィ、カラー、特徴的な瞬間、モバイル、コピーの具体性。明確な意図を持ってバッチで修正します(「下のセクションが一般的に見える — もっと高級感を、ごちゃごちゃさせずに」)。
  4. 完了と呼ぶ前に、装飾要素を一つ削除します。

3~6ラウンドを想定してください;誰も一発では成功しません。何が何を修正したかを BUILD_NOTES.md に記録します。

7. 出荷 + 提案

  • デプロイ:Vercel / Netlify / Cloudflare Pages / GitHub Pages。フレームフォルダをコミットします(最も一般的な「本番環境でヒーローが消えた」バグ)。クライアントが購入するまで、スペックデモには <meta name="robots" content="noindex"> を追加します。
  • 提案用の場合、references/pitch-and-sell.md を読んでください:ビフォー/アフター動画、アウトリーチスクリプト、価格アンカー、提案準備完了チェックリスト、引き継ぎ。

ユーザーへの最終報告

簡潔かつ具体的に:

  • 構築したもの(方向性を一行で、特徴的な瞬間、ヒーローモード)と場所(パス、URL)
  • 実行方法(npx serve . または開発コマンド)
  • QA結果:slop_checkのFAIL/WARN数、shoot.mjsのビューポートごとのLCP/エラー、確認して修正した内容
  • クライアントに確認するリスト:全ての {{プレースホルダ}} と仮定
  • まだ生成すべきアセット(すぐに使えるプロンプト付き)(ある場合)

リファレンスマップ

読むものいつ
references/design-system.md常に、色/タイプ/レイアウト/コピーを選ぶ前に
references/3d-playbook.mdヒーローを選ぶとき;Three.js/R3F全般;パフォーマンス + a11yの予算
references/scroll-video-playbook.mdAI動画からのスクロール同期「3D」ヒーロー
references/reverse-engineer.mdリファレンスサイト、録画、見込み客サイトのリビルド
references/rea/README.mdREAのツールでteardown.mjsより深く掘り下げる
references/resources.mdコンポーネントレジストリ、エフェクトツール、インスピレーション、補助スキル
references/pitch-and-sell.md見込み客向けスペックサイト、価格設定、アウトリーチ、引き継ぎ
スクリプト機能
scripts/teardown.mjs <url>リファレンスサイトの測定(スタック、フォント、パレット、メディア、シェーダー、スクリーンショット)
scripts/rea-teardown.sh <url>REAエンジンによる詳細解析:ページキャプチャ、バンドルフィンガープリント、エクスポートされたスクリプト
scripts/frames.sh <video> <out>動画 → WebPフレームシーケンス(デスクトップ + モバイル)+ マニフェスト
scripts/shoot.mjs <url> [out]3つの幅でスクロールに沿ったスクリーンショット + エラー/LCP/オーバーフロー
scripts/slop_check.py <dir>AIスロップ + 出荷準備状態リンター(出荷には0 FAIL)

.mjs スクリプト用のPlaywright:npm i -D playwright && npx playwright install chromium。

関連スキル