Communitygithub.com

Astro ウェブサイトビルダー / GanderBite/relay

Astro.build を使用したウェブサイト構築のための包括的なスキルです。ユーザーが Astro でサイトを作成したい、適切なテーマを選択したい、ドキュメントを参照したい、または Astro コンポーネントやページを開発したい場合に使用します。テーマ選択、ドキュメントアクセス、プロジェクトセットアップ、Astro 特有の開発パターンを扱います。

GanderBite/relay とは?

このスキルは、Astro.build を用いたウェブサイト構築を包括的に支援するエージェントスキルです。ユーザーの要件(ブログ、ポートフォリオ、ドキュメントサイトなど)に基づいて最適な無料テーマを選択し、公式ドキュメント(ローカルの `references/astro_docs.md` または `docs.astro.build`)を参照しながら、プロジェクトの初期化からコンポーネント開発、パフォーマンス最適化までのワークフローを段階的にガイドします。特に、テーマ選定のための `web_fetch` の使用、プロジェクト構造のベストプラクティス、React/Vue などのフレームワーク連携、そして Astro のアイランドアーキテクチャに基づく効率的な開発パターンを重視しています。また、開発時のトラブルシューティングや、ブログ・ポートフォリオ・ドキュメントサイトといった具体的なユースケースの例も提供し、初心者から経験者までスムーズに Astro プロジェクトを立ち上げ、拡張できるよう設計されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/GanderBite/relay/tree/HEAD/.claude/skills/astro-builder

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

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

ドキュメント

Astro ウェブサイトビルダー

このスキルは、Astro.build を使用したウェブサイト構築を、テーマの選択、ドキュメントへのアクセス、開発のベストプラクティスのガイドを通じて支援します。ユーザーが Astro での構築について言及した場合、ウェブサイトを作成したい場合、または Astro 特有の機能に関するヘルプが必要な場合に、このスキルを使用してください。

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

以下の場合にこのスキルを有効にしてください:

  • ユーザーがリクエスト内で「Astro」または「astro.build」に言及した場合
  • ユーザーがウェブサイトを構築したいと考えており、Astro が適切な場合(ブログ、ドキュメント、ポートフォリオ、マーケティングサイトなど)
  • ユーザーが Astro プロジェクト用のテーマを選択する必要がある場合
  • ユーザーが Astro のコンポーネント、ルーティング、または設定についてヘルプを必要としている場合
  • ユーザーが React、Vue、またはその他のフレームワークを Astro と統合したい場合
  • ユーザーが Astro のドキュメントやベストプラクティスへのアクセスを必要としている場合

ワークフロー概要

Astro ウェブサイトを構築する際は、以下のプロセスに従ってください:

  1. 要件の理解 - ウェブサイトの種類と必要な機能を決定する
  2. 適切なテーマの選択 - 要件に基づいて Astro の無料テーマから選択する
  3. ドキュメントへのアクセス - 特定の機能について Astro ドキュメントを参照する
  4. プロジェクトの初期化 - プロジェクト構造をセットアップする
  5. コンポーネントの開発 - Astro のコンポーネントアーキテクチャを使用して構築する
  6. 最適化とデプロイ - パフォーマンスのベストプラクティスに従う

ステップ 1: 要件の理解

まず、ウェブサイトの種類とその要件を特定します:

ウェブサイトの種類:

  • ブログ / 出版サイト
  • ポートフォリオ / ショーケース
  • ドキュメントサイト
  • マーケティング / ランディングページ
  • E コマースサイト
  • 会社 / ビジネスサイト
  • 個人ウェブサイト

尋ねるべき重要な質問:

  • サイトの主な目的は何ですか?
  • どのようなコンテンツタイプがありますか?(ブログ記事、プロジェクト、製品など)
  • インタラクティブ性は必要ですか?(フォーム、検索、動的コンテンツ)
  • ユーザーはどのフレームワークを好みますか?(React、Vue、Svelte など)
  • 特定の機能は必要ですか?(ダークモード、i18n、CMS 統合)

ステップ 2: 適切なテーマの選択

web_fetch を使用して、無料の React 互換テーマを閲覧します:

URL: https://astro.build/themes/1/?search=&technology%5B%5D=react&price%5B%5D=free

テーマ選択の基準:

ブログ / 出版物向け:

  • 強力なタイポグラフィを持つテーマを探す
  • Markdown/MDX をサポートしている必要がある
  • タグ/カテゴリがあるべき
  • RSS フィードのサポート
  • 検討すべきテーマ:astro-paper、astro-blog-template

ポートフォリオ向け:

  • 視覚的なプロジェクトショーケース
  • 自己紹介/お問い合わせセクション
  • スムーズなアニメーション
  • 検討すべきテーマ:astro-portfolio、personal-portfolio テーマ

ドキュメント向け:

  • Starlight を使用する(Astro の公式ドキュメントフレームワーク)
  • 機能:検索、サイドバーナビゲーション、ダークモード、i18n
  • 最適な用途:技術ドキュメント、API リファレンス、ガイド

