Communitygithub.com

sandbox-safemode/365-castle-logos

差別化された、プロダクション品質のウェブサイトを構築します。タイプ、色、動き、レイアウトのすべての選択が意図的である必要があります。静的なHTML/CSS/JSバンドルとしてS3にデプロイします。

365-castle-logos とは?

これは、AIエージェント(Claude Code、Cursor、Codexなど)用のスキルで、一般的な「AIスラップ」的な美学を避け、意図的なデザイン選択に基づいたプロダクション品質のウェブサイトを構築するための包括的なガイドです。このスキルは、情報サイト、ウェブアプリケーション、ブラウザゲームなど、さまざまなプロジェクトタイプをサポートし、プロジェクトタイプに応じてドメイン固有のガイダンスを読み込むためのルーティングメカニズムを提供します。デザインの基礎(カラーパレット、タイポグラフィ、レイアウト)から、実装、テスト、デプロイまでのワークフローをカバーし、SVGロゴの生成やPlaywrightを使用したビジュアルQAテストも含まれます。このスキルは、静的HTML/CSS/JSバンドルをS3にデプロイするための`deploy_website()`関数を提供し、ウェブアプリケーションの場合は子スキル`website-building/webapp`を読み込むことで、より高度な機能を利用できます。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/sandbox-safemode/365-castle-logos/tree/HEAD/skills/website-building

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

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

ドキュメント

ウェブサイト構築

差別化された、プロダクション品質のウェブサイトを構築します。一般的な「AIスラップ」的な美学を避けます。タイプ、色、動き、レイアウトのすべての選択は意図的である必要があります。静的なHTML/CSS/JSバンドルとしてS3にデプロイします。

このスキルはウェブプロジェクトのすべてをカバーします。 load_skill("website-building") で読み込むと、すべてのファイルが workspace/ にコピーされます。プロジェクトタイプに応じて、必要に応じてサブファイルを読み取ってください。ウェブアプリケーションの場合は、子スキル load_skill("website-building/webapp") を読み込んでください。

ユニバーサルデザイン原則(カラー哲学、デフォルトパレット、フォント選択)は、design-foundations を介して他のスキルと共有されます。このスキルの共有ファイルは、これらの基礎をウェブ固有の実装(CSS変数、レスポンシブトークン、ベーススタイルシート)で拡張します。design-foundations を個別に読み込む必要はありません。shared/ 内のウェブ固有バージョンが包括的です。

read はフルパスで使用してください(例:shared/01-design-tokens.md)。


プロジェクトタイプルーティング

ステップ1:プロジェクトタイプを特定し、ドメイン固有のガイダンスを読み込む:\n

プロジェクトタイプアクション例
情報サイトread informational/informational.md個人サイト、ポートフォリオ、エディトリアル/ブログ、小規模ビジネス、ランディングページ
ウェブアプリケーションload_skill("website-building/webapp")SaaSプロダクト、ダッシュボード、管理画面、Eコマース、ブランド体験
ブラウザゲームread game/game.md + game/game-testing.md2D Canvasゲーム、Three.js/WebGL、HTML5ゲーム、インタラクティブ3D体験

ステップ2:共有ファイルを読む — 最初に shared/01-design-tokens.md と shared/02-typography.md を読んでください(すべてのプロジェクトタイプで必須。ウェブアプリも含む)。これらは、Nexusデザインシステムのデフォルトと、すべてに普遍的に適用されるタイポグラフィルールを確立します。ウェブアプリケーションとダッシュボードの場合は、以下の † が付いたファイルをスキップしてください。これらのファイルには、フルスタックテンプレートで事前設定された実装の詳細が含まれています。

ユーザーから「website」や「site」とだけ言われた場合は、タイプを尋ねるか、情報サイトをデフォルトにしてください。


サブファイルリファレンス

共有 (shared/) — すべてのプロジェクト

ファイル内容読み込み条件
shared/01-design-tokens.mdタイプスケール、間隔、Nexusパレット、base.css常に
shared/02-typography.mdフォント選択、ペアリング、読み込み、ブラックリスト常に
shared/04-layout.md空間構成、レスポンシブ、モバイルファースト常に †
shared/05-taste.mdスケルトンローダー、空/エラー状態、洗練常に
shared/08-standards.mdアクセシビリティ、パフォーマンス、アンチパターン常に
shared/09-technical.mdプロジェクト構造、サンドボックス、デプロイ、チェックリスト常に †
shared/03-motion.mdスクロールアニメーション、Motionライブラリ、GSAP SVGプラグイン、ホバー/カーソルアニメーションを使用する場合
shared/06-css-and-tailwind.mdTailwind CSS v3、shadcn/ui、モダンCSSTailwindを使用する場合
shared/07-toolkit.mdCDNライブラリ、React、Three.js、アイコン、マップ、SVGパターン/フィルター、esm.shライブラリを選択する場合
shared/10-charts-and-dataviz.mdChart.js、Recharts、D3、KPI、スパークラインデータ可視化が必要な場合
shared/11-web-technologies.mdフレームワークバージョン、ブラウザ互換性互換性を確認する場合
shared/12-playwright-interactive.md永続的なPlaywrightブラウザQA、スクリーンショット、ビジュアルテストテストする場合
shared/19-backend.mdFastAPI/Express/Flaskサーバー、WebSocket、SSE、ポートフォワーディングバックエンドが必要な場合
shared/20-llm-api.mdLLMチャット、画像/動画/音声生成、文字起こし — モデル、認証情報、SDKヘルパーサイトがAI/LLM APIを使用する場合

