site-architecture

Überblick über den site-architecture-Skill

Was der site-architecture-Skill leistet

Der site-architecture-Skill hilft dir dabei, die Seitenhierarchie, Navigation, URL-Struktur und interne Verlinkung einer Website zu planen oder neu zu ordnen. Er ist für Arbeiten an der Informationsarchitektur gedacht, nicht für die technische Erstellung von XML-Sitemaps. Wenn deine eigentliche Frage lautet: „Welche Seiten sollte diese Website haben, wie sollten sie miteinander verbunden sein und wie sollten Nutzer sich durch die Seite bewegen?“, dann ist das der richtige Skill.

Für wen sich site-architecture eignet

Dieser site-architecture-Skill passt am besten für:

• Marketing-Teams, die eine neue Website oder einen größeren Relaunch planen
• Gründer, die eine SaaS-Marketing-Website definieren
• UI/UX-Teams, die an Navigation und IA arbeiten
• SEO-affine Content-Teams, die Hubs, Bereiche und Seitenbeziehungen festlegen
• Agenturen, die schnell einen ersten Sitemap-Entwurf, eine URL-Struktur und eine Navigationsspezifikation brauchen

Besonders nützlich ist er, wenn eine Website organisch gewachsen ist und sich inzwischen schwer durchsuchen lässt, inkonsistent wirkt oder zu tief verschachtelt ist.

Typische Aufgaben, für die der Skill besonders gut passt

Nutze site-architecture, wenn du:

• eine grobe Seitenliste in eine logische Sitemap überführen musst
• zwischen einer flachen und einer tiefen Struktur entscheiden willst
• Header-, Footer- und Bereichsnavigation definieren möchtest
• URL-Muster für Bereiche wie /features, /compare oder /integrations erstellen willst
• die interne Verlinkung zwischen Hub-Seiten und Detailseiten verbessern möchtest
• eine visuelle Sitemap in ASCII oder Mermaid zur Abstimmung erstellen willst

Was diesen Skill von einem generischen Prompt unterscheidet

Ein generischer Prompt listet oft nur Seiten auf. Der site-architecture-Skill ist stärker, weil er auf ein vollständigeres Ergebnis hinarbeitet:

• zuerst Geschäfts- und Zielgruppenkontext
• explizites Hierarchiedesign
• Navigationsempfehlungen
• URL-Strukturmuster
• Hinweise zur internen Verlinkung
• visuelle Sitemap-Ausgaben
• wiederverwendbare Templates für gängige Website-Typen

Das Repository enthält außerdem praktische Referenzen für Mermaid-Diagramme, Navigationsmuster und Templates für verschiedene Site-Typen. Dadurch sind die Ergebnisse konsistenter, als wenn du bei null anfängst.

Wichtige Grenzen des Einsatzbereichs

Dieser Skill deckt nicht primär Folgendes ab:

• XML-Sitemap-Dateien
• vollständige SEO-Audits
• Schema-Markup
• finale Wireframes oder ausgereifte UI-Mockups

Für site-architecture for UI/UX Design ist er vor allem auf der Strukturebene nützlich: Seiten gruppieren, Orientierung schaffen, Navigationszonen definieren und Inhalte auffindbar machen, bevor das detaillierte Interface-Design beginnt.

So nutzt du den site-architecture-Skill

Installationskontext und Zugriffsweg

Installiere den Skill aus dem Repository mit:

npx skills add https://github.com/coreyhaines31/marketingskills --skill site-architecture

In der Praxis lösen Nutzer site-architecture aus, indem sie um Hilfe bei Sitemaps, Navigation, Seitenhierarchien oder URL-Planung bitten. Am besten funktioniert der Skill in einer Skills-kompatiblen Agent-Umgebung, in der das Modell die Skill-Dateien lesen und dem vorgesehenen Workflow folgen kann.

Diese Dateien solltest du vor der Nutzung von site-architecture zuerst lesen

Wenn du den Skill schnell einschätzen willst, beginne hier:

1. skills/site-architecture/SKILL.md
2. skills/site-architecture/references/site-type-templates.md
3. skills/site-architecture/references/navigation-patterns.md
4. skills/site-architecture/references/mermaid-templates.md
5. skills/site-architecture/evals/evals.json

Diese Reihenfolge zeigt dir den Workflow, typische Outputs, konkrete Navigationsoptionen, Diagrammformate und woran in den Evaluierungen ein „gutes“ Ergebnis erkannt wird.

Die wichtigsten Inputs, die der Skill braucht

Der site-architecture-Skill wird deutlich besser, wenn du Folgendes mitlieferst:

