AI Readiness Kit

AI Readiness Skill

1つのコマンドで、あらゆるウェブサイト向けのAI対応ファイル一式（GEO／生成エンジン最適化）を生成します。llms.txt、ai.txt、スキーマ、RAGインデックスなどに対応しています。1つのnpxコマンドでClaude、Cursor、Windsurf、GitHub Copilot、Gemini、Codexにインストールするか、インストール不要でMCP経由で接続できます。

📖 ライブサイトとドキュメント全文： ai.silverbackmarketing.com · AIに見つけてもらうのに役立ったら、このリポジトリに⭐を付けてください。

---

AI Readiness Kitとは？

AI Readiness Kitは、ウェブサイトのルートに配置する17個の構造化ファイルからなる、無料のオープンソースツールキットです。robots.txt、ai.txt、llms.txt、スキーマ、RAGインデックスなどを通じて、ChatGPT、Claude、Gemini、Perplexityに、あなたが誰で、何を提供し、どのように紹介すべきかを正確に伝えます。1つのコマンドで、あらゆるサイトに合わせて一式を生成できます。MITライセンスで永久に無料です。npxでインストールするか、インストール不要でMCP経由で実行できます。

---

AI対応が必要な理由

誰かが製品のおすすめやサービス提供者を探したり、端的な答えを求めたりするとき、ウェブサイトを訪れる前にChatGPT、Claude、Gemini、Perplexityに尋ねることがよくあります。そうしたシステムに明確で最新の情報を伝えていなければ、システムは推測し、多くの場合、誤った推測をします。

AI対応ファイルとは、ウェブサイトのルートに配置し、AIシステムにあなたが誰で、何を提供し、どこへ人々を案内すべきかを正確に伝える構造化ファイルです。AIがすでに理解している形式（llmstxt.orgの標準、Schema.org、新たに生まれつつあるAIクローラーの規約）を使うため、アシスタントは古い学習データをもとにあなたのブランドについて推測するのをやめ、回答で正確に紹介するようになります。

このスキルは、あらゆるサイトを調査して業界を分類し、そのビジネスに合わせたすべてのファイルを1つのコマンドで生成します。

---

目次

• インストール
• MCP 経由で使用（インストール不要）
• できること
• ファイル一覧
• 使い方
• FAQ
• リファレンスドキュメント
• PDF ガイド
• スキルファイルの構成
• 著者と企業
• ライセンス

---

インストール

クイックインストール（あらゆるエージェント）— npx

# Global skill install → ~/.agents/skills/ AND ~/.claude/skills/ (default)
npx @silverbackmarketing/ai-readiness install

# AGENTS.md — the cross-agent standard (Cursor, Codex & others)
npx @silverbackmarketing/ai-readiness install --agent agents

# Both at once (recommended)
npx @silverbackmarketing/ai-readiness install --all

主な対象：

対象	インストール先
skills	~/.agents/skills/ai-readiness/ と ~/.claude/skills/ai-readiness/（完全なスキル — SKILL.md、スクリプト、リファレンスを含む）
agents	./AGENTS.md — Cursor、Codex、および対応するエージェントが増えている標準ファイル（区切り付きブロックを追加し、既存の内容は保持します）
claude	~/.claude/skills/ai-readiness/ のみ

プロンプトベースのエージェントには、AGENTS.md がデフォルトかつ推奨の対象です — 現在、ほとんどの最新エージェントがこれを読み込みます。必要に応じて、ツール固有のファイルも利用できます。

オプトイン対象	インストール先
cursor	./.cursor/rules/ai-readiness.mdc
windsurf	./.windsurf/rules/ai-readiness.md
copilot	./.github/copilot-instructions.md（区切り付きブロック）
gemini	./GEMINI.md（区切り付きブロック）
generic	./ai-readiness.SKILL.md（任意のシステムプロンプトに貼り付け）

