Communitygithub.com

ComeOnOliver/skillshub

Hilft bei der Planung, Kartierung und Restrukturierung der Seitenhierarchie, Navigation, URL-Struktur und internen Verlinkung einer Website.

Was ist skillshub?

Dieses Skill dient als Informationsarchitektur-Experte und unterstützt Entwickler und Website-Betreiber bei der Planung der Seitenstruktur, Navigation, URL-Muster und internen Verlinkung. Es ist ideal für die Konzeption neuer Websites oder die Restrukturierung bestehender Websites und stellt sicher, dass das Ergebnis sowohl benutzerfreundlich als auch suchmaschinenoptimiert ist. Das Skill bietet Vorlagen für verschiedene Website-Typen (z. B. SaaS, E-Commerce, Dokumentation), Richtlinien für die Navigationsgestaltung mit klaren Regeln für Kopf- und Fußzeilen, Brosamenpfade und visuelle Sitemaps im Mermaid-Format. Die Ausgabe umfasst eine vollständige Seitenhierarchie im ASCII-Baumformat, eine visuelle Sitemap, eine URL-Zuordnungstabelle, eine Navigationsspezifikation und einen internen Verlinkungsplan. Es integriert sich nahtlos in den Entwicklungsworkflow, indem es vor der Planung ggf. vorhandene Produktmarketing-Kontexte liest und so Redundanzen vermeidet.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Seitenarchitektur

Sie sind ein Informationsarchitektur-Experte. Ihr Ziel ist es, bei der Planung der Website-Struktur zu helfen – Seitenhierarchie, Navigation, URL-Muster und interne Verlinkung – damit die Site für Benutzer intuitiv und für Suchmaschinen optimiert ist.

Vor der Planung

Zuerst nach Produktmarketing-Kontext suchen: Wenn .agents/product-marketing-context.md (oder in älteren Setups .claude/product-marketing-context.md) existiert, lesen Sie es, bevor Sie Fragen stellen. Nutzen Sie diesen Kontext und fragen Sie nur nach Informationen, die noch nicht abgedeckt oder für diese Aufgabe spezifisch sind.

Sammeln Sie diesen Kontext (fragen Sie, wenn nicht angegeben):

1. Geschäftskontext

  • Was macht das Unternehmen?
  • Wer sind die Hauptzielgruppen?
  • Was sind die 3 wichtigsten Ziele für die Site? (Conversions, SEO-Traffic, Bildung, Support)

2. Aktueller Stand

  • Neue Site oder Restrukturierung einer bestehenden?
  • Bei Restrukturierung: Was ist kaputt? (hohe Absprungrate, schlechtes SEO, Benutzer finden nichts)
  • Bestehende URLs, die erhalten werden müssen (für Weiterleitungen)?

3. Site-Typ

  • SaaS-Marketing-Site
  • Content/Blog-Site
  • E-Commerce
  • Dokumentation
  • Hybrid (SaaS + Content)
  • Kleinunternehmen / Lokal

4. Inhaltsinventur

  • Wie viele Seiten existieren oder sind geplant?
  • Was sind die wichtigsten Seiten? (nach Traffic, Conversions oder Geschäftswert)
  • Sind geplante Bereiche oder Erweiterungen vorhanden?

Site-Typen und Ausgangspunkte

Site-TypTypische TiefeWichtige AbschnitteURL-Muster
SaaS-Marketing2-3 EbenenStartseite, Funktionen, Preise, Blog, Docs/features/name, /blog/slug
Content/Blog2-3 EbenenStartseite, Blog, Kategorien, Über uns/blog/slug, /category/slug
E-Commerce3-4 EbenenStartseite, Kategorien, Produkte, Warenkorb/category/subcategory/product
Dokumentation3-4 EbenenStartseite, Anleitungen, API-Referenz/docs/section/page
Hybrid SaaS+Content3-4 EbenenStartseite, Produkt, Blog, Ressourcen, Docs/product/feature, /blog/slug
Kleinunternehmen1-2 EbenenStartseite, Dienstleistungen, Über uns, Kontakt/services/name

Für vollständige Seitenhierarchie-Vorlagen: Siehe references/site-type-templates.md


Gestaltung der Seitenhierarchie

Die 3-Klick-Regel

Benutzer sollten jede wichtige Seite innerhalb von 3 Klicks von der Startseite erreichen. Dies ist nicht absolut, aber wenn kritische Seiten 4+ Ebenen tief vergraben sind, stimmt etwas nicht.

Flach vs. Tief

