Communityライティング&編集github.com

k97/skills

AIコーディングエージェント向けスキル。codebase-seo:SEO + GEO監査を実施し、リダイレクトループを追跡、JSON-LDを検証、コードベースに修正を適用します。

skills とは?

codebase-seoは、AIコーディングエージェント(Claude Code、Cursor、Codexなど)向けに設計されたスキルで、技術的SEO監査、GEO(AI引用対応性)レビュー、およびコード修正の適用を3フェーズで自動化します。Next.js / TypeScriptプロジェクトをデフォルトとし、`--audit`、`--geo`、`--fix`、`--full`の各フラグでフェーズを制御できます。スクリプトは`curl`とNode 18+のみで動作し、リダイレクトトレース、JSON-LD抽出、メタ監査を実行。フェーズ1では技術監査、フェーズ2ではGEOレビュー(botアクセス確認、スキーマギャップ特定)、フェーズ3では報告された問題をコードベースに直接修正します。ホストリダイレクトのループ防止や、架空のデータ値の禁止など、堅牢なルールに従います。

対応✓Claude Code~Codex CLI~Cursor
npx skills add k97/skills

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

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

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

ドキュメント

codebase-seo

監査、続いてGEOレビュー、そして修正の適用。Next.js / TypeScriptをデフォルトとしますが、リポジトリが既に使用しているものに従います。${CLAUDE_SKILL_DIR}はこのスキルのディレクトリです。作業ディレクトリはユーザーのプロジェクトですので、バンドルされたファイルはこのパスを通じて参照します。

フラグフェーズコードの書き込み
--audit1 — 技術的SEOいいえ
--geo2 — AI引用対応性いいえ
--fix3 — コンテキスト内の調査結果を適用はい
--full1 → 2 → 3 (デフォルト)はい

--routes /,/pricing でスコープを絞ります。デフォルトはすべてのルートです。

セットアップ

  • ローカルパス と ライブURLの両方を優先します。それぞれが他方では検出できないものを捕捉します。
  • .agents/product-marketing.md または .claude/product-marketing.md が存在する場合は読み込みます。回答がない場合のみ質問します。
  • --fix を使用するには、コンテキストにレポートが必要です。ない場合は --full を実行します。

スクリプト

curl と Node 18+ が必要で、インストールは不要です。ソースコードを読む前にこれらを実行します。証拠を生成し、ソースコードの検査がそれを説明します。エラーレベルの発見がある場合、それぞれは非ゼロで終了します。Nodeスクリプトに --json を追加すると、構造化された出力が得られます。

bash "${CLAUDE_SKILL_DIR}/scripts/redirect-trace.sh" example.com /pricing /blog
node "${CLAUDE_SKILL_DIR}/scripts/extract-jsonld.mjs" https://example.com/pricing
node "${CLAUDE_SKILL_DIR}/scripts/audit-meta.mjs" https://example.com/pricing
node "${CLAUDE_SKILL_DIR}/scripts/audit-meta.mjs" out/pricing.html --base https://example.com

実際のルートを redirect-trace.sh に渡します。ループは / ではなく、深いパスで隠れていることがよくあります。

3つすべてのスクリプトは、サーバーサイドレンダリングされたHTMLのみを読み取ります。クライアントが注入したJSON-LDは、web_fetch と同様に、これらからは見えません。スクリプトの結果だけで「スキーマが見つかりません」と絶対に書かず、ブラウザで確認してください。

フェーズ1 — 技術監査 (--audit)

${CLAUDE_SKILL_DIR}/references/technical-audit.md を読み、そのチェックリストを実行します。最初にスクリプトを実行し、次にソースコードを使用して各発見事項を見つけ、説明します。

発見事項ごとに報告:

File: app/page.tsx:37-41
Severity: Critical | High | Medium | Low
Root cause: <1文>
Impact: <検索、ソーシャル、AI引用で何が壊れるか>
Fix: <最小限の変更、ファイル + 行>
Effort: <5分 | 30分 | プロダクト判断>

重大度でグループ化し、最後に表で締めくくります: # | 発見事項 | 重大度 | 工数 | リリースをブロックするか?

フェーズ2 — GEOレビュー (--geo)

${CLAUDE_SKILL_DIR}/references/geo.md を読みます。コピーするJSON-LD: ${CLAUDE_SKILL_DIR}/references/schema-recipes.md

最初にbotアクセスを確認します。クローラーがブロックされている場合、このフェーズの他のものは重要ではありません。

絶対に主張してはいけない2つのこと: スキーマタイプに「プリンストン大学の研究による」引用収益ランキングがあること(その研究はコンテンツ戦術をテストしたものであり、スキーマではありません)、および予測されるトラフィック増加。どちらもコードベースから観測可能ではなく、それらをでっち上げると実際の発見事項の信頼性を損なう。

出力は スキーマのギャップ、コンテンツの機会、アーキテクチャ上の決定 としてグループ化します。

フェーズ3 — 修正 (--fix)

フェーズ1とフェーズ2の発見事項を適用します。作業ツリーを編集して停止 — git add も git commit もしません。レビューとコミットはユーザーに属します。

  • リポジトリのフレームワーク、ファイルレイアウト、スペルに合わせます。方言を押し付けないでください。
  • 各編集の前に正確なファイルと行を指定します。最小限の変更で、ついでのリファクタリングや any は禁止です。
  • スキーマフィールドを実際のデータソースに配線します。変動する値をハードコードしないでください。
  • aggregateRating を決してでっち上げないでください。削除し、「実際のデータが必要」の下にリストします。
  • i18nアーキテクチャ、スキーマ説明以外のコピー、およびレポートがプロダクト入力を必要とするとマークしたものはスキップします。

ホストリダイレクト — 厳格なルール。 ホスティングプラットフォームが既に実行しているものをアプリレベルで複製する www↔apex、http↔https、または末尾スラッシュのリダイレクトは、ピンポン状態を引き起こし、ERR_TOO_MANY_REDIRECTS を生成し、サイトをダウンさせます。ホストの正規化はプラットフォームに任せます。ループを修正するには、アプリレベルのリダイレクトを 削除 することによって行い、決して別のリダイレクトを追加してはいけません。正規URLと実際に配信されるホストが単に一致しない場合は、メタデータを実際に提供されているホストに合わせるように変更します。メタデータに合わせるためのリダイレクトではありません。

バッチ1: フェーズ1からのすべてのCritical、High、Mediumの発見事項を重大度順に。 バッチ2: フェーズ2のスキーマ作業。

報告が完了する前に検証してください。 編集だけの強度で成功を主張しないでください。

  1. プロジェクトがビルドされること (npm run build、またはリポジトリが使用するもの)。
  2. extract-jsonld.mjs が、ビルドされたHTMLまたは開発サーバーに対してクリーンにlintされること。
  3. audit-meta.mjs が、変更されたすべてのルートで成功すること。
  4. リダイレクトに触れた場合は redirect-trace.sh が成功すること。

実行できなかったステップとその理由を報告します。

出力セクション: 変更されたファイル (バッチごと)、検証、プロダクト判断が必要、実際のデータが必要。

関連スキル