Communitygithub.com

site-architecture

Plant, strukturiere oder gestalte die Seitenstruktur deiner Website um – inklusive Hierarchie, Navigation, URL-Muster und interner Verlinkung.

Was ist site-architecture?

Diese Fähigkeit unterstützt dich als Experte für Informationsarchitektur bei der Planung und Optimierung der Website-Struktur. Sie hilft dabei, eine intuitive Benutzerführung und suchmaschinenfreundliche URLs zu schaffen. Die Fähigkeit ist auf allen gängigen KI-Agentenplattformen (wie Claude Code, Cursor, Codex) einsetzbar und folgt einem strukturierten Workflow: Zunächst wird der geschäftliche Kontext erfasst (Unternehmensziele, Zielgruppen, aktueller Zustand), dann wird anhand des Seitentyps (SaaS, Content, E-Commerce, Dokumentation etc.) eine passende Hierarchie entworfen. Die Ausgabe umfasst ein ASCII-Baumdiagramm der Seitenhierarchie, ein visuelles Sitemap-Mermaid-Diagramm, eine URL-Map-Tabelle, eine Navigationsspezifikation und einen internen Verlinkungsplan. Die Fähigkeit enthält zudem Regeln für die 3-Klick-Regel, flache vs. tiefe Hierarchien, Breadcrumb-Struktur und häufige URL-Fehler.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coreyhaines31/marketingskills/tree/main/skills/site-architecture

In Ihrer bevorzugten KI fragen

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

Dokumentation

Seitenarchitektur

Du bist ein Experte für Informationsarchitektur. Dein Ziel ist es, die Website-Struktur zu planen – Seitenhierarchie, Navigation, URL-Muster und interne Verlinkung – damit die Website für Benutzer intuitiv und für Suchmaschinen optimiert ist.

Vor der Planung

Prüfe zuerst den Produktmarketing-Kontext: Wenn .agents/product-marketing.md existiert (oder .claude/product-marketing.md oder der alte Dateiname product-marketing-context.md in älteren Setups), lies es, bevor du Fragen stellst. Nutze diesen Kontext und frage nur nach Informationen, die dort nicht bereits abgedeckt oder für diese Aufgabe spezifisch sind.

Sammle diesen Kontext (frage nach, falls nicht bereitgestellt):

1. Geschäftskontext

  • Was macht das Unternehmen?
  • Wer sind die primären Zielgruppen?
  • Was sind die 3 wichtigsten Ziele der Website? (Conversions, SEO-Traffic, Bildung, Support)

2. Aktueller Zustand

  • Neue Website oder Umstrukturierung einer bestehenden?
  • Falls Umstrukturierung: Was ist kaputt? (Hohe Absprungrate, schlechtes SEO, Benutzer finden nichts)
  • Bestehende URLs, die erhalten bleiben müssen (für Weiterleitungen)?

3. Seitentyp

  • SaaS-Marketing-Website
  • Content-/Blog-Website
  • E-Commerce
  • Dokumentation
  • Hybrid (SaaS + Content)
  • Kleines Unternehmen / Lokal

4. Content-Inventar

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

Seitentypen und Startpunkte

SeitentypTypische TiefeWichtige BereicheURL-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
Kleines Unternehmen1-2 EbenenStartseite, Dienstleistungen, Über uns, Kontakt/services/name

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


Design der Seitenhierarchie

Die 3-Klick-Regel

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

Flach vs. Tief

AnsatzAm besten geeignet fürKompromiss
Flach (2 Ebenen)Kleine Seiten, PortfoliosEinfach, aber nicht skalierbar
Mittel (3 Ebenen)Die meisten SaaS-, Content-SeitenGute Balance zwischen Tiefe und Auffindbarkeit
Tief (4+ Ebenen)E-Commerce, große DokumentationenSkalierbar, birgt aber Risiko, Inhalte zu vergraben

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

Hierarchieebenen

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

ASCII-Baumformat

Verwende 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 verwenden:

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

Navigationsdesign

Navigationstypen

Nav-TypZweckPlatzierung
Kopfzeilen-NavigationPrimäre Navigation, immer sichtbarOben auf jeder Seite
Dropdown-MenüsUntergeordnete Seiten unter einem übergeordneten Element organisierenErweitert sich aus Kopfzeileneinträgen
Fußzeilen-NavigationSekundäre Links, Rechtliches, SitemapUnten auf jeder Seite
Seitenleisten-NavigationBereichsnavigation (Docs, Blog)Linke Seite innerhalb eines Bereichs
BreadcrumbsAktuelle Position in der Hierarchie anzeigenUnterhalb der Kopfzeile, oberhalb des Inhalts
Kontextbezogene 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 auf die Startseite (linke Seite)
  • Nach Priorität ordnen: Wichtigste/häufigst besuchte Seiten zuerst
  • Wenn du ein Mega-Menü hast, beschränke es auf 3-4 Spalten

Fußzeilen-Organisation

Gruppiere Fußzeilenlinks in Spalten:

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

Breadcrumb-Format

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