Claude 以外の対象は現在のディレクトリにインストールされるため、プロジェクトのルートからコマンドを実行してください。--all を指定すると、Claude と AGENTS.md の両方にインストールされます。上書きするには --force を、対象を変更するには --dir <path> を追加してください。共有ファイルへのインストールでは、マーク付きブロックを挿入し、再実行時にはその場で更新するため、ほかの指示が上書きされることはありません。

その他のインストール方法

• Claude Cowork のワンクリックインストール： ai-readiness.skill をダウンロードして開きます。
• あらゆる AI に手動でインストール： SKILL.md をアシスタントのシステムプロンプトまたはカスタム指示にコピーします。

インストール後、Claude で /ai-readiness yoursite.com を実行するか、任意のエージェントに 「yoursite.com 用の AI readiness ファイルを作成して」 と依頼して起動します。

MCP 経由での利用（インストール不要）

スキルをローカルにインストールする代わりに、コーディングエージェントをホストされている MCP サーバーに接続します。同じワークフローで、サイトを調査してすべてのファイルを生成できます。

本番環境： https://ai.silverbackmarketing.com/api/mcp

接続後に使用するプロンプトの例：

Generate AI readiness files for example.com
Use ai-readiness to list all output files
Get the file spec for llms.txt from ai-readiness

Cursor — .cursor/mcp.json に追加します：

{
  "mcpServers": {
    "ai-readiness": {
      "url": "https://ai.silverbackmarketing.com/api/mcp"
    }
  }
}

MCP サーバーを更新してから、「ai-readiness を使って example.com のファイルを生成して」と依頼します。

Claude Code — プロジェクトのルートに .mcp.json を追加します：

{
  "mcpServers": {
    "ai-readiness": {
      "type": "http",
      "url": "https://ai.silverbackmarketing.com/api/mcp"
    }
  }
}

または、次を実行します：

claude mcp add --transport http ai-readiness https://ai.silverbackmarketing.com/api/mcp

セッションを再起動し、/mcp を実行してから、「ai-readiness を使って mysite.com の AI readiness ファイルを生成して」と依頼します。

VS Code / Copilot — .vscode/mcp.json に追加します：

{
  "servers": {
    "ai-readiness": {
      "type": "http",
      "url": "https://ai.silverbackmarketing.com/api/mcp"
    }
  }
}

MCP: List Servers を開き、ai-readiness が実行中であることを確認してから、Copilot Chat でエージェントモードを使用します。

Claude Desktop — macOS の ~/Library/Application Support/Claude/claude_desktop_config.json で mcp-remote を使用します：

{
  "mcpServers": {
    "ai-readiness": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://ai.silverbackmarketing.com/api/mcp"]
    }
  }
}

保存後、Claude Desktop を完全に終了してから再度開きます。

OpenAI Codex — ~/.codex/config.toml に追加します：

[mcp_servers.ai-readiness]
url = "https://ai.silverbackmarketing.com/api/mcp"
enabled = true

または、codex mcp add ai-readiness --url https://ai.silverbackmarketing.com/api/mcp を実行してから、セッションで /mcp を実行します。

Antigravity — エージェントパネル → … → MCP Servers → Manage → View raw config：

{
  "mcpServers": {
    "ai-readiness": {
      "serverUrl": "https://ai.silverbackmarketing.com/api/mcp"
    }
  }
}

Antigravity では url ではなく serverUrl を使用します。保存して更新してから、エージェントモードで試してください。

Perplexity — このキットを使用する方法は 2 つあります。

• リモート MCP コネクター経由 — Perplexity の有料プランが必要です。また、組織の管理者が先に「Allow members to add custom connectors」を有効にする必要がある場合があります。 Account settings → Connectors に移動し、右上の + Custom connector をクリックして Remote を選択し、次の項目を入力します。

  項目	値
  名前	AI Readiness
  MCP サーバー URL	https://ai.silverbackmarketing.com/api/mcp
  認証	None
  トランスポート	Streamable HTTP

  確認ボックスにチェックを入れて Add をクリックし、コネクターカードをクリックして有効にします。「ai-readiness を使って example.com のファイルを生成して」と依頼します。（詳細な手順は、Perplexity の カスタムリモートコネクターの追加ガイドをご覧ください。）

