seo-audit

seo-auditスキルの概要

seo-auditスキルでできること

seo-audit スキルは、ありきたりなアドバイスにすぐ飛びつくのではなく、構造化されたSEOレビューをエージェントに実行させるためのスキルです。オーガニック検索でサイトの成果が伸びない理由を診断し、最初に何を確認すべきかを整理し、その結果を優先順位付きのアクションプランに落とし込むことを目的に作られています。

このseo-auditスキルを入れるべき人

特に向いているケース:

• 再現性のあるSEO診断フローを持ちたいマーケターや創業者
• SaaS、コンテンツサイト、企業サイトを監査するエージェント
• トラフィック減少、インデックス不具合、順位低迷、オンページの問題が曖昧な状況に対応しているチーム
• 単発のプロンプトより強い seo-audit guide を求めている人

あまり向いていないケース:

• schema実装の詳細だけをピンポイントで見たいユーザー
• プログラマティックSEOのページ生成を進めているユーザー
• 従来の検索監査よりもAI検索最適化を主目的にしているユーザー

このスキルが実際に解決する仕事

SEO監査を依頼する人の多くは、単なるチェックリストが欲しいわけではありません。知りたいのは次のようなことです。

• 何が順位の足を引っ張っていそうか
• まずどの証拠を集めるべきか
• 十分なアクセス権がない状態で何を断言すべきでないか
• 今、どの問題の優先度が高いか

このスキルが実用的なのは、監査の順番を強制してくれるからです。まず crawlability と indexation、次に技術基盤、その後にオンページ最適化、コンテンツ品質、最後に authority や links を見ます。この順序によって、価値の低い提案がサイト全体の深刻な健全性問題を覆い隠すのを防げます。

一般的なプロンプトと違うseo-auditスキルの強み

実務上の違いは次の通りです。

• ローカルのコンテキストファイルがある場合、まず product marketing の文脈を確認するよう指示している
• 何も確認せずに監査を始めるのではなく、欠けている事業・サイト文脈を先に聞く
• 指摘事項に明確な優先順位づけがある
• HTMLの取得結果だけに頼る場合、schema markup 検出には限界があると明示している
• executive summary と優先度付きアクションを含むレポート構成を前提にしている

こうした違いは重要です。弱いSEO監査ほど、自信ありげに見えても indexing の基本を飛ばしたり、限られたアクセス権で確認できる範囲を言い過ぎたりしがちだからです。

seo-auditスキルの使い方

seo-auditのインストール方法

リポジトリからのインストールは次のコマンドです。

npx skills add https://github.com/coreyhaines31/marketingskills --skill seo-audit

これにより、coreyhaines31/marketingskills リポジトリ内の skills/seo-audit からスキルが追加されます。スキル自体に別個のインストーラーはないため、実用上の seo-audit install は上記の標準 Skills コマンドになります。

初回利用前に読むべきファイル

短時間で要点をつかむなら、次の順に開くのがおすすめです。

1. skills/seo-audit/SKILL.md
2. skills/seo-audit/evals/evals.json
3. skills/seo-audit/references/ai-writing-detection.md

この順番がよい理由:

• SKILL.md で監査フローとスコープを把握できる
• evals/evals.json で「良い実行」がどういうものか見える
• writing の参考資料は、監査出力を読みやすく、機械的すぎない文面に保つのに役立つ。クライアントや社内ステークホルダーに共有するなら特に重要

seo-auditスキルに必要な入力

seo-audit usage の質は、与える入力に大きく左右されます。最低限、次の情報は渡したいところです。

• サイトURL
• サイト種別: SaaS、e-commerce、publisher、local business、marketplace など
• SEOの目的: リード増、非指名流入の増加、下落後の回復、重要ページの順位改善
• ターゲットキーワードまたはトピッククラスター
• 既知の問題: migration、redesign、CMS変更、トラフィック減少、インデックス関連の不満
• 監査範囲: サイト全体、特定セクション、テンプレート、単一ページ
• アクセスレベル: 公開Webのみ、Search Consoleデータあり、analytics あり、crawl exports あり、competitor URLs あり

これらを省略してもスキル自体は使えますが、出力は見える範囲のオンページ確認と、広めの技術的ヒューリスティックに寄りやすくなります。

質問の前にローカルコンテキストを確認する

この seo-auditスキルで見落とされやすい一方、とても有用なのが、 .agents/product-marketing-context.md または .claude/product-marketing-context.md があれば最初に読む、という指示です。プロジェクトのリポジトリ内でこのスキルを使う場合、これだけでターゲット顧客、ポジショニング、優先ページに関する初歩的な往復をかなり減らせます。