• was das Unternehmen macht
• die primären Zielgruppen
• die wichtigsten Website-Ziele, meist maximal 2–3
• ob es sich um eine neue Website oder um eine Umstrukturierung handelt
• vorhandenes Seiteninventar, falls vorhanden
• Problemstellen wie Duplikate, tiefe Verschachtelung oder schlechte Auffindbarkeit
• den Site-Typ, z. B. SaaS, Ecommerce, Services, Marketplace oder eine inhaltslastige Website

Wenn du das weglässt, kann das Modell zwar trotzdem eine Struktur entwerfen, aber sie wird generisch ausfallen und möglicherweise das falsche Navigationsmuster wählen.

Prüfe zuerst den Product-Marketing-Kontext

Ein nützliches, repo-spezifisches Verhalten: Der Skill weist den Agenten ausdrücklich an, vor Rückfragen in .agents/product-marketing-context.md oder in der älteren .claude/product-marketing-context.md nachzusehen. Das ist wichtig, weil viele Architekturentscheidungen von Positionierung, Zielgruppen und Angebotsstruktur abhängen.

Wenn dein Product-Marketing-Kontext bereits dokumentiert ist, weise das Modell darauf hin. Das reduziert unnötige Rückfragen und verbessert Entscheidungen zur Seitenstruktur und Gruppierung.

Aus einem groben Ziel einen starken site-architecture-Prompt machen

Schwacher Prompt:

Help me make a sitemap.

Stärkerer Prompt:

Use the site-architecture skill to plan a SaaS marketing site for an analytics product aimed at ecommerce teams. Our goals are demo requests, SEO traffic, and partner integrations. We need a homepage, pricing, feature pages, docs, blog, integrations, and competitor comparison pages. Keep top nav to 5-6 primary items. Propose page hierarchy, URL structure, header/footer nav, and internal linking model.

Warum das besser funktioniert:

• Zielgruppe und Geschäftstyp sind klar definiert
• Conversion- und Content-Ziele werden benannt
• erforderliche Content-Typen sind aufgelistet
• eine Navigationsvorgabe ist enthalten
• es werden konkrete Deliverables angefordert, für die der Skill ausgelegt ist

Woran gute Nutzung von site-architecture erkennbar ist

Bitte um Output in dieser Reihenfolge:

1. Annahmen und fehlende Inputs
2. vorgeschlagene Hierarchie
3. URL-Map
4. Navigationsspezifikation
5. Empfehlungen zur internen Verlinkung
6. ASCII-Baum oder Mermaid-Diagramm
7. Trade-offs oder offene Fragen

Das entspricht den praktischen Stärken des Skills. So kannst du zuerst die Struktur prüfen, bevor ihr über Labels oder Design-Details diskutiert.

Nutze die Referenz-Templates statt mit einem leeren Blatt zu starten

Die größte Abkürzung bei der Einführung ist das Referenz-Set:

• site-type-templates.md liefert fertige Hierarchiemuster
• navigation-patterns.md hilft bei der Wahl zwischen einfachem Header, Mega Menu und anderen Navigationsmodellen
• mermaid-templates.md beschleunigt die Erstellung visueller Sitemaps

Für viele Teams ist der beste Workflow: das passendste Site-Template wählen, die Bereiche anpassen und danach Navigation und URLs verfeinern. Das ist schneller und in der Regel besser als ein freier Prompt ohne Vorlage.

Empfohlener Workflow für eine neue Website

Für einen Neubau:

1. Geschäftsziele und Zielgruppen definieren
2. das passendste Site-Type-Template auswählen
3. primäre Bereiche anpassen
4. URL-Konventionen festlegen
5. die Header-Navigation auf Prioritäten begrenzen
6. unterstützende Seiten dem Footer oder einer Bereichsnavigation zuordnen
7. wo sinnvoll ein Hub-and-Spoke-Modell für interne Links ergänzen
8. einen ASCII-Baum oder ein Mermaid-Diagramm für das Stakeholder-Review exportieren

Das funktioniert besonders gut für SaaS-Websites, bei denen Bereiche wie /features, /customers, /resources, /integrations und /compare häufig klar voneinander getrennt werden müssen.

Empfohlener Workflow für eine Umstrukturierung

Für eine unübersichtliche bestehende Website gib dem Modell:

• die aktuelle Navigation
• Seitenanzahl oder ein Seiteninventar
• doppelte Bereiche
• Seiten mit schwachem Traffic oder unklarer Zuständigkeit
• Nutzerbeschwerden wie „can’t find docs“ oder „too many dropdowns“

Bitte es dann darum:

• Bereiche zusammenzuführen
• doppelte Einstiegspunkte zu entfernen
• unnötige Tiefe zu reduzieren
• primäre Navigation von Utility-/Footer-Elementen zu trennen
• wertvolle bestehende URLs nach Möglichkeit zu erhalten