• 手動 — 無料で、どのプランでも利用可能： SKILL.md をスレッドに貼り付ける（または添付する）と、「この AI readiness の手順を使って、example.com の AI readiness ファイルを生成して」と依頼できます。

クイックテスト：

curl -X POST 'https://ai.silverbackmarketing.com/api/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","method":"tools/list","params":{},"id":1}'

その他のクライアント設定：ai.silverbackmarketing.com/#mcp

---

概要

/ai-readiness yoursite.com を実行すると、AI がサイトを調査して業界を分類し、AI システム（ChatGPT、Claude、Gemini、Perplexity など）にサイトの内容、提供しているもの、ユーザーの誘導先を正確に伝える、本番環境ですぐに使えるファイルを生成します。

これらのファイルをウェブのルートに配置すると、AI が生成する回答、要約、おすすめにおけるサイトの表示が改善されます。AI 主導のウェブで存在感を示したいすべてのビジネスに欠かせません。

---

ファイル

このスキルは18個のファイルを生成します。そのうち17個は7つのカテゴリにわたってウェブサイトのルートディレクトリに配置されます（オプションの.well-known/ai-plugin.jsonを省略する場合は16個です）。残りの1つであるREADME.mdは、チーム向けのプロジェクトドキュメントです。これは、ライブサイトで紹介されている17ファイルのキットと一致します。

#	ファイル	用途	配置
1	ai.txt	AI 向けの主要なアイデンティティ宣言	✅
2	llms.txt	簡潔な LLM 向けサイト概要	✅
3	llms-full.txt	包括的な LLM ナレッジベース	✅
4	ai-sitemap.xml	AI 向けに最適化されたサイトマップ	✅
5	sitemap.md	AI コンテキスト向けの人間が読めるサイトマップ	✅
6	ai-entities.json	構造化されたエンティティ定義	✅
7	ai-intent.json	ユーザーの意図とクエリのマッピング	✅
8	ai-schema.json	Schema.org の構造化データ	✅
9	rag-index.json	RAG 検索用ナレッジベース	✅
10	rag-index.jsonl	埋め込みパイプライン向けの JSONL 形式	✅
11	ai-disclosure.txt	AI コンテンツの透明性に関する声明	✅
12	training-data-policy.txt	データの使用とトレーニングに関するポリシー	✅
13	.well-known/ai-plugin.json	AI エージェント向けプラグインマニフェスト（オプション）	➖
14	structured-data-guide.md	開発者向けの実装ガイド	✅
15	manifest.json	ウェブアプリマニフェスト	✅
16	deployment-checklist.md	配置手順のチェックリスト	✅
17	robots.txt	AI クローラー向けの指示	✅
18	README.md	プロジェクトドキュメント（配置対象外）	➖

---

使い方

Claude Cowork で、次のように入力します。

/ai-readiness yoursite.com

または、自然言語で入力します。

create AI readiness files for acmecorp.com
make my site AI-ready: hubspot.com
generate llms.txt for shopify.com

Claude は次の処理を行います。

1. サイトを調査するため、対象を絞った検索を10回以上実行します
2. サイトの種類（SaaS、eコマース、教育、医療など）を分類します
3. 業界に合わせてすべてのファイルを生成します
4. ワークスペース内にドメイン名のフォルダーを作成し、すべてのファイルを保存します

---

FAQ

はじめに

AI Readiness Files とは何ですか？ ウェブサイトのルートに配置し、AI システムにあなたが何者で、何を提供し、どこにユーザーを案内すべきかを正確に伝えるための構造化ファイルです。AI がすでに理解できる形式で記述されているため、アシスタントが古いトレーニングデータをもとにあなたのブランドについて推測するのを防げます。

なぜ今、AI 対応が重要なのですか？ 商品やサービスのおすすめ、あるいは明確な回答を求める人は、ウェブサイトを訪れる前にChatGPT、Claude、Gemini、Perplexityに質問することがよくあります。そうしたシステムに明確で最新の情報を提供しなければ、システムは推測します。そして、その推測は間違っていることが少なくありません。