ランディングページ向け:

  • CTA 付きのヒーローセクション
  • 機能/メリットのセクション
  • お問い合わせフォーム
  • コンバージョン最適化

E コマース向け:

  • 商品一覧とフィルター
  • ショッピングカート機能
  • 決済統合対応
  • 商品詳細ページ

アクション: テーマページを取得し、利用可能なテーマを分析し、ユーザーの要件に最も合う 2〜3 のオプションを推奨します。各テーマがなぜ適しているかを説明します。

ステップ 3: Astro ドキュメントへのアクセス

特定の Astro ドキュメントが必要な場合は、以下を参照してください:

  1. 組み込みリファレンス: references/astro_docs.md - コアとなる Astro の概念、構文、および一般的なパターンを含みます
  2. 完全なドキュメント: 包括的な情報については https://docs.astro.build/llms-full.txt から取得します

ドキュメントを参照するタイミング:

  • コンポーネント構文の質問 → astro_docs.md を参照
  • ルーティングとページ → astro_docs.md を参照
  • スタイリングオプション → astro_docs.md を参照
  • 高度な機能 → docs.astro.build から取得
  • 統合セットアップ → docs.astro.build から取得
  • API の詳細 → docs.astro.build から取得

ステップ 4: Astro プロジェクトの初期化

Create Astro CLI の使用

# 新しいプロジェクトを作成
npm create astro@latest

# または特定のテンプレートを使用
npm create astro@latest -- --template <theme-github-username>/<theme-repo>

プロジェクト構造のセットアップ

初期化後、適切な構造を確認します:

project/
├── src/
│   ├── components/     # 再利用可能なコンポーネント
│   ├── layouts/        # ページレイアウト
│   ├── pages/          # ルート(必須)
│   │   └── index.astro # ホームページ
│   ├── content/        # コンテンツコレクション(オプション)
│   └── assets/         # 最適化された画像
├── public/             # 静的アセット
├── astro.config.mjs    # 設定
├── package.json
└── tsconfig.json

重要: ルーティングを機能させるには src/pages/ ディレクトリが必須です。

ステップ 5: コンポーネントとページの開発

コンポーネント開発パターン

  1. src/components/ にコンポーネントファイルを作成
  2. props インターフェースを定義(TypeScript を使用する場合)
  3. コンポーネントスクリプトを記述(ビルド時に実行)
  4. テンプレートを作成(Astro 構文の HTML)
  5. スコープ付きスタイルを追加(オプション)

例:

---
interface Props {
  title: string;
  description?: string;
}
const { title, description } = Astro.props;
---

<article>
  <h2>{title}</h2>
  {description && <p>{description}</p>}
</article>

<style>
  article {
    padding: 1rem;
    border: 1px solid #ccc;
  }
</style>

ページ開発パターン

  1. src/pages/ にページファイルを作成(ルートを決定)
  2. 必要なコンポーネントとレイアウトをインポート
  3. 動的ルート用に getStaticPaths() を定義
  4. コンポーネントを使用してページを構成

ページの例:

---
import Layout from '../layouts/Layout.astro';
import Hero from '../components/Hero.astro';

const title = "My Page";
---

<Layout title={title}>
  <Hero />
  <!-- その他のコンテンツ -->
</Layout>

インタラクティブ性の追加

クライアントサイドのインタラクティブ性が必要な場合:

  1. フレームワーク統合をインストール: npx astro add react
  2. フレームワークコンポーネントを作成 (.jsx、.vue、.svelte)
  3. クライアントディレクティブ付きでインポートして使用:
---
import ReactComponent from '../components/ReactComponent.jsx';
---

<!-- 静的(JS なし) -->
<ReactComponent />

<!-- インタラクティブ -->
<ReactComponent client:load />
<!-- オプション:client:idle、client:visible、client:media -->

ステップ 6: 必要に応じてドキュメントを参照

コードを書く前に、references/astro_docs.md から関連セクションを読んでください:

  • コンポーネントに関する質問 → 「コンポーネント構文」セクションを読む
  • ルーティングの問題 → 「ルーティング」セクションを読む
  • スタイリング → 「スタイリング」セクションを読む
  • 画像 → 「画像とアセット」セクションを読む
  • 設定 → 「設定」セクションを読む

高度なトピックについては、完全なドキュメントを取得します:

web_fetch: https://docs.astro.build/llms-full.txt

ベストプラクティス

パフォーマンス最適化

  1. デフォルトではコンポーネントを静的に保つ - 本当に必要な場合のみ client:* を追加する
  2. Astro の Image コンポーネントを使用する - 自動最適化
  3. アイランドアーキテクチャを活用する - デフォルトで最小限の JavaScript
  4. コード分割 - Astro はページごとに自動的に分割します

開発ワークフロー

  1. 構造から始める - まずレイアウトと基本ページをセットアップ
  2. コンポーネント駆動開発 - 再利用可能なコンポーネントを構築
  3. 型安全性 - props と DX 向上のために TypeScript を使用
  4. コンテンツコレクション - 型安全なコンテンツ管理のために
  5. ローカルでテスト - npm run dev を頻繁に実行