Gerade hier ist der site-architecture-Skill hilfreicher als ein generischer Brainstorming-Prompt, weil er die Aufgabe als Reorganisation rahmt und nicht bloß als Seitenliste.

site-architecture für UI/UX-Design-Teams

Für UI/UX Design solltest du den Skill vor den Wireframes einsetzen, wenn du klären musst:

• was in die globale Navigation gehört
• wo Landingpages für Bereiche nötig sind
• wie Breadcrumbs die Hierarchie abbilden sollten
• welche Seiten direkten statt indirekten Zugriff verdienen
• wann ein Mega Menu gerechtfertigt ist

Er ersetzt kein Interaction Design, gibt UI/UX-Teams aber eine belastbarere IA-Basis, bevor Komponenten gestaltet werden.

Praktische Ausgabeformate, die du anfordern solltest

Der Skill ist am stärksten, wenn du eines oder mehrere dieser Formate anforderst:

• ASCII-Baum für schnelles Review
• Mermaid-Sitemap für Dokumentation
• URL-Map-Tabelle mit Prioritäten
• Header-/Footer-Navigationsspezifikation
• Modell der internen Verlinkung nach Bereichen

All diese Formate sind durch das Repository belegbar unterstützt. Du richtest deine Anfrage also an dem aus, was der Skill bereits besonders gut kann.

FAQ zum site-architecture-Skill

Ist site-architecture auch für Einsteiger geeignet?

Ja, sofern du die Ziele der Website und die wichtigsten Content-Typen bereits kennst. Der Skill bringt schneller Struktur hinein, als wenn du IA komplett neu erfindest. Einsteiger scheitern meist daran, dass sie zu wenig Kontext liefern, nicht daran, dass der Skill zu anspruchsvoll wäre.

Wann sollte ich site-architecture statt eines normalen Prompts verwenden?

Nutze den site-architecture-Skill, wenn das Ergebnis operativ nutzbar sein muss: Hierarchie, Navigation, URL-Regeln und Verlinkungsstrategie. Ein normaler Prompt kann Seiten brainstormen, aber dieser Skill ist besser, wenn du ein überprüfbares Architektur-Artefakt brauchst.

Erstellt site-architecture XML-Sitemaps?

Nein. Dieser Skill ist für Informationsarchitektur und Navigationsplanung gedacht. Für die Erstellung von XML-Sitemaps oder technische Crawl-Diagnosen ist er nicht das richtige Werkzeug.

Ist site-architecture auch für bestehende Websites nützlich und nicht nur für neue?

Ja. Der Skill eignet sich sehr gut für Umstrukturierungen, besonders wenn eine Website zu viele Seiten, inkonsistente Gruppierungen oder verwirrende Navigation hat. Gib ihm den aktuellen Zustand und die Pain Points, nicht nur den gewünschten Zielzustand.

Wie schneidet er im Vergleich zu manueller IA-Arbeit ab?

Manuelle IA-Arbeit bleibt wertvoll, aber dieser Skill beschleunigt den ersten Strukturentwurf und liefert wiederverwendbare Templates. Besonders hilfreich ist er, um Optionen zu skizzieren, Trade-offs sichtbar zu machen und Artefakte für Team-Reviews zu erzeugen. Für politische Fragen, Zuständigkeiten und Umsetzungsgrenzen braucht es weiterhin menschliches Urteilsvermögen.

Ist das eine gute Wahl für site-architecture for UI/UX Design?

Ja, als vorgelagertes Planungstool. Es hilft UI/UX-Design-Teams dabei, Seitenbeziehungen, Navigationstiefe und Wayfinding-Logik zu definieren, bevor detaillierte Layouts entstehen. Für Entscheidungen auf Komponentenebene ist es weniger geeignet.

Wann ist site-architecture der falsche Skill?

Verzichte darauf, wenn du eigentlich Folgendes brauchst:

• technisches SEO-Auditing
• Schema-Planung
• Content-Erstellung
• Wireframing von hochauflösenden Seitenlayouts
• App-Informationsarchitektur, die weit über typische Marketing-Website-Muster hinausgeht

Auch wenn du keinen grundlegenden Geschäftskontext liefern kannst, ist der Skill nur eingeschränkt geeignet.

So verbesserst du den site-architecture-Skill

Formuliere geschäftliche Rahmenbedingungen präziser

Der schnellste Weg zu besserem site-architecture-Output ist, Einschränkungen explizit zu benennen:

• primäre Conversion-Aktion
• wichtigste Zielgruppensegmente
• maximale Anzahl an Header-Navigationseinträgen
• unverzichtbare Bereiche
• Bereiche, die nicht in die Hauptnavigation sollen
• ob SEO-Landingpages Priorität haben

