site-architecture
作成者 alirezarezvanisite-architecture は、AI エージェントが Technical SEO の観点から、Web サイト構造、URL 階層、ナビゲーション、クロール経路、breadcrumbs、internal linking を監査・設計するための skill です。URL design と internal linking のガイドに加え、根拠に基づくサイト構造の提案に役立つ sitemap analyzer script も含まれています。
この skill は 84/100 の評価で、Web サイトの情報設計や internal linking を監査・再設計したいディレクトリ利用者にとって有力な掲載候補です。リポジトリ上の根拠から、トリガーの明確さ、ワークフローの深さ、参考資料、実用的な分析スクリプトが十分に確認でき、一般的な SEO プロンプトよりも実務で使える支援が期待できます。一方で、インストールや初期導入に関するパッケージングはもう少し分かりやすいとよいでしょう。
- frontmatter のトリガー範囲が明確で、site architecture、URL structure、navigation、breadcrumbs、topic clusters、orphan pages、構造的な SEO 課題をカバーしつつ、content strategy と schema markup は対象外として示されています。
- 長めの SKILL.md、文脈収集用プロンプト、11 個の H2 セクション、20 個の H3 セクション、internal linking と URL design の実践的な参考資料により、運用面の内容がしっかり支えられています。
- sitemap.xml を解析し、階層の深さ、URL パターン、重複パス、orphan 候補、JSON サマリー出力を確認できる stdlib Python 製の sitemap analyzer が含まれています。
- skill フォルダ内にインストールコマンドや README がないため、ディレクトリ利用者は親リポジトリの慣例から導入方法を推測する必要があるかもしれません。
- 確認できる範囲では SEO アーキテクチャのガイダンスは充実していますが、ワークフローの抜粋が一部省略されているため、エンドツーエンドの実行手順全体に対する確信は絶対的ではありません。
site-architecture skillの概要
site-architectureが解決すること
site-architecture skillは、AIアシスタントがWebサイト構造を監査・再設計・計画するためのスキルです。技術SEO、クロールしやすさ、ナビゲーション、URL設計の健全性、内部リンク設計を整理する場面で役立ちます。特に、URLフォルダが乱れている、ハブページが弱い、孤立ページがある、ナビゲーションが分かりにくい、クロール経路が悪い、SEOリスクを抑えた情報設計でサイト移行したい、といった「構造上の問題」に向いています。
向いているユーザーとプロジェクト
このsite-architecture skillは、抽象的なマーケティング助言ではなく、実務に落とし込めるサイト構造の提案が必要なSEOコンサルタント、技術SEOチーム、コンテンツ責任者、創業者、開発者に向いています。SaaS、B2B、メディア型サイト、ドキュメントサイト、ECのカテゴリ構造、ローカルサービスサイト、トピッククラスターやhub-and-spokeモデルへ再編するサイトでは特に有用です。
汎用プロンプトより強い理由
汎用プロンプトでも「内部リンクを改善して」といった回答はできますが、このskillでは、現状・目標・制約の収集、URLパターンの評価、ナビゲーション階層の把握、内部リンクモデルの提案という明確な進め方が定義されています。リポジトリには references/internal-linking-playbook.md、references/url-design-guide.md、scripts/sitemap_analyzer.py も含まれているため、短いSEOチェックリストよりも実作業に使いやすい構成です。
このskillが向いていないケース
新規記事のテーマ決め、ページ本文のライティング、schema markupの実装、ゼロからのキーワード調査を主目的にする場合、site-architectureをメインツールとして使うのは適していません。ページをどこに配置し、どのようにつなぐべきかを明確にする補助にはなりますが、中心価値はコンテンツ企画や構造化データではなく、サイトアーキテクチャにあります。
site-architecture skillの使い方
site-architectureのインストールとリポジトリパス
GitHubのskillリポジトリから、次のコマンドでインストールします。
npx skills add alirezarezvani/claude-skills --skill site-architecture
ソースは alirezarezvani/claude-skills の marketing-skill/skills/site-architecture にあります。インストール後はまず SKILL.md を読み、その後に以下を確認してください。
references/internal-linking-playbook.mdreferences/url-design-guide.mdscripts/sitemap_analyzer.py
このskillフォルダには個別のREADMEやmetadataファイルはありません。そのため、主な運用手順は SKILL.md と2つのリファレンスガイドにまとまっています。
site-architectureを使いやすくする入力情報
site-architectureを効果的に使うには、「SEO構造を直して」だけでは不十分です。次のような情報を渡すと精度が上がります。
- WebサイトURLとCMSまたはフレームワーク
sitemap.xmlのURL、またはエクスポートしたサイトマップ- セクション別のおおよそのページ数
- 主なビジネスモデル: lead gen、SaaS、e-commerce、media、local、documentation
- 既知の問題: 孤立ページ、重複ページ、薄いカテゴリページ、クロール膨張、順位低迷
- 上位表示したい、または守りたい重要ページ
- 制約: URL変更不可、移行期限、CMSの制限、開発リソース
より良いプロンプト例は次のとおりです。
Use the
site-architectureskill to audit our B2B SaaS site. Sitemap:https://example.com/sitemap.xml. We have feature pages, solution pages, integrations, docs, and 250 blog posts. Our priority is ranking solution pages without changing existing high-performing blog URLs. Identify structural issues, recommend URL folder rules, navigation changes, hub pages, and internal links. Flag anything that needs redirects or developer work.
アーキテクチャ監査のおすすめワークフロー
まずは根拠から始めます。サイトマップがある場合は、scripts/sitemap_analyzer.py を実行するか、アシスタントに使わせて、URL階層の深さ、セクション分布、重複しそうなパスパターン、孤立候補のページを確認します。そのうえで url-design-guide.md と照らし合わせ、一貫性のないslug、深すぎるフォルダ、日付ベースのブログパス、trailing slashルールの混在、不明瞭なセクション名を見つけます。
次に、internal-linking-playbook.md を使ってリンク設計の型を選びます。トピックの権威性を高めるならhub-and-spokeが適していることが多く、コースやドキュメントには線形リンク、ECにはカテゴリから商品へのモデルが合います。リソースが限られている場合は、全面的な再設計ではなく、優先順位付きの修正リストを依頼すると実行しやすくなります。
実務で使いやすいプロンプトの型
site-architectureのガイドを依頼するプロンプトでは、期待する出力形式まで指定すると効果的です。例:
Produce: 1) current architecture diagnosis, 2) URL rule recommendations, 3) proposed navigation model, 4) internal linking plan by page type, 5) redirect/migration risks, 6) 30-day implementation plan, 7) open questions.
こうしておくと曖昧な助言が減り、SEO、コンテンツ、開発チームにそのまま渡せる判断材料に近づきます。
site-architecture skillのFAQ
site-architectureはTechnical Seo作業に使えますか？
はい。site-architecture for Technical Seoは、クロール経路、インデックス可能なURLパターン、サイト階層の深さ、内部リンク、breadcrumbs、構造上の重複パターン、移行時に安全なURL判断が関わるタスクに適しています。一方で、ログファイル分析、Core Web Vitalsのデバッグ、schema実装には、それらがサイト構造と直接関係していない限り、あまり向いていません。
初心者でも使えますか？
はい。ただし初心者は、具体的なサイト情報を渡し、説明もあわせて依頼するとよいです。このskillには実務的なリファレンスが含まれているため、「各提案の理由と、クロールしやすさや検索順位にどう影響するかも説明して」と依頼できます。初回は全面的な再設計を求める前に、まず診断を依頼するのがおすすめです。
通常のSEOプロンプトと何が違いますか？
通常のSEOプロンプトでは、「内部リンクを増やす」「URLを短くする」といった大まかな提案になりがちです。このskillは、現状、目標、制約、URL設計、ナビゲーション、リンクアーキテクチャを分けて扱うため、より構造化されています。付属のsitemap analyzerにより、生のサイトマップデータから実行可能な発見につなげやすい点も違いです。
インストールを避けたほうがよいケースは？
ブログトピックのアイデア、metadataの書き換え、商品説明文、schema snippetsだけが必要な場合は、site-architectureをインストールする必要はありません。また、リスクの高いサイト移行で唯一の判断材料として使うのも避けてください。アーキテクチャ計画の作成には使えますが、redirects、canonicals、analytics、クロールデータは、利用中のSEOツールで必ず検証するべきです。
site-architecture skillを改善する方法
実サイトの根拠データを渡す
site-architectureの出力を改善する最良の方法は、サイトマップ、現在のナビゲーション、主要なページタイプ、順位上の優先度を渡すことです。ドメインを共有できない場合は、セクション別に匿名化したURL例を提示してください。実例があると、問題が階層の深さなのか、命名なのか、重複なのか、弱いハブなのか、リンク不足なのかを判断しやすくなります。
観察だけでなく判断を求める
弱い依頼は「うちの構造をどう思いますか？」です。より良い依頼は次のようなものです。
Recommend the preferred URL structure for features, integrations, solutions, blog, and docs. Keep existing ranking blog URLs unchanged unless there is a clear SEO reason to migrate. Mark each recommendation as keep, change, merge, redirect, or investigate.
こうすることで、skillに実装前提のアーキテクチャ指針を出させやすくなります。
よくある失敗パターンに注意する
よくある失敗には、移行リスクを考えずにURL変更を勧める、ハブページを作りすぎる、意味を無視してすべてのURLを浅くする、文脈上役に立たない内部リンクを提案する、といったものがあります。アシスタントには、「安全なquick wins」と「移行レベルの変更」を分けさせ、各構造提案のSEO上のトレードオフを説明させてください。
初回出力のあとに反復する
最初の回答は最終計画ではなく、アーキテクチャ案のドラフトとして扱います。その後、クロールデータ、Search Consoleのエクスポート、analytics上の優先度、CMS制約、開発者からのフィードバックを追加してください。次にsite-architecture skillへ、即時に実施する内部リンク、ナビゲーション整理、URL運用ルール、中長期の再構築を含む段階的なロードマップへ修正するよう依頼します。