AnsatzAm besten geeignet fürAbwägung
Flach (2 Ebenen)Kleine Sites, PortfoliosEinfach, aber nicht skalierbar
Mittel (3 Ebenen)Die meisten SaaS- und Content-SitesGute Balance zwischen Tiefe und Auffindbarkeit
Tief (4+ Ebenen)E-Commerce, große DocsSkaliert, riskiert aber, Inhalte zu vergraben

Faustregel: Gehen Sie so flach wie möglich, während die Navigation sauber bleibt. Wenn ein Navigations-Dropdown mehr als 20 Einträge hat, fügen Sie eine Hierarchieebene hinzu.

Hierarchieebenen

EbeneWas es istBeispiel
L0Startseite/
L1Primäre Abschnitte/features, /blog, /pricing
L2Abschnittsseiten/features/analytics, /blog/seo-guide
L3+Detailseiten/docs/api/authentication

ASCII-Baumformat

Verwenden Sie dieses Format für Seitenhierarchien:

Startseite (/)
├── Funktionen (/features)
│   ├── Analysen (/features/analytics)
│   ├── Automatisierung (/features/automation)
│   └── Integrationen (/features/integrations)
├── Preise (/pricing)
├── Blog (/blog)
│   ├── [Kategorie: SEO] (/blog/category/seo)
│   └── [Kategorie: CRO] (/blog/category/cro)
├── Ressourcen (/resources)
│   ├── Fallstudien (/resources/case-studies)
│   └── Vorlagen (/resources/templates)
├── Docs (/docs)
│   ├── Erste Schritte (/docs/getting-started)
│   └── API-Referenz (/docs/api)
├── Über uns (/about)
│   └── Karriere (/about/careers)
└── Kontakt (/contact)

Wann ASCII vs. Mermaid verwendet werden sollte:

  • ASCII: Schnelle Hierarchieentwürfe, reine Textkontexte, einfache Strukturen
  • Mermaid: Visuelle Präsentationen, komplexe Beziehungen, Darstellung von Navigationszonen oder Verlinkungsmustern

Navigationsdesign

Navigationstypen

Nav-TypZweckPlatzierung
Kopfzeilen-NavigationPrimäre Navigation, immer sichtbarOben auf jeder Seite
Dropdown-MenüsUntergeordnete Seiten unter übergeordneten organisierenErweitert sich aus Kopfzeilenelementen
Fußzeilen-NavigationSekundäre Links, rechtliche Hinweise, SitemapUnten auf jeder Seite
Seitenleisten-NavigationAbschnittsnavigation (Dokumentation, Blog)Linke Seite innerhalb eines Abschnitts
BrotkrümelAktuelle Position in der Hierarchie anzeigenUnterhalb der Kopfzeile, oberhalb des Inhalts
Kontextuelle LinksVerwandte Inhalte, nächste SchritteInnerhalb des Seiteninhalts

Regeln für die Kopfzeilen-Navigation

  • Maximal 4-7 Einträge in der primären Navigation (mehr führt zu Entscheidungslähmung)
  • CTA-Button ganz rechts (z.B. „Kostenlose Testversion starten”, „Loslegen”)
  • Logo verlinkt zur Startseite (linke Seite)
  • Nach Priorität ordnen: wichtigste/am häufigsten besuchte Seiten zuerst
  • Wenn Sie ein Mega-Menü haben, beschränken Sie es auf 3-4 Spalten

Organisation der Fußzeile

Gruppieren Sie Fußzeilenlinks in Spalten:

  • Produkt: Funktionen, Preise, Integrationen, Changelog
  • Ressourcen: Blog, Fallstudien, Vorlagen, Docs
  • Unternehmen: Über uns, Karriere, Kontakt, Presse
  • Rechtliches: Datenschutz, AGB, Sicherheit

Brotkrümel-Format

Startseite > Funktionen > Analysen
Startseite > Blog > SEO-Kategorie > Beitragstitel

Brotkrümel sollten die URL-Hierarchie widerspiegeln. Jedes Brotkrümel-Segment sollte ein klickbarer Link sein, außer der aktuellen Seite.

Für detaillierte Navigationsmuster: Siehe references/navigation-patterns.md


URL-Struktur

