Communitygithub.com

IncomeStreamSurfer/astro-builder-skill

Astroを使い、SEO最適化されたWebサイトを構築します。Tailwind CSS、コンテンツコレクション、オプションでTursoデータベースに対応。ユーザーがWebサイト作成、Google上位表示、Astroプロジェクト、ランディングページ、ビジネスサイト、ブログなどを希望する際に使用します。

astro-builder-skill とは?

このスキルは、Astroフレームワークを用いて、検索エンジン最適化(SEO)が施された、完全にデプロイ可能なWebサイトを構築するためのエキスパートスキルです。Googleでのランキング向上を念頭に設計されており、メタタグ、構造化データ、セマンティックHTML、最適化された画像、サイトマップ、そして実際に調査されたコンテンツをすべてのページに含めます。対応プラットフォームは、Claude Codeや類似のAIエージェントを想定しており、Astro v5以降のプロジェクトで動作します。 このスキルのワークフローは、ニッチ調査とサイト構造の提案から始まり、プロジェクトのセットアップ、各ページの構築(デザインルールとSEOチェックリストに準拠)、コンテンツコレクションとデータベース(Turso)の設定、そして最終的なデプロイ準備までを順を追って実行します。すべてのUIコードは、専用の「taste-skill.md」で定義されたデザインルールに従い、高品質で、一般的な「AIスラップ」ではないプレミアムな出力を保証します。 このスキルは、単なるコード生成ツールではなく、戦略的なSEOコンサルタントとWeb開発者を組み合わせたような役割を果たします。ユーザーのビジネス目標を理解し、競合分析に基づいたコンテンツ戦略を提案し、それを実装します。結果として、単に見た目が良いだけでなく、実際に集客効果の高いWebサイトを提供します。 技術スタックとしては、Astro(静的ファースト)、React(インタラクティブコンポーネント)、Tailwind CSS(スタイリング)、Astro Content Collections(型安全なコンテンツ管理)、そしてオプションでTurso + Drizzle(エッジSQLiteデータベース)を使用します。データベースが必要な場合、フォーム送信やリード管理などの動的データ処理も可能です。

対応✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/IncomeStreamSurfer/astro-builder-skill/tree/HEAD/skill

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

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

ドキュメント

Astro SEO Webサイトビルダー

あなたは、Googleで上位表示されるように設計された、完全でデプロイ可能なAstro製Webサイトを構築します。すべてのサイトには、適切なメタタグ、構造化データ、セマンティックHTML、最適化された画像、サイトマップ、そしてプレースホルダーではない実際に調査されたコンテンツが含まれます。

あなたが生成するフロントエンドはすべて、プレミアムで非汎用的でなければなりません。UIコードを書き始める前に、references/taste-skill.mdを読んでください。そこには、一般的な「AIスラップ」出力を防ぐデザインルールが含まれています。

技術スタック

  • Astro — 静的ファーストフレームワーク、デフォルトでJSゼロ、SEOに最適
  • React — Astroアイランドを介したインタラクティブコンポーネント(フォーム、ナビ、アニメーション)
  • Tailwind CSS — すべてのスタイリング。shadcnのデフォルトは使用しません。taste-skillルールに従ってすべてをカスタマイズします。
  • Astro Content Collections — ブログ投稿、サービス、お客様の声のための型安全なMarkdown/MDXコンテンツ
  • Turso + Drizzle — エッジSQLiteデータベース(オプション、フォーム/動的データ用)

ワークフロー概要

すべてのプロジェクトはこの順序に従います。手順を飛ばさないでください。

フェーズ1: 発見と調査

  1. ユーザーにニッチ、ビジネス、目標について尋ねる
  2. データベースが必要かどうかを尋ねる(問い合わせフォーム、リード、予約など)
  3. ニッチを調査する — 何がランキングされているか、どのキーワードが重要か、どのようなコンテンツギャップがあるか
  4. ページリスト、コンテンツ戦略、キーワードターゲットを含むサイト構造を提案する
  5. 構築を開始する前にユーザーの承認を得る

フェーズ2: プロジェクトセットアップ

  1. Astroプロジェクトをスキャフォールドする
  2. インテグレーションをインストールして設定する(React、Tailwind、サイトマップ)
  3. ベースレイアウト、SEOコンポーネント、デザインシステムをセットアップする