すべてのパスは、`` からの相対パスです。

† ウェブアプリとダッシュボードではスキップ — 実装の詳細はフルスタックテンプレートで事前設定されています。デザイントークンとタイポグラフィはスキップされません。これらは、すべてのプロジェクトタイプに対して信頼できるデザインシステムのデフォルトとフォント選択のガイダンスを提供します。

ドメイン固有 — 1つを読み込む

ファイル読み込み条件
load_skill("website-building/webapp")SaaS、ダッシュボード、管理画面、Eコマース、ブランド体験(フルスタックテンプレートを含む子スキル)
skills/website-building/webapp/dashboards.mdダッシュボードまたはデータ密度の高いインターフェース(webappの補足)
informational/informational.md個人サイト、ポートフォリオ、エディトリアル、小規模ビジネス、ランディングページ
game/game.mdブラウザゲーム、Three.js、WebGL、インタラクティブ3D
game/2d-canvas.md2D Canvasゲーム(game.mdの補足)
game/game-testing.md任意のブラウザゲーム — game.mdと一緒に読み込み

インタラクティブQA: shared/12-playwright-interactive.md を読んで、Playwrightを使用した永続的なブラウザ自動化(スクリーンショット、機能テスト、ビジュアルQA)を実行してください。ゲームテストには必須であり、複雑なサイト全般に役立ちます。


ワークフロー

  1. デザインの方向性:目的を明確にし、美的方向性を選択する
  2. バージョン管理:スキャフォールディング後、プロジェクトディレクトリで git init を実行する。主要なマイルストーンごとに、短いメッセージでコミットする。
  3. ビルド:サイトをページごとにビルドし、Playwrightでスクリーンショットを撮ってビジュアルQAを実行する
  4. 公開:すべての変更をコミットし、deploy_website() で公開URLを取得する

すべてのツールを使う

  • 最初に調査する。 デザインする前に、参考サイト、トレンド、競合事例をウェブで検索する。特定のサイトタイプの受賞歴のある例を閲覧する。ユーザーが提供したURLがあれば取得する。
  • 実際のアセットを惜しみなく生成する。 ヒーロー画像、セクションのイラスト、エディトリアル機能のビジュアル、雰囲気のある背景 — ヒーロー画像1つだけではありません。長いページにはすべて、サイトのアートディレクションにマッチした生成画像で視覚的なリズムを持たせる。プレースホルダーは使用しない。すべてのプロジェクトにカスタムSVGロゴを生成する(下記参照)— SVGはロゴ専用であり、ユーザーが明示的にSVG出力を要求した場合のみ使用する。方向性を示すウェブ参考画像を保存する。
  • Playwrightでスクリーンショットを撮る(複雑なサイトのみ)。 マルチページサイト、ウェブアプリ、ダッシュボード、ゲームの場合、skills/website-building/shared/12-playwright-interactive.md を読んで、デスクトップ(1280px以上)とモバイル(375px)でスクリーンショットを撮る。シンプルなシングルページの静的サイトではPlaywrightをスキップする — 以下のビジュアルQAを参照。
  • プロダクションコードを直接書く。 HTML、CSS、JS、SVG。ビルドツールやファイル処理にはbashを使用する。

SVGロゴ生成

すべてのプロジェクトは、カスタムインラインSVGロゴを取得します。スタイル付きテキストの見出しで代用しないでください。

  1. ブランドを理解する — 目的、トーン、1つの定義語
  2. SVGを直接書く — 幾何学的形状、レターフォーム、または抽象的なマーク。1つの記憶に残る形状。
  3. 原則: 幾何学的/ミニマル(Paul Rand、Vignelli)。24pxと200pxで機能する。まずはモノクローム — 色は強調として追加する。ダーク/ライトモードには currentColor を使用する。
  4. インラインで実装する aria-label、viewBox、fill="none"、currentColor のストロークを使用する
  5. ファビコンを生成する — 必要に応じて簡略化した32x32バージョン

SVGアニメーション(DrawSVG、MorphSVG)については、shared/03-motion.md を参照してください。SVGパターン/フィルターについては、shared/07-toolkit.md を参照してください。


ビジュアルQAテストプロセス

Playwright QAを使用するタイミング

シンプルなサイトではPlaywrightをスキップする。 シングルページの静的サイトは、Playwrightのスクリーンショットを必要としません。コードを直接レビューしてからデプロイしてください。Playwright QAはかなりの時間がかかるため、シンプルな静的コンテンツには価値がありません。