従うべき一般的なパターン

  • 一貫したページ構造のためにレイアウトを使用
  • メタタグ用の SEO コンポーネントを作成
  • 適切な TypeScript インターフェースを設定
  • 適切なエラーページを実装(404、500)
  • 画像に適切な alt テキストを追加
  • セマンティック HTML を使用

トラブルシューティング

一般的な問題

「Module not found」

  • インポートパスが正しいことを確認
  • 統合がインストールされていることを確認
  • astro.config.mjs に正しい統合設定があることを確認

「Page not rendering」

  • ファイルが src/pages/ ディレクトリ内にあることを確認
  • frontmatter に構文エラーがないか確認
  • 適切なファイル拡張子 (.astro、.md、.mdx) であることを確認

「Styles not applying」

  • スコープ付きスタイルはコンポーネント自身の HTML にのみ適用されます
  • グローバルスタイルには is:global を使用
  • Tailwind を使用している場合は Tailwind の設定を確認

「Component not interactive」

  • フレームワークコンポーネントに client:* ディレクティブを追加
  • 統合がインストールされていることを確認(例:@astrojs/react)
  • ブラウザコンソールで JavaScript エラーを確認

リソース

スクリプト

  • scripts/theme_analyzer.py - Astro 公式テーマページからテーマを取得および分析するのに役立ちます。技術や価格フィルターに基づいてテーマオプションをプログラムで探索するために使用します。

リファレンス

  • references/astro_docs.md - 最初にこれを読んでください。コアとなる Astro の概念、コンポーネント構文、ルーティング、スタイリング、および一般的なパターンについて説明しています。Astro 開発における主要なリファレンスです。

外部リソース

ワークフロー例

例 1: ブログの構築

ユーザー: 「Astro と React でブログを作りたい」

ワークフロー:

  1. 要件を特定: ブログサイト、React サポートが必要、無料テーマを希望
  2. テーマを取得: web_fetch https://astro.build/themes/1/?technology%5B%5D=react&price%5B%5D=free
  3. テーマを推奨: ブログ向けのテーマを 2〜3 つ、説明付きで提案
  4. references/astro_docs.md を読み、コンポーネントパターンを参照
  5. セットアップをガイド: インストールコマンドと構造を提供
  6. 構築を支援: ブログ記事レイアウト、一覧ページ、個別の記事ページを作成
  7. インタラクティブ性を追加: client:load を使用して React コンポーネントを追加し、コメント機能などを実装する方法を示す

例 2: ポートフォリオウェブサイト

ユーザー: 「https://astro.build/ を使ってポートフォリオサイトを作成して」

ワークフロー:

  1. 要件を明確化: 何を公開するか?(プロジェクト、スキル、経歴?)
  2. Astro テーマページからポートフォリオテーマを取得
  3. ユーザーの分野(開発者、デザイナーなど)に基づいて最適なテーマを推奨
  4. references/astro_docs.md からコンポーネント構文を読む
  5. 選択したテーマでプロジェクト構造をセットアップ
  6. コンポーネントを作成/カスタマイズ (Hero、プロジェクトグリッド、自己紹介、お問い合わせ)
  7. 必要に応じてスムーズなトランジションを追加
  8. Astro の Image コンポーネントを使用して画像を最適化

例 3: ドキュメントサイト

ユーザー: 「検索機能とダークモード付きのドキュメントサイトが必要」

ワークフロー:

  1. 特定: ドキュメントサイト、検索とダークモードが必要
  2. Starlight を推奨(Astro 公式ドキュメントフレームワーク)
  3. セットアップを提示: npm create astro@latest -- --template starlight
  4. 完全な Astro ドキュメントから Starlight のドキュメントを参照
  5. サイドバーナビゲーション構造を設定
  6. コンテンツ構造をセットアップ
  7. ダークモードを有効化(組み込み)
  8. 検索を設定(Pagefind による組み込み)

重要な注意点

  1. コンポーネントや構文の質問に答える前に、必ず最初に references/astro_docs.md を読んでください
  2. ユーザーが出発点を必要とする場合は、Astro テーマページからテーマを取得してください
  3. 必要に応じて完全なドキュメントを web_fetch で取得してください
  4. シンプルに保つ - Astro はわかりやすくなるように設計されています。複雑にしすぎないでください。
  5. アイランドアーキテクチャ - コンポーネントはデフォルトで静的であることを忘れないでください。
  6. 型安全性 - より良い開発体験のために TypeScript の使用を推奨してください。

成功基準

Astro プロジェクトが正しくセットアップされているのは、以下の場合です:

  • ✅ プロジェクト構造が Astro の規則に従っている
  • ✅ src/pages/ ディレクトリが存在し、少なくとも index.astro が含まれている
  • ✅ 要件に基づいて適切なテーマが選択されている
  • ✅ コンポーネントが Astro の構文パターンに従っている
  • ✅ クライアントサイドのインタラクティブ性は必要な場所にのみ追加されている
  • ✅ コンポーネントの props に TypeScript インターフェースが定義されている
  • ✅ Astro の Image コンポーネントを使用して画像が最適化されている
  • ✅ npm run dev でサイトが正常に実行される

関連スキル