Communitygithub.com

pikaOne1138/astro-personal-site-starter

洗練された Astro サイトをデザイン、構築、改良、または監査するためのスキル。知識ブログやヘルパー/プロフェッショナルサービス向けの2つのアーキテクチャを提供します。

astro-personal-site-starter とは?

このスキルは、デザインの意図が感じられる Astro 製ウェブサイトを構築するための包括的なガイドです。2つのコンテンツアーキテクチャ(知識/ブログ、ヘルパー/プロフェッショナルサービス)と3つのビジュアルパーソナリティ(Paper & Ink、Morning Light、Quiet Studio)を組み合わせ、目的に応じたサイト設計を支援します。デフォルトではフロントエンドサイトのみを対象とし、CRMや認証などのバックエンド機能へのスコープ拡大を制限します。証拠に基づく設計判断(直接観察、Web検証、パターン分析など)を重視し、各ページの役割(例:読者の質問に答える、信頼構築)を明確に定義します。UIルール、ナビゲーション、CTA階層、モーションガイドライン、レスポンシブ設計、品質ゲートまで細かく規定されており、一貫性と品質を保ったサイト制作が可能です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pikaOne1138/astro-personal-site-starter/tree/HEAD/.ai/astro-ui-craft

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

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

ドキュメント

Astro UI Craft

デザインされたと感じられるウェブサイトを構築します。単に生成されたものではありません。

コアモデル

2つのコンテンツアーキテクチャ:

  • 知識 / ブログ
  • ヘルパー / プロフェッショナルサービス

3つのビジュアルパーソナリティ:

  • Paper & Ink
  • Morning Light
  • Quiet Studio

これは 2つのアーキテクチャ × 3つのビジュアル方向性 であって、6つの無関係なコードベースではありません。

スコープガードレール

デフォルトスコープは洗練されたフロントエンドサイトです。外部フォーム、LINE、予約、ニュースレターサービスを優先します。CRM、認証、メンバーシステム、カスタム予約エンジン、決済、データベース、SaaS管理に静かに拡大しないでください。

証拠の階層

  1. 直接開いた / スクリーンショット / 計算されたCSSの観察結果。
  2. Web検索およびページ検証済みの観察結果。
  3. 検証済みケースから導き出されたクロスケースパターン。
  4. デザイン提案と合成トークン。
  5. メモリのみまたは明示的に未検証の候補リスト。

知識 / ブログページの役割

以下に答えること:

  • この人は何について書いているのか?
  • 新しい読者はどこから始めるべきか?
  • あるトピックについてさらに知るには?
  • なぜこの人をフォローすべきか?
  • 次に取るべき低摩擦アクションは?

デフォルトフロー: ヒーロー → ここから始める/トピック → 注目/最新 → 簡易アバウト → リソース → ニュースレター → フッター

ヘルパー / プロフェッショナルページの役割

以下に答えること:

  • 自分は正しい場所にいるか?
  • この人は自分の状況を理解しているか?
  • 何を提供しているか?
  • 連絡するとどうなるか?
  • なぜ信頼できるか?
  • 次に取るべき低プレッシャーアクションは?

デフォルトフロー: ヒーロー → 共感 → サービス → 初回来訪/プロセス → アバウト/資格 → 信頼 → FAQ → 予約/問い合わせ → フッター

おおよそ 7 ± 1 の意味のあるセクション を推奨します。

ビジュアルパーソナリティ

Paper & Ink

暖かみのある紙、濃いインク、セリフ体の見出し書体、細い罫線、低彩度の画像、エディトリアルリスト。

Morning Light

クリーム色、クレイ/ローズ/セージのアクセント、柔らかいセリフ体+読みやすいサンセリフ体、たっぷりとした角丸、自然光の画像、優しい安心感。

Quiet Studio

ほぼ白の暖かみのあるグレー、正確なグリッド、サンセリフ体を基本としたタイポグラフィ、一つの強めのアクセントカラー、細いボーダー、構造化されたサービス/コンテンツメタデータ。

洗練されたUIルール

  • 装飾の前に構造。
  • 一貫したスペーシングスケール。
  • 長文の行長はおおよそ60~72文字。
  • 1つのプライマリアクセント+ニュートラルカラー。
  • 一貫した画像アスペクト比とトーン処理。
  • ホバー/フォーカス/アクティブのフィードバックを可視化。
  • ネオンバイオレット、過度なグラスモーフィズム、ランダムなベントーグリッド、繰り返しのアイコン3列セクション、巨大なぼんやりしたグラデーション、不必要なカウンター/カルーセル/タイプライター効果を避ける。

ナビゲーション

デスクトップ: [ロゴ] 4~5リンク ... [単一のプライマリCTA]

  • 知識: 記事 / トピック / ここから始める / アバウト + 購読。
  • ヘルパー: サービス / プロセス / アバウト / 記事 / FAQ + 予約/問い合わせ。
  • ワークショップベースラインではメガメニューを避ける。

CTA

最大3つの意味レベル:

  • プライマリ: 購読 または 初回相談を予約。
  • セカンダリ: 適合性/プロセス/無料リソースを理解する。
  • 低プレッシャー: 読む/探索する/もっと学ぶ。

ヘルパー言語: 「預約初談」「了解合作方式」「第一次來?先看看流程」「開始聊聊」

モーション

  • ホバー 150~220ms
  • UIトランジション 180~350ms
  • リビール 400~650ms
  • 移動量 4~16px
  • スケール 約0.98~1.03
  • 一貫したイーズアウト
  • transform + opacity を優先
  • prefers-reduced-motion を尊重

意図する効果:ユーザーがアニメーションを意識的に気づかないかもしれないが、サイトが大切に扱われていると感じられること。

レスポンシブ

単にデスクトップを縮小しない。

  • デスクトップ: 約1080~1200pxのコンテナ。
  • タブレット: 分割レイアウト/スティッキーサイドコンテンツを簡略化。
  • モバイル: シングルリーディングフロー、十分なサイドパディング、必要に応じて全幅コントロール。
  • ヘルパーは、コンテンツを覆わない場合にのみ、固定予約CTAを使用できる。

品質ゲート

引き渡し前の確認事項:

  • プライマリページの役割が明確であること。
  • 装飾なしでも階層が正しく読めること。
  • モバイル構成が機能すること。
  • コントラスト/タップターゲット/フォーカス状態が使用可能であること。
  • モーションが控えめでオプショナルであること。
  • ビルドが成功すること。
  • 誤ったバックエンドスコープの拡大がないこと。

関連スキル