フェーズ3: すべてのページを構築する

  1. references/taste-skill.mdを読んでデザインルールを確認する
  2. ユーザーが画像生成を希望する場合、references/image-generation.mdを読み、各ページの画像を生成する
  3. 実際に調査されたコンテンツを使用して各ページを作成する
  4. すべてのページで完全なSEOを実施する — メタタグ、OGタグ、構造化データ、セマンティックHTML
  5. インタラクティブコンポーネント(フォーム、ナビゲーションなど)を配線する

フェーズ4: コンテンツコレクションとデータベース

  1. ブログ投稿、サービスなどのためのAstroコンテンツコレクションを設定する
  2. データベースがリクエストされた場合: Tursoをセットアップし、スキーマを作成し、APIルートを構築する
  3. 該当する場合、データベースデータの管理ダッシュボードを構築する

フェーズ5: デプロイ準備

  1. サイトマップ、robots.txtを生成する
  2. デプロイを設定する(Vercel/Netlify)
  3. すべてのページの最終SEO監査を実施する

フェーズ1: 発見と調査

ユーザーに尋ねる

コードを書く前に、プロジェクトを理解します:

  1. あなたのニッチ/ビジネスは何ですか? — 「私はダブリンの配管工です」または「私は手作りキャンドルをオンラインで販売しています」
  2. サイトの主な目的は何ですか? — リード生成、Eコマース、ポートフォリオ、ブログ、SaaSランディングページ
  3. 必要なページ数は? — 小規模(5〜10ページ)またはコンテンツ重視(15〜30ページ以上、ブログあり)
  4. データベースは必要ですか? — フォーム送信、予約、ユーザーデータなどを保存するため。必要な場合は、Tursoをセットアップします。
  5. 生成画像を希望しますか? — 「Geminiを使用して、サイト用のカスタムストック画像を生成できます。ご希望の場合は、.envファイルにGEMINI_API_KEYを追加してください。」
  6. ドメインはお持ちですか? — サイトマップ/正規URLに必要です。まだ購入していない場合はプレースホルダーを使用します。
  7. デザインの好みはありますか? — 色、スタイル、既存のブランディング

ニッチを調査する

ウェブ検索を使用して以下を見つけます:

  • 現在ランキングされているもの — 対象キーワードの上位5〜10件の結果
  • コンテンツギャップ — どの質問が適切に回答されていないか
  • ロングテールキーワード — 競合が少ない特定のフレーズ
  • ローカルSEOシグナル — ローカルビジネスの場合
  • 競合のサイト構造 — どのようなページがあるか、何が不足しているか

サイト構造を提案する

調査に基づいて、具体的な提案を作成します。配管工の例:

提案ページ:
1. ホーム — 「ダブリンの配管工 | 24時間緊急配管サービス」
2. サービス — 全サービスの概要
3. サービス/緊急配管 — ターゲットランディングページ
4. サービス/バスルームリフォーム — ターゲットランディングページ
5. サービス/ボイラー修理 — ターゲットランディングページ
6. 会社概要 — 信頼シグナル、チーム、資格
7. ブログ — SEOのための継続的コンテンツ
8. ブログ/[slug] — ロングテールキーワードをターゲットにした個別投稿
9. お問い合わせ — フォーム + 地図 + 電話番号
10. サービスエリア — ローカルSEOページ
11. お客様の声 — 社会的証明

対象キーワード: ダブリン 緊急配管工, ダブリン 配管工 近く, ダブリン ボイラー修理...
コンテンツ戦略: 「[よくある問題]の修理方法」というクエリをターゲットにした毎週のブログ投稿

先に進む前に、ユーザーの承認を得ます。


フェーズ2: プロジェクトセットアップ

正確なコマンドと設定については、references/astro-setup.mdを読んでください。

1. プロジェクトを作成する

npm create astro@latest [プロジェクト名] -- --template minimal --install --no-git
cd [プロジェクト名]

2. インテグレーションをインストールする

npx astro add react tailwind sitemap
npm install @astrojs/check typescript
npm install @fontsource/geist-sans @fontsource/geist-mono  # taste-skillによるプレミアムフォント

3. データベースがリクエストされた場合

完全なTurso設定については、references/turso-setup.mdを読んでください。

npm install @libsql/client drizzle-orm

4. プロジェクト構造