キットにはファイルがいくつ含まれていますか？ キットには、Identity & Permissions、Content Files、Map & Navigation、Intelligence Files、Research Files、Policy Files、Operations Filesの7カテゴリにわたる、目的別に作成された17個のファイルが含まれています。それぞれのファイルが、AI にサイトをより正確に理解し、表現するための手助けをします。（このスキルは合計18個のファイルを生成します。追加の1つは、このプロジェクト用のREADME.mdです。）

何から始めればよいですか？ まず、重要なファイルであるrobots.txt、ai.txt、llms.txt、llms-full.txtから始めましょう。これらはすぐに大きな効果をもたらし、ほとんどのAI システムが最初に確認するファイルです。その後、配置チェックリストを使って、サイトマップ、インテリジェンス用 JSON ファイル、ポリシー、運用関連ファイルを追加します。

アイデンティティと権限

robots.txt は AI に何をしますか？ robots.txt はウェブサイトの玄関口に置かれ、自動アクセスする訪問者（検索エンジン、AI ボット、スクレイパー）に、アクセス可能なセクションを伝えます。AI 対応に向けて、GPTBot、OAI-SearchBot、ClaudeBot、Claude-SearchBot、PerplexityBot、Bingbot などの主要なクローラーに指示を記載し、llms.txt と ai-sitemap.xml を案内するとともに、チェックアウト、ログイン、管理者ページへのアクセスを制限します。

ai.txt とは何ですか？ ai.txt は、インターネット上のあらゆる AI システムに向けたブランドの紹介文です。robots.txt がアクセスを制御するのに対し、ai.txt はさらに踏み込みます。何を販売しているのか、何で知られているのか、専門分野とするトピック、そして AI システムがコンテンツを使ってよいこと、使ってはいけないことに関するルールを記載します。

ai.txt は robots.txt とどう違いますか？ robots.txt はアクセス、つまりボットがクロールできるページを制御します。ai.txt はアイデンティティ、つまりあなたが何者で、何を提供し、コンテンツの AI 利用にどのような基本ルールを設けているかを伝えます。robots.txt は門番、ai.txt はインタビューの前にジャーナリストへ渡す説明資料だと考えてください。

コンテンツとナビゲーション

llms.txt とは何ですか？ llms.txt は、大規模言語モデル向けに作られた構造化テキストファイルです。会社名、説明、直接リンク付きの整理されたセクション、そしてウェブサイトが回答するよくある質問を通じて、AI にウェブサイトの概要をすばやく伝えます。ChatGPT、Claude、Gemini、Perplexity が使用する llmstxt.org 標準に準拠しています。

llms.txt と llms-full.txt の違いは何ですか？ llms.txt はチートシートです。AI が数秒で確認できる簡単な概要です。llms-full.txt は詳細版で、充実した説明、詳しい Q&A、カテゴリごとの完全な解説が含まれます。llms.txt が Wikipedia の要約なら、llms-full.txt は記事全文です。

ai-sitemap.xml が必要なのはなぜですか？ 通常のサイトマップには、ページとタイムスタンプが記載されます。ai-sitemap には、各ページの内容、コンテンツの種類、平易な英語による要約も追加されます。これは紙の道路地図と、施設情報が表示される GPS の違いのようなものです。AI クローラーは、ページを一つずつ取得して解析しなくても内容を理解できます。

インテリジェンスと調査

ai-intent.json とは何ですか？ ai-intent.json は、実際のユーザーの質問（AI アシスタントに入力される内容）と、それぞれの質問に回答するのに最適なウェブサイト上のページを対応付けます。これがなければ、AI はどのページを推奨するか推測します。これがあれば、よくある質問ごとに直接 URL を AI に提示できます。

ai-entities.json と ai-schema.json は何のためにありますか？ ai-entities.json は、商品、カテゴリ、サービス、重要な概念など、ウェブサイトの重要な要素を構造化してまとめたカタログです。AI ナレッジグラフを支えます。ai-schema.json は Schema.org 標準を使用して、組織を機械可読形式で記述します。これにより、検索エンジンや AI システムが曖昧さなく組織を識別できます。