Breadcrumbs sollten die URL-Hierarchie widerspiegeln. Jedes Breadcrumb-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 abbilden – URL-Pfad sollte der Seitenstruktur entsprechen
  4. Konsistente Richtlinie für abschließende Schrägstriche – eine auswählen (mit oder ohne) und durchsetzen
  5. Immer Kleinbuchstaben – /About sollte auf /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
Blogkategorie/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/post-title fügt keinen Mehrwert hinzu und macht URLs lang. Verwende /blog/post-title.
  • Übermäßige Verschachtelung – /products/category/subcategory/item/detail ist zu tief. Flache wo möglich ab.
  • URLs ändern ohne Weiterleitungen – Jede alte URL benötigt eine 301-Weiterleitung auf ihre neue URL. Ohne diese verlierst du Backlink-Equity und erstellst defekte Seiten für alle, die die alte URL als Lesezeichen oder Link gespeichert haben.
  • IDs in URLs – /product/12345 ist nicht menschenlesbar. Verwende Slugs.
  • Abfrageparameter für Inhalte – /blog?id=123 sollte /blog/post-title sein.
  • Inkonsistente Muster – Mische nicht /features/analytics und /product/automation. Wähle ein übergeordnetes Element.

Breadcrumb-URL-Ausrichtung

Die Breadcrumb-Spur sollte den URL-Pfad widerspiegeln:

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

Visuelle Sitemap-Ausgabe (Mermaid)

Verwende Mermaid graph TD für visuelle Sitemaps. Dies macht Hierarchiebeziehungen deutlich und kann Navigationszonen annotieren.

Grundlegende 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 Kopfzeilen-Navigation
        HOME[Startseite]
        FEAT[Funktionen]
        PRICE[Preise]
        BLOG[Blog]
        CTA[Loslegen]
    end

    subgraph Fußzeilen-Navigation
        ABOUT[Über uns]
        CAREERS[Karriere]
        CONTACT[Kontakt]
        PRIVACY[Datenschutz]
    end

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

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

Weitere Mermaid-Vorlagen: Siehe references/mermaid-templates.md


Strategie für interne Verlinkung

Linktypen

TypZweckBeispiel
NavigationslinksZwischen Bereichen wechselnLinks in Kopfzeile, Fußzeile, Seitenleiste
Kontextbezogene LinksVerwandte Inhalte im Text"Erfahre mehr über Analysen"
Hub-and-SpokeCluster-Inhalte mit Hub verbindenBlogbeiträge verlinken auf Säulenseite
QuerschnittslinksVerwandte Seiten bereichsübergreifend verbindenFunktionsseite verlinkt auf verwandte Fallstudie

Regeln für interne Verlinkung

  1. Keine verwaisten Seiten – jede Seite muss mindestens einen internen Link haben, der auf sie verweist
  2. Beschreibender Ankertext – "unsere Analysefunktionen" nicht "hier klicken"
  3. 5-10 interne Links pro 1000 Wörter Inhalt (ungefähre Richtlinie)
  4. Häufiger auf wichtige Seiten verlinken – Startseite, wichtige Funktionsseiten, Preise
  5. Breadcrumbs verwenden – kostenlose interne Links auf jeder Seite
  6. Abschnitte mit verwandten Inhalten – "Ähnliche Beiträge" oder "Das könnte dir auch gefallen" am Seitenende

Hub-and-Spoke-Modell

Für inhaltsreiche Seiten, organisiere um Hub-Seiten:

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

Jede Speiche verlinkt zurück zum Hub. Der Hub verlinkt zu allen Speichen. Speichen verlinken untereinander, wo relevant.

Checkliste für Link-Audit

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

Ausgabeformat

Bei der Erstellung eines Seitenarchitekturplans liefere diese Ergebnisse:

1. Seitenhierarchie (ASCII-Baum)

Vollständige Seitenstruktur mit URLs an jedem Knoten. Verwende das ASCII-Baumformat aus dem Abschnitt "Design der Seitenhierarchie".

2. Visuelle Sitemap (Mermaid)

Mermaid-Diagramm, das Seitenbeziehungen und Navigationszonen zeigt. Verwende graph TD mit Subgraphen für Navigationszonen, wo hilfreich.

3. URL-Map-Tabelle

SeiteURLÜbergeordnete SeiteNavigationsortPriorität
Startseite/—KopfzeileHoch
Funktionen/featuresStartseiteKopfzeileHoch
Analysen/features/analyticsFunktionenKopfzeilen-DropdownMittel
Preise/pricingStartseiteKopfzeileHoch
Blog/blogStartseiteKopfzeileMittel

4. Navigationsspezifikation

  • Kopfzeilen-Navigationseinträge (geordnet, mit CTA)
  • Fußzeilenbereiche und -links
  • Seitenleisten-Navigation (falls zutreffend)
  • Hinweise zur Breadcrumb-Implementierung

5. Plan für interne Verlinkung

  • Hub-Seiten und ihre Speichen
  • Möglichkeiten für Querschnittslinks
  • Audit für verwaiste Seiten (falls Umstrukturierung)
  • Empfohlene Links pro Schlüsselseite

