site-architecture
von alirezarezvanisite-architecture unterstützt AI agents dabei, Website-Struktur, URL-Hierarchie, Navigation, Crawl-Pfade, Breadcrumbs und interne Verlinkung für Technical SEO zu prüfen und zu planen. Enthalten sind Leitfäden für URL-Design und interne Verlinkung sowie ein Sitemap-Analyzer-Skript für evidenzbasierte Architektur-Empfehlungen.
Dieser Skill erreicht 84/100 Punkte und ist damit ein solider Kandidat für Directory-Nutzer, die einen Agenten zur Prüfung oder Neugestaltung von Website-Informationsarchitektur und interner Verlinkung suchen. Die Repository-Hinweise zeigen ausreichend klare Trigger, Workflow-Tiefe, Referenzmaterial und ein nutzbares Analyseskript, um deutlich mehr Mehrwert zu liefern als ein generischer SEO-Prompt. Die Paketierung könnte jedoch für Installation und Einstieg klarer sein.
- Klare Trigger-Abdeckung im Frontmatter für Site-Architektur, URL-Struktur, Navigation, Breadcrumbs, Topic Clusters, verwaiste Seiten und strukturelle SEO-Probleme, mit Ausschlüssen für Content-Strategie und Schema Markup.
- Die operative Substanz wird durch eine umfangreiche SKILL.md, Prompts zur Kontexterfassung, 11 H2-Abschnitte, 20 H3-Abschnitte und praxisnahe Referenzen zu interner Verlinkung und URL-Design gestützt.
- Enthält einen stdlib Python Sitemap-Analyzer, der sitemap.xml-Dateien auf Tiefe, URL-Muster, doppelte Pfade, potenziell verwaiste Seiten und JSON-Zusammenfassungen prüfen kann.
- Im Skill-Ordner gibt es keinen Installationsbefehl und keine README, daher müssen Directory-Nutzer die Installation möglicherweise aus den Konventionen des übergeordneten Repository ableiten.
- Die verfügbaren Hinweise zeigen eine starke SEO-Architektur-Anleitung, die Workflow-Auszüge sind jedoch teilweise gekürzt. Die Sicherheit bei den vollständigen End-to-End-Ausführungsdetails ist daher nicht absolut.
Überblick über den site-architecture skill
Wofür site-architecture entwickelt wurde
Der site-architecture skill hilft einem AI assistant dabei, die Struktur einer Website für Technical SEO, Crawlability, Navigation, URL-Hygiene und interne Verlinkung zu prüfen, neu zu entwerfen oder zu planen. Am nützlichsten ist er, wenn das Problem struktureller Natur ist: unübersichtliche URL-Ordner, schwache Hub-Seiten, verwaiste Seiten, unklare Navigation, schlechte Crawl-Pfade oder eine Website-Migration, die eine SEO-sichere Informationsarchitektur braucht.
Für welche Nutzer und Projekte er am besten passt
Dieser site-architecture skill eignet sich für SEO-Berater, Technical-SEO-Teams, Content Leads, Gründer und Entwickler, die konkrete Architektur-Empfehlungen brauchen statt allgemeiner Marketing-Ratschläge. Besonders relevant ist er für SaaS, B2B, Content-Websites, Dokumentationsseiten, E-Commerce-Kategoriestrukturen, lokale Dienstleister-Websites und Websites, die sich rund um Topic Cluster oder Hub-and-Spoke-Modelle neu organisieren.
Was ihn stärker macht als einen generischen Prompt
Ein generischer Prompt kann sagen: „Verbessere die interne Verlinkung.“ Dieser Skill gibt dem Assistant dagegen einen klaren Workflow: Ist-Zustand, Ziele und Einschränkungen erfassen; URL-Muster bewerten; Navigationstiefe abbilden; und Modelle für interne Verlinkung empfehlen. Das Repository enthält außerdem references/internal-linking-playbook.md, references/url-design-guide.md und scripts/sitemap_analyzer.py, wodurch der Skill deutlich operativer ist als eine kurze SEO-Checkliste.
Wann dieser Skill nicht die richtige Wahl ist
Verwende site-architecture nicht als Hauptwerkzeug, um zu entscheiden, welche neuen Artikel veröffentlicht werden sollen, Seitentexte zu schreiben, Schema Markup umzusetzen oder Keyword-Recherche von Grund auf zu betreiben. Er kann diese Workflows unterstützen, indem er klärt, wo Seiten liegen sollten und wie sie miteinander verbunden werden, aber sein Kernnutzen liegt in der Architektur — nicht in Content-Ideen oder strukturierten Daten.
So verwendest du den site-architecture skill
Installation von site-architecture und Repository-Pfad
Installiere den Skill aus dem GitHub Skill Repository mit:
npx skills add alirezarezvani/claude-skills --skill site-architecture
Der Quellcode liegt unter marketing-skill/skills/site-architecture in alirezarezvani/claude-skills. Lies nach der Installation zuerst SKILL.md und prüfe danach:
references/internal-linking-playbook.mdreferences/url-design-guide.mdscripts/sitemap_analyzer.py
In diesem Skill-Ordner gibt es keine separate README- oder Metadata-Datei. Die wichtigsten Arbeitsanweisungen stehen daher in SKILL.md und in den beiden Reference Guides.
Eingaben, die die Nutzung von site-architecture verbessern
Für eine starke Nutzung von site-architecture solltest du dem Assistant mehr geben als „fix my SEO structure“. Der Skill funktioniert am besten mit:
- Website-URL und CMS oder Framework
sitemap.xml-URL oder exportierter Sitemap- Ungefähre Seitenanzahl nach Bereich
- Zentrales Geschäftsmodell: Lead Gen, SaaS, E-Commerce, Media, lokal, Dokumentation
- Bekannte Probleme: verwaiste Seiten, Duplicate Pages, dünne Kategorieseiten, Crawl Bloat, schwache Rankings
- Priorisierte Seiten, die ranken oder geschützt werden sollen
- Einschränkungen: keine URL-Änderungen, Migrationsdeadline, CMS-Limits, Engineering-Kapazität
Ein stärkerer Prompt sieht so aus:
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.
Empfohlener Workflow für ein Architektur-Audit
Beginne mit belastbaren Daten. Wenn du eine Sitemap hast, führe scripts/sitemap_analyzer.py aus oder bitte den Assistant, das Script zu nutzen, um URL-Tiefe, Verteilung nach Bereichen, doppelte Pfadmuster und mögliche verwaiste Kandidaten zu prüfen. Vergleiche die Ergebnisse anschließend mit url-design-guide.md, um inkonsistente Slugs, zu tiefe Ordnerstrukturen, datumsbasierte Blog-Pfade, gemischte Trailing-Slash-Konventionen oder unklare Bereichsnamen zu erkennen.
Nutze danach internal-linking-playbook.md, um ein passendes Verlinkungsmuster auszuwählen. Hub-and-Spoke eignet sich meist besser für thematische Autorität; lineare Verlinkung passt zu Kursen und Dokumentation; Category-to-Product-Modelle passen zu E-Commerce. Wenn die Ressourcen begrenzt sind, bitte um eine priorisierte Fix-Liste statt um ein vollständiges Redesign.
Praktisches Prompt-Muster
Ein vollständiger Prompt für einen site-architecture Guide sollte das gewünschte Ausgabeformat enthalten. Zum Beispiel:
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.
Das reduziert vage Ratschläge und bringt den Assistant dazu, Entscheidungen zu formulieren, die SEO-, Content- und Engineering-Teams direkt weiterverwenden können.
FAQ zum site-architecture skill
Ist site-architecture für Technical-SEO-Arbeit geeignet?
Ja. site-architecture ist für Technical SEO besonders passend, wenn es um Crawl-Pfade, indexierbare URL-Muster, Seitentiefe, interne Verlinkung, Breadcrumbs, doppelte Strukturmuster oder migrationssichere URL-Entscheidungen geht. Weniger geeignet ist er für Logfile-Analysen, Core-Web-Vitals-Debugging oder Schema-Implementierung — außer diese Themen hängen direkt mit der Architektur zusammen.
Können Anfänger diesen Skill nutzen?
Ja, aber Anfänger sollten konkrete Website-Details liefern und um Erklärungen bitten. Der Skill enthält praxisnahe Referenzen, daher kannst du zum Beispiel anfordern: „explain each recommendation and why it matters for crawlability or rankings.“ Für einen ersten Durchlauf ist es sinnvoll, zunächst eine Diagnose anzufordern, bevor du ein komplettes Redesign verlangst.
Wie schneidet er im Vergleich zu einem normalen SEO-Prompt ab?
Ein normaler SEO-Prompt liefert oft breite Empfehlungen wie „füge interne Links hinzu“ oder „mach URLs kürzer“. Dieser Skill ist strukturierter: Er trennt Ist-Zustand, Ziele, Einschränkungen, URL-Design, Navigation und Verlinkungsarchitektur. Der enthaltene Sitemap Analyzer schafft außerdem einen besseren Weg von rohen Sitemap-Daten zu konkreten, umsetzbaren Erkenntnissen.
Wann sollte ich ihn nicht installieren?
Installiere site-architecture nicht, wenn du nur Blog-Themenideen, Metadata-Rewrites, Produktbeschreibungen oder Schema-Snippets brauchst. Verwende ihn außerdem nicht als alleinige Wahrheit für eine risikoreiche Migration; nutze ihn, um den Architekturplan zu erstellen, und validiere anschließend Redirects, Canonicals, Analytics und Crawl-Daten mit deinen SEO-Tools.
So verbesserst du den site-architecture skill
Gib dem Skill echte Website-Daten
Der beste Weg, die Ausgabe von site-architecture zu verbessern, ist eine Sitemap, die aktuelle Navigation, wichtige Seitentypen und Ranking-Prioritäten bereitzustellen. Wenn du die Domain nicht teilen kannst, gib anonymisierte URL-Beispiele nach Bereichen. Echte Beispiele helfen dem Assistant zu erkennen, ob das Problem in Tiefe, Benennung, Duplikation, schwachen Hubs oder fehlenden Links liegt.
Bitte um Entscheidungen, nicht nur um Beobachtungen
Eine schwache Anfrage lautet: „Was hältst du von unserer Struktur?“ Eine bessere Anfrage lautet:
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.
Das zwingt den Skill, Architektur-Empfehlungen zu liefern, die näher an der Umsetzung sind.
Achte auf typische Fehlerquellen
Typische Fehlerquellen sind URL-Änderungen ohne Berücksichtigung des Migrationsrisikos, zu viele Hub-Seiten, das pauschale Abflachen aller URLs unabhängig von ihrer Bedeutung oder interne Links, die kontextuell nicht wirklich hilfreich sind. Bitte den Assistant, „safe quick wins“ von „migration-level changes“ zu trennen und für jede strukturelle Empfehlung den SEO-Tradeoff zu erklären.
Iteriere nach der ersten Ausgabe
Nutze die erste Antwort als Entwurf einer Architekturkarte, nicht als finalen Plan. Ergänze anschließend Crawl-Daten, Search-Console-Exporte, Analytics-Prioritäten, CMS-Einschränkungen oder Entwicklerfeedback. Bitte den site-architecture skill dann, den Plan in eine phasenweise Roadmap zu überführen: sofort umsetzbare interne Links, Bereinigung der Navigation, URL-Governance-Regeln und längerfristige Restrukturierung.