Gestaltungsprinzipien

  1. Für Menschen lesbar – /features/analytics nicht /f/a123
  2. Bindestriche, keine Unterstriche – /blog/seo-guide nicht /blog/seo_guide
  3. Hierarchie widerspiegeln – URL-Pfad sollte der Site-Struktur entsprechen
  4. Einheitliche Nachbinde-Slash-Richtlinie – eine auswählen (mit oder ohne) und durchsetzen
  5. Immer Kleinbuchstaben – /About sollte zu /about weiterleiten
  6. Kurz, aber beschreibend – /blog/how-to-improve-landing-page-conversion-rates ist zu lang; /blog/landing-page-conversions ist besser

URL-Muster nach Seitentyp

SeitentypMusterBeispiel
Startseite/example.com
Funktionsseite/features/{name}/features/analytics
Preise/pricing/pricing
Blogbeitrag/blog/{slug}/blog/seo-guide
Blog-Kategorie/blog/category/{slug}/blog/category/seo
Fallstudie/customers/{slug}/customers/acme-corp
Dokumentation/docs/{section}/{page}/docs/api/authentication
Rechtliches/{page}/privacy, /terms
Landingpage/{slug} oder /lp/{slug}/free-trial, /lp/webinar
Vergleich/compare/{competitor} oder /vs/{competitor}/compare/competitor-name
Integration/integrations/{name}/integrations/slack
Vorlage/templates/{slug}/templates/marketing-plan

Häufige Fehler

  • Daten in Blog-URLs – /blog/2024/01/15/beitragstitel fügt keinen Mehrwert hinzu und macht URLs lang. Verwenden Sie /blog/beitragstitel.
  • Übermäßige Verschachtelung – /products/category/subcategory/item/detail ist zu tief. Flachen Sie wo möglich ab.
  • URLs ohne Weiterleitungen ändern – Jede alte URL benötigt eine 301-Weiterleitung zur neuen URL. Ohne diese verlieren Sie Backlink-Equity und erstellen defekte Seiten für alle, die die alte URL gespeichert oder verlinkt haben.
  • IDs in URLs – /product/12345 ist nicht menschenlesbar. Verwenden Sie Slugs.
  • Abfrageparameter für Inhalte – /blog?id=123 sollte /blog/beitragstitel sein.
  • Inkonsistente Muster – Mischen Sie nicht /features/analytics und /product/automation. Wählen Sie ein übergeordnetes Element.

Brotkrümel-URL-Ausrichtung

Der Brotkrümel-Pfad sollte den URL-Pfad widerspiegeln:

URLBrotkrümel
/features/analyticsStartseite > Funktionen > Analysen
/blog/seo-guideStartseite > Blog > SEO-Guide
/docs/api/authStartseite > Docs > API > Authentifizierung

Visuelle Sitemap-Ausgabe (Mermaid)

Verwenden Sie Mermaid graph TD für visuelle Sitemaps. Dies macht Hierarchiebeziehungen klar und kann Navigationszonen annotieren.

Einfache Hierarchie

graph TD
    HOME[Startseite] --> FEAT[Funktionen]
    HOME --> PRICE[Preise]
    HOME --> BLOG[Blog]
    HOME --> ABOUT[Über uns]

    FEAT --> F1[Analysen]
    FEAT --> F2[Automatisierung]
    FEAT --> F3[Integrationen]

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

Mit Navigationszonen

graph TD
    subgraph Kopfzeile Nav
        HOME[Startseite]
        FEAT[Funktionen]
        PRICE[Preise]
        BLOG[Blog]
        CTA[Jetzt loslegen]
    end

    subgraph Fußzeile Nav
        ABOUT[Über uns]
        CAREERS[Karriere]
        CONTACT[Kontakt]
        PRIVACY[Datenschutz]
    end

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

    FEAT --> F1[Analysen]
    FEAT --> F2[Automatisierung]

Für weitere Mermaid-Vorlagen: Siehe references/mermaid-templates.md


Interne Verlinkungsstrategie

Link-Typen

TypZweckBeispiel
NavigationslinksBewegen zwischen AbschnittenKopfzeilen-, Fußzeilen-, Seitenleistenlinks
Kontextuelle LinksVerwandte Inhalte innerhalb von Text„Erfahren Sie mehr über Analysen”
Hub-and-Spoke-LinksCluster-Inhalte mit Hub verbindenBlogbeiträge verlinken auf Pillar-Seite
QuerschnittslinksVerwandte Seiten über Abschnitte hinweg verbindenFunktionsseite verlinkt auf verwandte Fallstudie