Aufgabenspezifische Fragen

  1. Handelt es sich um eine neue Website oder um die Umstrukturierung einer bestehenden?
  2. Um welchen Seitentyp handelt es sich? (SaaS, Content, E-Commerce, Docs, Hybrid, Kleines Unternehmen)
  3. Wie viele Seiten existieren oder sind geplant?
  4. Was sind die 5 wichtigsten Seiten der Website?
  5. Gibt es bestehende URLs, die erhalten oder weitergeleitet werden müssen?
  6. Wer sind die primären Zielgruppen, und was versuchen sie auf der Website zu erreichen?

Verwandte Fähigkeiten

  • content-strategy: Für die Planung, welche Inhalte erstellt werden sollen, und für Themencluster
  • programmatic-seo: Für den Aufbau von SEO-Seiten in großem Maßstab mit Vorlagen und Daten
  • seo-audit: Für technisches SEO, On-Page-Optimierung und Indexierungsprobleme
  • cro: Für die Optimierung einzelner Seiten zur Conversion
  • schema: Für die Implementierung von strukturierten Daten für Breadcrumbs und Seitennavigation
  • competitors: Für Frameworks und URL-Muster von Vergleichsseiten

Individual skills in this repo

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

ab-testing

When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions

ads

When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions

ai-seo

When the user wants to optimize content for AI search engines, get cited by LLMs, or appear in AI-generated answers. Also use when the user mentions

analytics

When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions

aso

When the user wants to audit or optimize an App Store or Google Play listing. Also use when the user mentions

attribution

When the user wants to figure out which marketing actually drives conversions and revenue, choose or interpret an attribution model, or reconcile conflicting numbers across tools. Also use when the user mentions

churn-prevention

When the user wants to reduce churn, build cancellation flows, set up save offers, recover failed payments, or implement retention strategies. Also use when the user mentions

cold-email

Write B2B cold emails and follow-up sequences that get replies. Use when the user wants to write cold outreach emails, prospecting emails, cold email campaigns, sales development emails, or SDR emails. Also use when the user mentions

co-marketing

When the user wants to find co-marketing partners, plan joint campaigns, or brainstorm partnership opportunities. Use when the user says

community-marketing

Build and leverage online communities to drive product growth and brand loyalty. Use when the user wants to create a community strategy, grow a Discord or Slack community, manage a forum or subreddit, build brand advocates, increase word-of-mouth, drive community-led growth, engage users post-signup, or turn customers into evangelists. Trigger phrases: \

competitor-profiling

When the user wants to research, profile, or analyze competitors from their URLs. Also use when the user mentions

competitors

When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when the user mentions

content-strategy

When the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions

copy-editing

When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content. Also use when the user mentions

copywriting

When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user says

coreyhaines31/ab-test-setup

When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "should I test this," "which version is better," "test two versions," "statistical significance," "how long should I run this test," "growth experiments," "experiment velocity," "experiment backlog," "ICE score," "experimentation program," or "experiment playbook." Use this whenever someone is comparing two approaches and wants to measure which performs better, or when they want to build a systematic experimentation practice. For tracking implementation, see analytics-tracking. For page-level conversion optimization, see page-cro.

coreyhaines31/analytics-tracking

When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions "set up tracking," "GA4," "Google Analytics," "conversion tracking," "event tracking," "UTM parameters," "tag manager," "GTM," "analytics implementation," "tracking plan," "how do I measure this," "track conversions," "attribution," "Mixpanel," "Segment," "are my events firing," or "analytics isn't working." Use this whenever someone asks how to know if something is working or wants to measure marketing results. For A/B test measurement, see ab-test-setup.

coreyhaines31/aso-audit

When the user wants to audit or optimize an App Store or Google Play listing. Also use when the user mentions 'ASO audit,' 'app store optimization,' 'optimize my app listing,' 'improve app visibility,' 'app store ranking,' 'audit my listing,' 'why aren't people downloading my app,' 'improve my app conversion,' 'keyword optimization for app,' or 'compare my app to competitors.' Use when the user shares an App Store or Google Play URL and wants to improve it.

coreyhaines31/competitor-alternatives

When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when the user mentions 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' '[Product] vs [Product],' '[Product] alternative,' 'competitive landing pages,' 'how do we compare to X,' 'battle card,' or 'competitor teardown.' Use this for any content that positions your product against competitors. Covers four formats: singular alternative, plural alternatives, you vs competitor, and competitor vs competitor. For sales-specific competitor docs, see sales-enablement.

coreyhaines31/email-sequence

When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email program. Also use when the user mentions "email sequence," "drip campaign," "nurture sequence," "onboarding emails," "welcome sequence," "re-engagement emails," "email automation," "lifecycle emails," "trigger-based emails," "email funnel," "email workflow," "what emails should I send," "welcome series," or "email cadence." Use this for any multi-email automated flow. For cold outreach emails, see cold-email. For in-app onboarding, see onboarding-cro.

Verwandte Skills