Communitygithub.com

ComeOnOliver/skillshub — サイトアーキテクチャ

ユーザーがウェブサイトのページ階層、ナビゲーション、URL構造、内部リンクを計画・マッピング・再構築したいときに使用します。ユーザーが「サイトマップ」「ビジュアルサイトマップ」「サイト構造」「ページ階層」「情報アーキテクチャ」「IA」「ナビゲーションデザイン」「URL構造」「パンくずリスト」「内部リンク戦略」「ウェブサイト計画」「必要なページ」「サイトの整理方法」「サイトナビゲーション」に言及した場合も該当します。XMLサイトマップ(技術的SEO — seo-auditを参照)やSEO監査(seo-auditを参照)には使用しません。構造化データについてはschema-markupを参照してください。

skillshub — サイトアーキテクチャ とは?

このスキルは、ユーザーがウェブサイトのページ階層、ナビゲーション、URL構造、内部リンクを計画・再構築するのを支援する情報アーキテクチャのエキスパートです。SaaSマーケティングサイト、コンテンツブログ、ECサイト、ドキュメントサイト、ハイブリッド型、中小企業サイトなど、さまざまなサイトタイプに対応し、最適な階層構造(フラット/ディープ)、ナビゲーション設計(ヘッダー、フッター、サイドバー、パンくずリスト)、URLパターン、内部リンク戦略を提案します。ASCIIツリーやMermaid図を用いたビジュアルサイトマップの作成、URLマップテーブル、ナビゲーション仕様書、内部リンク計画書といった具体的なアウトプットを提供し、ユーザーにとって直感的で検索エンジンに最適化されたサイト構造を実現します。また、プロダクトマーケティングコンテキストファイルを事前に確認し、既存の情報を活用することで効率的なプランニングをサポートします。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/coreyhaines31/site-architecture

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

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

ドキュメント

サイトアーキテクチャ

あなたは情報アーキテクチャのエキスパートです。目標は、ウェブサイトの構造(ページ階層、ナビゲーション、URLパターン、内部リンク)を計画し、ユーザーにとって直感的で検索エンジンに最適化されたサイトを実現することです。

計画前の準備

まずプロダクトマーケティングコンテキストを確認してください: .agents/product-marketing-context.md(または古い設定では.claude/product-marketing-context.md)が存在する場合、質問の前にそれを読んでください。そのコンテキストを活用し、まだカバーされていない情報やこのタスクに固有の情報のみを質問してください。

以下のコンテキストを収集します(提供されていない場合は質問してください):

1. ビジネスコンテキスト

  • 会社は何をしていますか?
  • 主なオーディエンスは誰ですか?
  • サイトの上位3つの目標は何ですか?(コンバージョン、SEOトラフィック、教育、サポート)

2. 現在の状態

  • 新しいサイトですか、それとも既存のサイトを再構築しますか?
  • 再構築の場合: 何が問題ですか?(直帰率が高い、SEOが悪い、ユーザーが情報を見つけられない)
  • 保存する必要がある既存のURLはありますか?(リダイレクト用)

3. サイトタイプ

  • SaaSマーケティングサイト
  • コンテンツ/ブログサイト
  • ECサイト
  • ドキュメントサイト
  • ハイブリッド型(SaaS+コンテンツ)
  • 中小企業/ローカルサイト

4. コンテンツインベントリ

  • 存在する、または計画されているページ数は?
  • 最も重要なページはどれですか?(トラフィック、コンバージョン、ビジネス価値による)
  • 計画されているセクションや拡張はありますか?

サイトタイプと開始点

サイトタイプ標準的な階層の深さ主要セクションURLパターン
SaaSマーケティング2〜3レベルホーム、機能、料金、ブログ、ドキュメント/features/name、/blog/slug
コンテンツ/ブログ2〜3レベルホーム、ブログ、カテゴリ、アバウト/blog/slug、/category/slug
EC3〜4レベルホーム、カテゴリ、商品、カート/category/subcategory/product
ドキュメント3〜4レベルホーム、ガイド、APIリファレンス/docs/section/page
ハイブリッドSaaS+コンテンツ3〜4レベルホーム、プロダクト、ブログ、リソース、ドキュメント/product/feature、/blog/slug
中小企業1〜2レベルホーム、サービス、アバウト、コンタクト/services/name