Ohne solche Vorgaben neigt das Modell dazu, zu viele Seiten aufzunehmen und die Navigation zu wenig zu priorisieren.

Liefere für Umstrukturierungen ein Seiteninventar mit

Bei bestehenden Websites solltest du ein grobes Seiteninventar oder die aktuelle Navigation einfügen. Selbst eine unordentliche Liste reicht aus. So kann der site-architecture-Skill Konsolidierungspotenziale, doppelte Strukturen und verwaiste Bereiche erkennen, die sonst leicht übersehen werden.

Frage nach Trade-offs, nicht nur nach einer einzigen Lösung

Ein starkes Verbesserungsmuster ist:

Give me a recommended architecture plus one simpler option and one SEO-expansion option.

Dadurch werden echte Entscheidungen sichtbar, zum Beispiel:

• einfache Navigation vs. skalierbare Navigation
• weniger Top-Level-Bereiche vs. eigene Landingpage-Hubs
• flachere Hierarchie vs. klarere Kategorisierung

Das macht den Skill für die Abstimmung mit Stakeholdern deutlich wertvoller.

Erzwinge klarere Outputs mit konkreten Deliverables

Wenn der erste Output zu vage wirkt, fordere Folgendes an:

• einen vollständigen ASCII-Baum
• exakte URL-Muster
• Nav-Labels mit Anzahl der Einträge
• Breadcrumb-Beispiele
• interne Verlinkung auf Bereichsebene

Spezifische Formate reduzieren unverbindliche Empfehlungen und machen den site-architecture-Guide direkt umsetzbarer.

Typische Fehlermuster, auf die du achten solltest

Achte in ersten Entwürfen auf diese Probleme:

• zu viele Top-Level-Navigationseinträge
• Kategorienamen, die sich überschneiden
• vermischte Content-Hubs und Conversion-Seiten ohne klare Priorität
• tiefe Verschachtelung mit geringem Nutzen für Nutzer
• inkonsistente Gruppierung von Blog, Resources und Docs
• SEO-Landingpages ohne Verlinkungsplan

Das sind typische IA-Probleme, die der Skill einführen kann, wenn dein Prompt zu breit oder zu unklar ist.

Empfehlungen zur internen Verlinkung verbessern

„Interne Links hinzufügen“ reicht nicht. Bitte das Modell konkret anzugeben:

• welche Hub-Seiten auf welche Detailseiten verlinken
• welche Detailseiten zurück auf die Hubs verlinken
• wo Querverlinkungen sinnvoll sind, etwa von Features zu Integrations oder von Comparisons zu Pricing
• welche Seiten nicht stark querverlinkt werden sollten

So wird die Nutzung von site-architecture vom Konzept zur umsetzbaren Arbeitsgrundlage.

Nutze die Repo-Referenzen, um schwache Entwürfe zu schärfen

Wenn der Output generisch wirkt, weise das Modell an, Folgendes gezielt anzuwenden:

• references/navigation-patterns.md für Navigationsentscheidungen
• references/site-type-templates.md für die Abdeckung der Bereiche
• references/mermaid-templates.md für klarere Diagramme

Das ist eine der einfachsten Möglichkeiten, den site-architecture-Skill zu verbessern, ohne den Skill selbst zu verändern.

Iteriere nach dem ersten Architektur-Durchgang

Bewährt hat sich ein zweiter Prompt wie:

Revise this site architecture to reduce header nav to 5 items, move low-priority pages to footer, preserve our existing /blog structure, and create a clearer hub model for integrations and comparison pages.

Solche gezielten Überarbeitungen sind meist der Punkt, an dem der Skill wirklich produktionsreif nützlich wird.

Prüfe die Struktur anhand realer User Journeys

Bevor du das Ergebnis übernimmst, teste, ob zentrale Wege leicht funktionieren:

• Erstbesucher zum Produktverständnis
• Vergleichsinteressierte bis zur Entscheidungsseite
• SEO-Besucher vom Artikel zur Produktintention
• Bestandskunden zu Docs oder Support
• potenzielle Partner zu Integrations-Details

Wenn diese Wege holprig wirken, braucht die site-architecture eine weitere Iteration, auch wenn die Sitemap auf den ersten Blick sauber aussieht.

Verbessere site-architecture, indem du die Zielgruppe enger fasst

Breite Zielgruppen führen zu verwässerter Architektur. Wenn der erste Output allen gleichzeitig gerecht werden will, trenne die Prioritäten:

• Käufer vs. Nutzer
• SMB vs. Enterprise
• Prospect vs. Customer
• Educational Content vs. Conversion Content

Der site-architecture-Skill wird deutlich besser, wenn die Zielgruppenpriorität klar ist, weil sich Navigation und Seitengruppierung dann leichter begründen lassen.