src/
├── components/
│   ├── SEOHead.astro
│   ├── Header.astro
│   ├── Footer.astro
│   ├── Navigation.tsx    # Reactアイランド
│   └── ContactForm.tsx   # Reactアイランド
├── content.config.ts     # コンテンツコレクションスキーマ(content/内には配置しない)
├── content/
│   ├── blog/
│   ├── services/
│   └── testimonials/
├── layouts/
│   └── BaseLayout.astro
├── lib/
│   ├── turso.ts          # データベースがある場合
│   └── utils.ts
├── pages/
│   ├── index.astro
│   ├── about.astro
│   ├── contact.astro
│   ├── blog/
│   │   ├── index.astro
│   │   └── [...slug].astro
│   └── api/              # APIルート(データベースがある場合)
├── styles/
│   └── globals.css
└── middleware.ts
astro.config.mjs

フェーズ3: すべてのページを構築する — デザイン + SEO

各ページを書き始める前に、以下の両方を読んでください:

  • references/seo-checklist.md — すべてのページのSEOルール
  • references/taste-skill.md — 汎用的な出力を防ぐデザインルール

SEOHeadコンポーネント

src/components/SEOHead.astroを作成します。すべてのページの<head>に配置します。以下を処理します:

  • タイトルタグ(ページごとに一意、プライマリキーワード、60文字未満)
  • メタディスクリプション(一意、CTA、160文字未満)
  • 正規URL
  • Open Graphタグ
  • Twitter Cardタグ
  • JSON-LD構造化データ

正確なコンポーネントコードについては、references/seo-checklist.mdを参照してください。

コンテンツ作成ルール

  • まず人間のために書き、次に検索エンジンのために書きます。
  • すべてのページは特定のキーワードクラスターをターゲットにします。 タイトル、H1、最初の段落、メタディスクリプション、URLスラッグにプライマリキーワードを配置。
  • 適切な見出し階層。 1つのH1。セクションにはH2。サブセクションにはH3。レベルをスキップしない。
  • 内部リンク。 各ページは2〜3以上の他のページにリンクします。説明的なアンカーテキスト。
  • 画像のaltテキスト。 すべての画像に、自然なキーワードを含む説明的なaltテキストを付けます。
  • コンテンツの長さ。 サービスページ: 800〜1500ワード。ブログ投稿: 1500〜3000ワード。ホーム: 500〜1000ワード。
  • スキーママークアップ。 すべてのページに適切なJSON-LDを配置します。

デザインルール(taste-skillより)

これらは、構築するすべてのページにおいて譲れないルールです:

  • タイポグラフィ: Geist、Satoshi、Outfit、またはCabinet Groteskを使用します。Interは絶対に使用しないでください。見出し: text-4xl md:text-6xl tracking-tighter leading-none。
  • 色: アクセントカラーは最大1色、彩度は80%未満。紫/青のAIグラデーションは使用しないでください。ニュートラルベース(Zinc/Slate)。
  • レイアウト: DESIGN_VARIANCE > 4の場合、中央揃えのヒーローは使用しないでください。分割画面、非対称、または左揃えのレイアウトを使用します。
  • カード: 階層を伝える場合にのみ使用します。一般的な3列のカードレイアウトは使用しないでください。
  • スペーシング: h-screenではなくmin-h-[100dvh]。Flexboxの計算ではなくグリッド。max-w-7xl mx-auto。
  • ステート: すべてのインタラクティブコンポーネントには、ローディング状態、空の状態、エラー状態が必要です。
  • AIスラップ禁止: 絵文字、「山田太郎」、「株式会社サンプル」、「シームレス」や「解き放つ」のような埋め草の言葉は使用しないでください。

インタラクティビティのためのAstroアイランド

  • 静的コンテンツ(見出し、テキスト、画像) — .astroコンポーネント、JSゼロ
  • インタラクティブ要素(フォーム、モバイルナビ、スクロールアニメーション) — React .tsx、client:visibleまたはclient:loadを使用
  • アニメーション: モーション用(MOTION_INTENSITY > 5)には、分離されたReactアイランドでFramer Motionを使用します。スプリング物理: type: "spring", stiffness: 100, damping: 20。

コンポーネントパターン(ナビ、フォーム、FAQなど)については、references/tailwind-components.mdを読んでください。


フェーズ4: コンテンツコレクションとデータベース

Astro Content Collections

完全なセットアップについては、references/content-collections.mdを読んでください。コンテンツコレクションはCMSの代わりになります。コンテンツは型安全なスキーマを持つMarkdownファイルとしてsrc/content/に配置されます。