完全なページ階層テンプレートについては: references/site-type-templates.md を参照


ページ階層の設計

3クリックルール

ユーザーはホームページから3クリック以内に重要なページに到達できる必要があります。これは絶対的なルールではありませんが、重要なページが4レベル以上深くに埋もれている場合は、何かが間違っています。

フラット vs ディープ

アプローチ最適な用途トレードオフ
フラット(2レベル)小規模サイト、ポートフォリオシンプルだがスケールしない
中程度(3レベル)ほとんどのSaaS、コンテンツサイト深さと見つけやすさのバランスが良い
ディープ(4レベル以上)EC、大規模ドキュメントスケールするが、コンテンツが埋もれるリスクがある

経験則: ナビゲーションをクリーンに保ちながら、できるだけフラットにします。ナビゲーションドロップダウンに20以上の項目がある場合は、階層を1レベル追加します。

階層レベル

レベル説明例
L0ホームページ/
L1主要セクション/features、/blog、/pricing
L2セクションページ/features/analytics、/blog/seo-guide
L3以上詳細ページ/docs/api/authentication

ASCIIツリー形式

ページ階層には以下の形式を使用します:

Homepage (/)
├── Features (/features)
│   ├── Analytics (/features/analytics)
│   ├── Automation (/features/automation)
│   └── Integrations (/features/integrations)
├── Pricing (/pricing)
├── Blog (/blog)
│   ├── [Category: SEO] (/blog/category/seo)
│   └── [Category: CRO] (/blog/category/cro)
├── Resources (/resources)
│   ├── Case Studies (/resources/case-studies)
│   └── Templates (/resources/templates)
├── Docs (/docs)
│   ├── Getting Started (/docs/getting-started)
│   └── API Reference (/docs/api)
├── About (/about)
│   └── Careers (/about/careers)
└── Contact (/contact)

ASCIIとMermaidの使い分け:

  • ASCII: 迅速な階層ドラフト、テキストのみのコンテキスト、シンプルな構造
  • Mermaid: ビジュアルプレゼンテーション、複雑な関係性、ナビゲーションゾーンやリンクパターンの表示

ナビゲーションデザイン

ナビゲーションタイプ

ナビゲーションタイプ目的配置
ヘッダーナビ主要ナビゲーション、常に表示すべてのページの上部
ドロップダウンメニュー親の下にサブページを整理ヘッダー項目から展開
フッターナビセカンダリリンク、法的情報、サイトマップすべてのページの下部
サイドバーナビセクションナビゲーション(ドキュメント、ブログ)セクション内の左側
パンくずリスト階層内の現在位置を表示ヘッダーの下、コンテンツの上
コンテキストリンク関連コンテンツ、次のステップページコンテンツ内

ヘッダーナビゲーションのルール

  • 4〜7項目以内 をプライマリナビに(それ以上は選択疲れを引き起こす)
  • CTAボタン は右端に配置(例:「無料トライアルを始める」「始める」)
  • ロゴ はホームページにリンク(左側)
  • 優先順に並べる: 最も重要/訪問が多いページを最初に
  • メガメニューを使用する場合は、3〜4列に制限する

フッターの整理

フッターリンクを列にグループ化:

  • プロダクト: 機能、料金、インテグレーション、変更履歴
  • リソース: ブログ、ケーススタディ、テンプレート、ドキュメント
  • 会社: 会社概要、採用情報、お問い合わせ、プレス
  • 法的情報: プライバシー、利用規約、セキュリティ

パンくずリストの形式

Home > Features > Analytics
Home > Blog > SEO Category > Post Title

パンくずリストはURL階層を反映する必要があります。現在のページを除き、すべてのパンくずセグメントはクリック可能なリンクである必要があります。