SEOの提案は、実際のプロダクト、ファネル、市場と結びついているほど精度が上がるため、監査品質の改善効果は大きいです。

雑な依頼を、強いseo-auditプロンプトに変える

弱い入力:

• "Do an SEO audit of our site"

より強い入力:

• "Run an SEO audit for https://example.com. We are a B2B SaaS company selling payroll software for remote teams. Primary goal is demo signups from non-brand organic search. Priority keywords are global payroll software, employer of record payroll, and multi-country payroll. Organic traffic dropped about 25% after a site redesign six weeks ago. Focus on crawlability, indexation, title and heading quality, internal linking, and content gaps on money pages. If something cannot be verified from public fetch alone, say so clearly."

この依頼が機能する理由:

• 事業コンテキストが入っている
• 成功条件が定義されている
• 監査範囲が絞られている
• 根拠に基づく不確実性を許容し、見せかけの断定を避けられる

想定どおりの監査順序で使う

よくあるミスは、いきなりコピー修正から入ることです。このスキルは、意図された順番で使ってこそ価値が出ます。

1. Crawlability and indexation
2. Technical foundations
3. On-page optimization
4. Content quality
5. Authority and links

この順序は結果を変えます。ページがブロックされていたり、canonical が誤っていたり、内部リンクが弱かったりするなら、meta descriptions を書き換えても根本問題は解決しません。

実務上、seo-auditスキルが見るべき項目

リポジトリ内のシグナルと eval の期待値を見る限り、良い seo-audit usage には次のような確認が含まれるべきです。

• robots.txt
• XML sitemap の有無と品質
• indexation と crawl のシグナル
• サイト構造と内部リンクの設計
• title tags と meta descriptions
• heading 構造
• コンテンツの関連性と最適化状況
• 発見性やパフォーマンスに影響しそうな技術的問題

そのうえで、単なる観察メモの羅列ではなく、意思決定に使えるレポートとして整理する必要があります。

schema検出の限界を軽視しない

これは細かい注記ではなく、実運用で重要な採用判断ポイントです。このスキルは、基本的なページ取得結果だけを根拠に "no schema markup found" と断言しないよう、明確に警告しています。多くのサイトでは schema が client-side で挿入されたり、単純な fetch では拾えない形で出力されたりするためです。

適切な出力例は、たとえば次のようなものです。

• "Schema markup could not be reliably verified from current fetch-based inspection."
• "Validate with rendered HTML, source inspection, or a schema testing workflow before concluding it is missing."

こうした慎重さがあるぶん、断定しすぎる監査より seo-audit skill の信頼性は高くなります。

想定されたレポート構成を使う

引き継ぎや共有に耐える実務品質を出すには、スキルに次の構成で出力させるのが有効です。

• Executive Summary
• Technical SEO Findings
• On-Page SEO Findings
• Content Findings
• Prioritized Action Plan

ここが大事なのは、ステークホルダーは生のメモでは動かないからです。根拠、影響度、次の打ち手が整理された優先順位つきの論点なら動いてくれます。

evalsで出力品質を見極める

skills/seo-audit/evals/evals.json は、このスキルを信頼して使い続けるか判断するうえで、最も参考になるファイルのひとつです。ここを見ると、期待されている挙動が分かります。

• 文脈が足りないときは確認質問をする
• content polish より crawlability を優先する
• robots と sitemap の基本確認を行う
• schema について根拠のない断言を避ける
• 使える構造で findings を提示する

もしエージェントがこれらを実行していないなら、その時点でスキルをきちんと踏襲できていないと考えたほうがよいです。

seo-auditスキル FAQ

このseo-auditスキルは初心者にも向いているか

はい。特に、筋のよい監査の順番を必要としている初心者には向いています。場当たり的なSEOチェックを防ぎ、出発点となるフレームを明確にしてくれます。ただし、どのページと検索クエリが重要かを理解する代わりにはならないので、事業コンテキストは自分で渡す必要があります。

AIに直接SEO監査を頼むのと何が違うのか

普通のプロンプトでも、それらしく見えるSEOのヒント一覧は出てきます。ですが、このスキルが優れるのは次の点です。

• 監査順序が定義されている
• スコープ確認の質問がうまい
• 根拠の薄い断言が減る
• 最終レポートの使い勝手が高い

実務上の最大の利点は、「機能が多い」ことではありません。推測頼みが減り、優先順位づけが良くなることです。

seo-auditをSEO Content用途に使えるか

はい。ただし期待値の置き方は重要です。このスキルは seo-audit for SEO Content にも使え、オンページ最適化、コンテンツ品質、関連性の問題をレビューできます。ただし、主目的は content brief の生成ではありません。既存ページが search intent、metadata、headings、site structure と整合しているかを診断し、その後に何を書き換えるか、何を新規作成するかを判断するために使うのが適しています。

