Claude Code / Codex 用エージェントスキル
SEO の判断を、エージェントが再現できる形に
判断基準そのものは Google が公開しています。それを手順に落としたのがこのスキルです。技術 SEO、構造化データ、Core Web Vitals、E-E-A-T、AI 検索、サイト監査までを扱います。中身は Markdown だけなので、API キーも MCP サーバーも要りません。
- Markdown のみ
- 日本語・英語
- MIT ライセンス
ほかとの違い
ほかと違うのは 3 点
依存ゼロ
中身は Markdown だけです。用意する API キーも、動かし続ける MCP サーバーも、実行するスクリプトもありません。フォルダを置けばオフラインで動きます。
エッジと静的サイトに強い
Astro と Cloudflare Workers / Pages には専用の参照ファイルがあります。アイランドのハイドレーションが INP・LCP に効いてくる仕組み、_redirects・_headers と Worker のコードを併用したときの死角、D1 / KV から作る動的サイトマップ、エッジでのクローラー検証まで扱います。
古い記述を検知する
すべての参照ファイルに last_verified の日付が入っていて、CI がそれを検査します。検証で直した記述は docs/research-notes.md の一次情報まで辿れます。リリースは semver に従い、毎月の定期ワークフローが再検証の issue を立てます。
カバー範囲
中身は 8 つの参照ファイル
振り分けは SKILL.md が担い、合致した参照ファイルだけが読み込まれます。日本語版・英語版とも同じ 8 つです。
技術 SEO technical-seo.md
robots.txt、サイトマップ、canonical、hreflang、インデックス状況、リダイレクトとステータスコードの扱い。
コンテンツ SEO content-seo.md
メタタグ、見出し構造、内部リンク、そして実際に検証できる E-E-A-T シグナル。
構造化データ structured-data.md
JSON-LD テンプレート。Article、Product、LocalBusiness、BreadcrumbList、VideoObject、Organization、WebSite、Event。
Core Web Vitals core-web-vitals.md
LCP・INP・CLS の原因、コードとしての対処、そして直ったことを確かめる計測スクリプト。
AI 検索 / GEO / LLMO ai-search.md
AI Overviews と AI モード、GPTBot・ClaudeBot・Google-Extended のクローラー制御、引用されやすい書き方、エンティティの明確化、情報の独自性。
Astro SEO astro-seo.md
client ディレクティブとハイドレーションのコスト、@astrojs/sitemap、ClientRouter、Content Collections。Astro 6 で検証済み。
エッジ SEO edge-seo.md
Cloudflare Workers / Pages。_redirects、_headers、X-Robots-Tag、HTMLRewriter、D1 / KV のサイトマップ、Pages Functions。
監査ワークフロー audit-workflow.md
段階を踏む監査手順と、そこから出るレポート形式。同じサイトを 2 回測ったときに比べられます。
使い方
普通の言葉で頼む
どの参照ファイルを開くかは、スキルの description 側で決まります。ファイル名もスキル名も、こちらから指定しません。
- このページのメタタグを最適化して
- この記事に Article 構造化データを追加して
- このサイトの SEO 監査をして
- ここの LCP はどう改善できる？
- このサイトに llms.txt は必要？
Claude が seo-mastery を読み込み、合致する参照ファイルを開いて、そこにある基準に沿って答えます。参照元は、うろ覚えのブログ記事ではありません。
インストール
コマンド 2 つで入ります
1マーケットプレイスを追加
claude plugin marketplace add kpab/seo-mastery-agent-skills2プラグインをインストール
claude plugin install seo-mastery@seo-mastery-agent-skills
英語版と日本語版の両方が入り、プラグインマネージャーからそのまま更新できます。
ファイルを直接置きたい場合
リポジトリをクローンして、.claude/skills/seo-mastery をプロジェクトへコピーします。Codex の置き場所は .agents/skills で、作業ディレクトリからリポジトリのルートまで各階層が走査されます。スキルは SKILL.md と参照ファイルで 1 組です。SKILL.md だけをコピーしても動きません。
ファイル構成
リポジトリに入るもの
英語版と日本語版の 2 つが入ります。同期は CI が保っていて、英語版が原本です。
.claude/skills/ ├── seo-mastery/ # 英語版 │ ├── SKILL.md # 振り分けと概要 │ ├── technical-seo.md │ ├── content-seo.md │ ├── structured-data.md │ ├── core-web-vitals.md │ ├── ai-search.md │ ├── astro-seo.md │ ├── edge-seo.md │ └── audit-workflow.md └── seo-mastery-jp/ # 日本語版（同じ 9 枚）
基準が書いてあるのは参照ファイルのほうです。SKILL.md だけでは中身がありません。
更新方針
保証していること、していないこと
SEO の情報は古びます。このリポジトリは「全行がいま正しい」とは主張しません。保証しているのは、手順と日付です。
日付が入っている
.claude/skills 配下のすべてのファイルに last_verified があります。存在すること、日付として妥当なこと、未来でないこと、英語版と日本語版で一致していること。この 4 つを CI が検査します。
出典が辿れる
検証で追加・修正した記述は、docs/research-notes.md から一次情報へ辿れます。まとめ記事ではなく、提供元のドキュメントです。
バージョンが付く
semver を知識ベース向けに読み替えています。MAJOR は助言の反転や参照ファイルの削除、MINOR は知識の追加、PATCH は修正と鮮度更新。SKILL.md・2 つのマニフェスト・CHANGELOG の見出し・git タグが食い違うと、リリースが失敗します。
定期的に見直す
毎月、定期ワークフローが再検証の issue を立てます。古びた記述がファイルの中で黙って残らず、作業として表に出ます。
最新記事同じ基準を、今年動いたところに当てたものが2026 年、SEO で実際に変わった 6 つのことです。記述にはすべて日付が入っていて、Google のドキュメントまで辿れます。
FAQ