複雑なサイトではPlaywrightを使用する。 マルチページサイト、ウェブアプリケーション、ダッシュボード、ゲーム、およびインタラクティブ機能(フォーム、カート、フィルター、チャート、ドラッグ&ドロップ)を備えたサイトは、Playwright QAを使用する必要があります。永続的なブラウザ自動化については、skills/website-building/shared/12-playwright-interactive.md を読んでください。

Playwright QAプロセス(複雑なサイトのみ)

サイクル: ビルド → Playwright QA → 評価 → 修正 → 繰り返し → 準備ができたらデプロイ

ステージ1:ページごとのQA

各ページをビルドした後:

  1. デスクトップ(1280px以上)とモバイル(375px)でPlaywrightを介してスクリーンショットを撮る
  2. 批判的に評価する: プロフェッショナルなデザインに見えるか(AI生成ではないか)?タイポグラフィは差別化されているか?ホワイトスペースは十分にあるか?明確な視覚的階層が1つあるか?
  3. 次のページに進む前に、すべての問題を修正する。 ビジュアルデットは許さない。

ステージ2:最終QA(公開前)

  1. すべてのページをデスクトップとモバイルでスクリーンショットする
  2. ページ間の一貫性を確認する(間隔、色、タイプ処理)
  3. ダークモードを検証する(最低でもホームページの両方のテーマをスクリーンショットする)
  4. インタラクティブ状態を確認する:ホバー、フォーカス、アクティブ、ローディング、空、エラー
  5. コールドオープンの第一印象テスト:洗練されていて意図的に見えるか?

QAの失敗: テキストオーバーフロー、一貫性のない間隔、トークンから外れた色、ダークモードの欠落、モバイルでの潰れ、一般的なAIの外観、プレースホルダーコンテンツ、ロゴの欠落。


ステップ1:アートディレクション — 尋ねる前に推測し、デフォルトにする前に尋ねる

すべてのサイトは、そのコンテンツから導き出されたビジュアルアイデンティティを持つ必要があります。Nexusのフォールバックパレットにスキップしないでください。 Nexusパレットは、推測と質問の両方が失敗した場合の最後の手段であり、便利なデフォルトではありません。

  1. 主題から推測する。 コーヒー焙煎所のサイト → アーシーな茶色、温かみのあるクリーム色、手描き風。フィンテックダッシュボード → クールなスレート、シャープなサンセリフ、データ密度の高い。子供向け学習アプリ → 明るい原色、丸みのあるタイプ、遊び心のある動き。コンテンツ自体が、ユーザーが言葉を発する前に、パレット、タイポグラフィ、間隔を教えてくれます。
  2. アートディレクションテーブルを確認する。 各ドメインファイル(informational.md、webapp/SKILL.md、game/game.md)には、サイト/プロダクトタイプをコンセプト駆動の方向性とトークンの開始点にマッピングするアートディレクションテーブルがあります。これらを出発点として使用してください。
  3. 5つの柱を導き出す: 色(暖色/寒色、アクセントは主題から)、タイポグラフィ(セリフ/サンセリフ、ディスプレイの個性)、間隔(密度が高い/広い)、動き(ミニマル/表現力豊か)、イメージ(写真/イラスト/タイプのみ)。
  4. 主題が本当にあいまいな場合は、質問する — 「どのようなムードを目指していますか?」および「参考サイトはありますか?」1つの質問で十分です。
  5. Nexusフォールバック — 推測と質問の両方が何ももたらさなかった場合のみ。 ユーザーに質問しても方向性が示されず、主題が明確なシグナルを提供しない場合にのみ、Nexus/Swissのデフォルトにフォールバックします。

フォールバック:クリーン&スイス(最後の手段)

推測で明確な方向性が得られず、ユーザーにスタイルのガイダンスを求めても得られなかった場合は、shared/01-design-tokens.md のデフォルトを以下とともに使用します。

  • タイポグラフィ: SatoshiまたはGeneral Sans本文(Fontshare — 推奨)、またはInter/DM Sans。フォントのコントラストよりもウェイトのコントラスト。最大3〜4サイズ。テキストはコンパクトに保つ — --text-3xl/--text-hero は情報サイトのヒーローのみ使用する。
  • 色: Nexusパレット。ニュートラルなサーフェス + CTAのみに1つのティールアクセント。
  • レイアウト: グリッドに揃える。広いマージン。興味深い場合は非対称に。
  • 動き: ミニマルで機能的。スムーズな状態遷移のみ。
  • イメージ: クリーンで関連性のあるビジュアルを生成する。ストックフォトは使用しない。

アートディレクション — AI美学を避ける

完全なアンチパターンリストについては、shared/08-standards.md を参照してください。


ステップ2:公開

プロジェクトパスとサイト名を指定して deploy_website() を呼び出します。公開S3 URLを返します。更新するには、ローカルファイルを編集し、同じパスで再デプロイします。正確な呼び出しと例については、shared/09-technical.md を参照してください。

関連スキル