Search Consoleやanalyticsのアクセスは必要か

いいえ。公開サイトの確認だけでも利用できます。ただし、到達できる品質の上限は下がります。Search Console、analytics、crawl exports がない場合、このスキルができるのは「起きていそうな問題の特定」までで、すべてのパフォーマンスや indexation の主張を完全に検証することはできません。

どんな場合はこのスキルを使わないほうがいいか

次のニーズが中心なら、このスキルは見送ったほうがよいです。

• schema markup の追加やデバッグだけをしたい
• キーワードカバレッジ目的で大規模なページ生成をしたい
• 従来型SEOの診断ではなく、AI検索での可視性戦略を立てたい

また、根本原因を把握する前に修正実装へすぐ進みたいユーザーにも、相性はあまりよくありません。

writing referenceは本当に関係あるか

はい。監査出力をクライアント向けに出す場合や、社内配布する場合には特に関係があります。references/ai-writing-detection.md はSEOフレームワークそのものではありませんが、伝わり方の質を上げてくれます。より自然で、いかにも機械生成に見えにくい提案のほうが、チームに信頼され、採用されやすくなります。

seo-auditスキルを改善する方法

事業コンテキストをもっと具体的に渡す

seo-audit skill を改善する最短ルートは、汎用スキャナーのように扱うのをやめることです。少なくとも次は伝えましょう。

• 誰が対象読者・顧客なのか
• どのページが最重要なのか
• どの conversion event が重要なのか
• 最近何が変わったのか
• どのクエリを重視しているのか

これだけで、監査は単なる "SEO observations" から "SEO decisions" に変わります。

サイトが大きいなら範囲を絞る

大規模サイトでは、曖昧なフル監査を頼むより、次のように範囲を区切ったほうが有効です。

• homepage と売上上位 5 ページ
• 1つの directory または blog section
• 1種類の template
• 1つの traffic-loss cluster

スコープが小さいほど、指摘は鋭くなり、提案も実行しやすくなります。

根拠と不確実性ラベルを求める

ふわっとした出力を避けるには、次の項目を明示するよう依頼してください。

• observed issue
• why it matters
• confidence level
• recommended fix
• expected impact
• what requires further validation

これは特に、公開情報だけでは確認しきれない technical や indexation の論点で有効です。

表面的な提案に流れないようにする

よくある失敗は、最初の出力が title、keywords、そして汎用的な "improve content quality" に偏りすぎることです。

これを防ぐには、次を明示して促します。

• crawl と index の blockers を先に見る
• 1ページ単位の細かい指摘だけでなく、page template のパターンを見る
• 優先ページへの内部リンク経路を確認する
• 事業意図と実際に順位が付いているページタイプのズレを見る

こうすることで、seo-audit は見た目の修正ではなく、効くレバレッジに集中しやすくなります。

強いページと弱いページの例を渡す

どのページが好調で、どのページが伸びていないか分かっているなら、両方を共有しましょう。そうするとスキルは次の比較ができます。

• title format
• heading depth
• content structure
• internal links
• intent match
• conversion alignment

ドメイン全体を手探りで監査させるより、比較材料を与えたほうが提案の質は上がりやすいです。

1回目の監査後に反復する

最初のパスで目指すべきなのは、完成版ロードマップではなく、優先順位付きの論点整理です。続けて投げるプロンプトとしては、たとえば次が有効です。

• "Expand only the top 3 technical issues with validation steps."
• "Turn the content findings into page-specific rewrite priorities."
• "Separate quick wins from engineering-heavy fixes."
• "Map each recommendation to likely impact and effort."

これが、seo-audit usage を実行計画に変えていく最も良いやり方です。

限られたアクセスでの言い過ぎに注意する

エージェントが crawl できない、JavaScript を render できない、あるいは platform settings を確認できないなら、全面的に見えているかのような口ぶりをさせてはいけません。この点については、スキル自体がすでに正しい方向を示しています。その慎重さは維持すべきです。信頼性が上がり、false positives も減らせます。

出力はトリアージ層として使う

この seo-audit guide は、専門的な作業に入る前の一次診断レイヤーとして使うと最も力を発揮します。用途としては次の通りです。

• 起きていそうな blockers を特定する
• 調査の優先順位をつける
• ステークホルダー向けの要約を準備する
• より深い technical SEO、content work、implementation support が必要か判断する

スキル単体で完全なSEOツール群やライブ環境へのアクセスを置き換えようとするより、この役割のほうがはるかに現実的で強い使い方です。