RAG インデックスファイルとは何ですか？ rag-index.json と rag-index.jsonl は、AI の調査や検索パイプライン向けに作られた、ウェブサイトのすぐに使えるインデックスです。ユーザーが質問すると、AI は回答を生成する前に、このインデックスから最も関連性の高いドキュメントを取得します。これにより、実際のコンテンツに基づいた回答ができます。

ポリシーとメンテナンス

トレーニングデータポリシーとは何ですか？ training-data-policy.txt は、モデルのトレーニング、RAG インデックス作成、商用利用など、AI 企業がお客様のコンテンツをどのように利用できるかについて、正式なルールを定めます。すべてのブランドがあらかじめ決めておくべき実務的な問い、つまり「他者は自社のコンテンツをどのように利用できるのか」に答えるものです。

ai-disclosure.txt とは何ですか？ ai-disclosure.txt は、コンテンツの生成、レコメンデーション、顧客とのやり取りなど、組織が AI をどのように利用しているかを説明する公開の透明性レポートです。誰かに尋ねられる前にこれらの疑問に答えることで、信頼を築きます。

AI 対応ファイルはどのくらいの頻度で更新すべきですか？ ファイルによって異なります。llms.txt とサイトマップは、毎月、またはサイト構成の変更時に更新してください。ai.txt と llms-full.txt は、四半期ごと、または製品の変更時に更新してください。ポリシーファイルは毎年確認してください。manifest.json ファイルには、このキット内のすべてのファイルについて推奨される更新頻度が記載されています。

---

リファレンスドキュメント

references/file-specs.md ファイルには、各ファイルの詳細な仕様（必須の構成、主要なフィールド、要約された例）が記載されています。スキルの実行時に自動で読み込まれます。

scripts/gen_jsonl.py ユーティリティは、埋め込みパイプラインで使用できるように rag-index.json を rag-index.jsonl 形式に変換します。

python3 scripts/gen_jsonl.py rag-index.json rag-index.jsonl

---

PDF ガイド

docs/ フォルダーには、各ファイルについて平易な英語と技術的な詳細で説明する PDF リファレンスガイドが含まれています。

ガイド	対象読者	対象ファイル
AI Readiness Guide — With Plugin	一般／非技術者	全 17 ファイル（ai-plugin.json を含む）
AI Readiness Guide — No Plugin	一般／非技術者	16 ファイル（ai-plugin.json を除く）
Developer Reference — With Plugin	Web 開発者	全 17 ファイル、コンパクトな技術形式
Developer Reference — No Plugin	Web 開発者	16 ファイル、コンパクトな技術形式

---

スキルファイルの構成

ai-readiness/
├── ai-readiness.skill          ← Claude Cowork installable skill (download & open)
├── SKILL.md                    ← Raw skill definition — works in any AI assistant
├── README.md                   ← This file
├── references/
│   └── file-specs.md           ← Detailed specs for all output files
├── scripts/
│   └── gen_jsonl.py            ← JSONL generator utility
└── docs/
    ├── ai-readiness-guide-with-plugin.pdf
    ├── ai-readiness-guide-no-plugin.pdf
    ├── ai-readiness-guide-dev-with-plugin.pdf
    └── ai-readiness-guide-dev-no-plugin.pdf

---

作者・会社

Russ Wittmann — Silverback Marketing、テクノロジー担当上級副社長
LinkedIn · X / Twitter

アリゾナ州クイーン・クリークにある Silverback Marketing は、ROI を重視するデジタルマーケティング代理店です（2007 年創業）。戦略、コンテンツ、テクノロジーを通じて、企業の成長を支援しています。このスキルは、Silverback の AI 対応支援サービスの一環として構築されました。AI 検索の時代にクライアントが見つけてもらえるよう支援します。

🔗 ai.silverbackmarketing.com · silverbackmarketing.com

---

ライセンス

MIT — 著作者の表示があれば、自由に使用、変更、配布できます。LICENSE を参照してください。