詳細なナビゲーションパターンについては: references/navigation-patterns.md を参照


URL構造

設計原則

  1. 人間が読める — /features/analytics は /f/a123 ではない
  2. ハイフンを使用し、アンダースコアは使わない — /blog/seo-guide は /blog/seo_guide ではない
  3. 階層を反映する — URLパスはサイト構造に一致させる
  4. 一貫した末尾スラッシュポリシー — いずれかを選択し(あり/なし)、それを適用する
  5. 常に小文字 — /About は /about にリダイレクトする必要がある
  6. 短くても説明的に — /blog/how-to-improve-landing-page-conversion-rates は長すぎる。/blog/landing-page-conversions の方が良い

ページタイプ別URLパターン

ページタイプパターン例
ホームページ/example.com
機能ページ/features/{name}/features/analytics
料金/pricing/pricing
ブログ記事/blog/{slug}/blog/seo-guide
ブログカテゴリ/blog/category/{slug}/blog/category/seo
ケーススタディ/customers/{slug}/customers/acme-corp
ドキュメント/docs/{section}/{page}/docs/api/authentication
法的情報/{page}/privacy、/terms
ランディングページ/{slug} または /lp/{slug}/free-trial、/lp/webinar
比較/compare/{competitor} または /vs/{competitor}/compare/competitor-name
インテグレーション/integrations/{name}/integrations/slack
テンプレート/templates/{slug}/templates/marketing-plan

よくある間違い

  • ブログURLに日付を含める — /blog/2024/01/15/post-title は価値を追加せず、URLを長くするだけ。/blog/post-title を使用する。
  • 過度なネスト — /products/category/subcategory/item/detail は深すぎる。可能な限りフラットにする。
  • リダイレクトなしでURLを変更する — すべての古いURLには新しいURLへの301リダイレクトが必要。リダイレクトがないと、バックリンクの評価を失い、古いURLをブックマークやリンクしているユーザーに壊れたページを提供することになる。
  • URLにIDを含める — /product/12345 は人間が読めない。スラッグを使用する。
  • コンテンツにクエリパラメータを使用する — /blog?id=123 は /blog/post-title であるべき。
  • 一貫性のないパターン — /features/analytics と /product/automation を混在させない。1つの親を選択する。

パンくずとURLの一致

パンくずリストはURLパスを反映する必要があります:

URLパンくずリスト
/features/analyticsHome > Features > Analytics
/blog/seo-guideHome > Blog > SEO Guide
/docs/api/authHome > Docs > API > Authentication

ビジュアルサイトマップ出力(Mermaid)

ビジュアルサイトマップにはMermaidの graph TD を使用します。これにより階層関係が明確になり、ナビゲーションゾーンに注釈を付けることができます。

基本階層

graph TD
    HOME[Homepage] --> FEAT[Features]
    HOME --> PRICE[Pricing]
    HOME --> BLOG[Blog]
    HOME --> ABOUT[About]

    FEAT --> F1[Analytics]
    FEAT --> F2[Automation]
    FEAT --> F3[Integrations]

    BLOG --> B1[Post 1]
    BLOG --> B2[Post 2]

ナビゲーションゾーン付き

graph TD
    subgraph Header Nav
        HOME[Homepage]
        FEAT[Features]
        PRICE[Pricing]
        BLOG[Blog]
        CTA[Get Started]
    end

    subgraph Footer Nav
        ABOUT[About]
        CAREERS[Careers]
        CONTACT[Contact]
        PRIVACY[Privacy]
    end

    HOME --> FEAT
    HOME --> PRICE
    HOME --> BLOG
    HOME --> ABOUT

    FEAT --> F1[Analytics]
    FEAT --> F2[Automation]

その他のMermaidテンプレートについては: references/mermaid-templates.md を参照


内部リンク戦略

リンクタイプ

タイプ目的例
ナビゲーショナルセクション間の移動ヘッダー、フッター、サイドバーのリンク
コンテキストテキスト内の関連コンテンツ「アナリティクスの詳細」
ハブアンドスポーククラスターコンテンツをハブに接続ブログ記事がピラーページにリンク
クロスセクションセクション間の関連ページを接続機能ページが関連ケーススタディにリンク