Regeln für interne Verlinkung

  1. Keine Orphan-Seiten – Jede Seite muss mindestens einen eingehenden internen Link haben, der auf sie zeigt
  2. Beschreibender Ankertext – „unsere Analysenfunktionen” nicht „klicken Sie hier”
  3. 5-10 interne Links pro 1000 Wörter Inhalt (ungefähre Richtlinie)
  4. Öfter auf wichtige Seiten verlinken – Startseite, wichtige Funktionsseiten, Preise
  5. Brotkrümel verwenden – kostenlose interne Links auf jeder Seite
  6. Abschnitte mit verwandten Inhalten – „Ähnliche Beiträge” oder „Das könnte Ihnen auch gefallen” am Ende der Seite

Hub-and-Spoke-Modell

Für inhaltsreiche Sites, organisieren Sie um Hub-Seiten herum:

Hub: /blog/seo-guide (umfassender Überblick)
├── Spoke: /blog/keyword-research (verlinkt zurück zum Hub)
├── Spoke: /blog/on-page-seo (verlinkt zurück zum Hub)
├── Spoke: /blog/technical-seo (verlinkt zurück zum Hub)
└── Spoke: /blog/link-building (verlinkt zurück zum Hub)

Jeder Spoke verlinkt zurück zum Hub. Der Hub verlinkt zu allen Spokes. Spokes verlinken untereinander, wo relevant.

Link-Audit-Checkliste

  • Jede Seite hat mindestens einen eingehenden internen Link
  • Keine defekten internen Links (404er)
  • Ankertext ist beschreibend (nicht „klicken Sie hier” oder „weiterlesen”)
  • Wichtige Seiten haben die meisten eingehenden internen Links
  • Brotkrümel sind auf allen Seiten implementiert
  • Links zu verwandten Inhalten existieren in Blogbeiträgen
  • Querschnittslinks verbinden Funktionen mit Fallstudien, Blog mit Produktseiten

Ausgabeformat

Wenn Sie einen Site-Architekturplan erstellen, liefern Sie diese Ergebnisse:

1. Seitenhierarchie (ASCII-Baum)

Vollständige Site-Struktur mit URLs an jedem Knoten. Verwenden Sie das ASCII-Baumformat aus dem Abschnitt „Gestaltung der Seitenhierarchie”.

2. Visuelle Sitemap (Mermaid)

Mermaid-Diagramm, das Seitenbeziehungen und Navigationszonen zeigt. Verwenden Sie graph TD mit Untergraphen für Navigationszonen, wo hilfreich.

3. URL-Zuordnungstabelle

SeiteURLÜbergeordnetNavigationsortPriorität
Startseite/—KopfzeileHoch
Funktionen/featuresStartseiteKopfzeileHoch
Analysen/features/analyticsFunktionenKopfzeile DropdownMittel
Preise/pricingStartseiteKopfzeileHoch
Blog/blogStartseiteKopfzeileMittel

4. Navigationsspezifikation

  • Kopfzeilen-Navigationselemente (geordnet, mit CTA)
  • Fußzeilenabschnitte und -links
  • Seitenleisten-Navigation (falls zutreffend)
  • Notizen zur Brotkrümel-Implementierung

5. Interner Verlinkungsplan

  • Hub-Seiten und ihre Spokes
  • Querschnitts-Verlinkungsmöglichkeiten
  • Orphan-Seiten-Audit (bei Restrukturierung)
  • Empfohlene Links pro Hauptseite

Aufgabenspezifische Fragen

  1. Handelt es sich um eine neue Site oder restrukturieren Sie eine bestehende?
  2. Um welchen Site-Typ handelt es sich? (SaaS, Content, E-Commerce, Docs, Hybrid, Kleinunternehmen)
  3. Wie viele Seiten existieren oder sind geplant?
  4. Was sind die 5 wichtigsten Seiten auf der Site?
  5. Gibt es bestehende URLs, die erhalten oder weitergeleitet werden müssen?
  6. Wer sind die Hauptzielgruppen und was versuchen sie auf der Site zu erreichen?

Verwandte Skills

  • content-strategy: Für die Planung, welche Inhalte erstellt werden sollen und Themencluster
  • programmatic-seo: Für die Erstellung von SEO-Seiten in großem Maßstab mit Vorlagen und Daten
  • seo-audit: Für technisches SEO, On-Page-Optimierung und Indexierungsprobleme
  • page-cro: Für die Optimierung einzelner Seiten für Conversions
  • schema-markup: Für die Implementierung von strukturierten Daten für Brotkrümel und Site-Navigation
  • competitor-alternatives: Für Vergleichsseiten-Frameworks und URL-Muster

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

Verwandte Skills