重要: src/content.config.ts(src/content/config.tsではない — 古いパスはAstro v5+でLegacyContentConfigErrorをスローします)でスキーマを定義します。すべてのコレクションにはloaderが必要です(astro/loadersからglob()を使用します)。

src/content.config.tsでスキーマを定義します:

  • ブログ投稿: title、description、pubDate、image、tags、author、draft
  • サービス: title、description、icon、order、featured
  • お客様の声: name、role、quote、rating

ページ内でgetCollection()とgetEntry()を使用してコレクションをクエリします。

Tursoデータベース(リクエストされた場合)

完全なセットアップについては、references/turso-setup.mdを読んでください。Tursoは動的データ(フォーム送信、リード、予約、ニュースレター登録)を処理します。

  1. src/lib/turso.tsにデータベースクライアントを作成する
  2. Drizzle ORMでスキーマを定義する
  3. フォーム処理用のAPIルートをsrc/pages/api/に作成する
  4. 送信データを表示する管理ダッシュボードを構築する

管理ダッシュボード(データベースがある場合)

/adminに、Tailwindでスタイル設定されたテーブルとカードを使用したReactアイランドで構築します。以下を使用します:

  • 基本認証のためのミドルウェア
  • Tursoからデータを取得するためのAPIルート
  • クリーンでセンスの良いデータ表示(taste-skillルールに従う — 一般的なカードグリッドは使用しない)

フェーズ5: デプロイ準備

サイトマップとRobots.txt

@astrojs/sitemapがサイトマップを自動生成します。astro.config.mjsでsiteを設定します。

src/pages/robots.txt.tsの動的robots.txt:

import type { APIRoute } from 'astro';

const getRobotsTxt = (siteURL: string) => `User-agent: *
Allow: /
Disallow: /admin
Sitemap: ${siteURL}sitemap-index.xml`;

export const GET: APIRoute = ({ site }) => {
  return new Response(getRobotsTxt(site?.toString() || ''));
};

デプロイ設定

Vercel/Netlifyの設定については、references/deployment.mdを読んでください。

APIルートやTursoがあるサイトの場合は、アダプターを追加しますが、デフォルトの静的出力は維持します。個々のサーバールートにはexport const prerender = false;をマークします:

import vercel from '@astrojs/vercel';

export default defineConfig({
  // output: 'hybrid' は使用しないでください — Astro v5で削除されました。
  // デフォルトは 'static' です。サーバーレンダリングルートは個別にオプトアウトします。
  adapter: vercel(),
});

各APIルートまたはサーバーレンダリングページ内:

// src/pages/api/contact.ts
export const prerender = false; // このルートはサーバー上で実行されます

export const POST: APIRoute = async ({ request }) => {
  // ...
};

最終SEO監査

すべてのページをreferences/seo-checklist.mdに照らして監査します:

  • 一意のタイトル、説明、正規URLがページごとにある
  • すべての画像にaltテキストがある
  • JSON-LDが有効である
  • 内部リンクが機能する
  • モバイルレスポンシブである(taste-skillのモバイルオーバーライドルールをテストする)
  • サイトマップにすべてのページが含まれている
  • robots.txtが正しい

重要な注意事項

  • output: 'hybrid'は使用しないでください — Astro v5で削除されました。デフォルトの'static'出力を使用してください。サーバーレンダリングルート(APIエンドポイント、フォームハンドラー)の場合は、各ファイルにexport const prerender = false;を追加します。
  • Reactアイランドにはハイドレーションディレクティブが必要です — client:loadまたはclient:visible。
  • コンテンツコレクションはファイルベースです。 ブログ投稿とサービスは、src/content/内の.mdファイルとして存在します。Tursoは動的データ(フォーム送信)専用です。
  • 構築する前に調査します。 ニッチ調査のフェーズがSEO品質を決定します。
  • 本物のコンテンツが勝ちます。 実質的で役立つコンテンツを書きます。Lorem ipsumは使用しないでください。
  • 常にプレミアムデザイン。 taste-skillのルールに従います。すべてのページは、10万円相当のエージェンシー制作のように見え、一般的なAI出力のように見えてはいけません。
  • 画像生成はオプションです。 ユーザーがGEMINI_API_KEYを提供した場合は、references/image-generation.mdに従ってカスタム画像を生成します。提供しない場合は、適切なaltテキストを持つスタイル付きプレースホルダーdivを使用します。

関連スキル