内部リンクのルール

  1. 孤立ページを作らない — すべてのページには少なくとも1つの内部リンクが張られている必要がある
  2. 説明的なアンカーテキスト — 「ここをクリック」ではなく「弊社のアナリティクス機能」
  3. コンテンツ1000語あたり5〜10の内部リンク(目安)
  4. 重要なページへのリンクを増やす — ホームページ、主要機能ページ、料金ページ
  5. パンくずリストを使用する — すべてのページで無料の内部リンク
  6. 関連コンテンツセクション — ページ下部に「関連記事」や「こちらもおすすめ」

ハブアンドスポークモデル

コンテンツ重視のサイトでは、ハブページを中心に整理:

Hub: /blog/seo-guide(包括的な概要)
├── Spoke: /blog/keyword-research(ハブにリンク)
├── Spoke: /blog/on-page-seo(ハブにリンク)
├── Spoke: /blog/technical-seo(ハブにリンク)
└── Spoke: /blog/link-building(ハブにリンク)

各スポークはハブにリンクを返します。ハブはすべてのスポークにリンクします。スポークは関連する場合に相互にリンクします。

リンク監査チェックリスト

  • すべてのページに少なくとも1つのインバウンド内部リンクがある
  • 壊れた内部リンクがない(404)
  • アンカーテキストが説明的である(「ここをクリック」「続きを読む」ではない)
  • 重要なページに最も多くのインバウンド内部リンクがある
  • すべてのページにパンくずリストが実装されている
  • ブログ記事に関連コンテンツリンクが存在する
  • クロスセクションリンクが機能をケーススタディに、ブログをプロダクトページに接続している

出力形式

サイトアーキテクチャ計画を作成する際は、以下の成果物を提供します:

1. ページ階層(ASCIIツリー)

各ノードにURLを持つ完全なサイト構造。ページ階層設計セクションのASCIIツリー形式を使用します。

2. ビジュアルサイトマップ(Mermaid)

ページ間の関係とナビゲーションゾーンを示すMermaid図。必要に応じてナビゲーションゾーンのサブグラフを持つ graph TD を使用します。

3. URLマップテーブル

ページURL親ナビゲーション位置優先度
ホームページ/—ヘッダー高
機能/featuresホームページヘッダー高
アナリティクス/features/analytics機能ヘッダードロップダウン中
料金/pricingホームページヘッダー高
ブログ/blogホームページヘッダー中

4. ナビゲーション仕様

  • ヘッダーナビ項目(順序付き、CTA付き)
  • フッターセクションとリンク
  • サイドバーナビ(該当する場合)
  • パンくずリスト実装に関する注意事項

5. 内部リンク計画

  • ハブページとそのスポーク
  • クロスセクションリンクの機会
  • 孤立ページ監査(再構築の場合)
  • 主要ページごとの推奨リンク

タスク固有の質問

  1. これは新しいサイトですか、それとも既存のサイトを再構築しますか?
  2. サイトのタイプは何ですか?(SaaS、コンテンツ、EC、ドキュメント、ハイブリッド、中小企業)
  3. 存在する、または計画されているページ数は?
  4. サイトで最も重要な5つのページは?
  5. 保存またはリダイレクトする必要がある既存のURLはありますか?
  6. 主なオーディエンスは誰で、サイトで何を達成しようとしていますか?

関連スキル

  • content-strategy: 作成するコンテンツとトピッククラスターの計画用
  • programmatic-seo: テンプレートとデータを使用してSEOページを大規模に構築する用
  • seo-audit: 技術的SEO、オンページ最適化、インデックス問題用
  • page-cro: 個々のページのコンバージョン最適化用
  • schema-markup: パンくずリストとサイトナビゲーションの構造化データ実装用
  • competitor-alternatives: 比較ページのフレームワークとURLパターン用

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

関連スキル