Site Architecture & Internal Linking
This skill audits, redesigns, or plans a website's structure, URL hierarchy, navigation, and internal linking to improve SEO and user experience. It produces prioritized audits, site maps, URL specs, and internal linking plans.
✨ What it does
- Audits sitemap for depth, URL patterns, orphans, and duplicate paths.
- Designs URL hierarchies following flat vs layered principles and keyword rules.
- Plans navigation zones (primary, breadcrumbs, footer, contextual) with SEO roles.
- Builds hub-and-spoke silo structures for topical authority.
- Provides internal linking strategy with anchor text guidelines and orphan fixes.
- Flags common mistakes like deep nesting, thin category pages, and generic anchors.
🎯 When to use it
- When auditing an existing site's architecture for SEO issues like orphan pages or poor crawl depth.
- When planning a new site structure or redesigning URL hierarchy and navigation.
- When improving internal linking to boost topical authority and link equity flow.
- When diagnosing structural SEO problems (not content or schema related).
🚀 How to use
Trigger: /how-to-write-cold-emails
Trigger by asking for a site architecture audit, new structure plan, or internal linking strategy. Provide current site details (URL, CMS, sitemap), goals, and constraints. The skill runs scripts or asks for sitemap content. Example prompts:
Audit my site's architecture and find orphan pages.
Plan a new URL structure for my SaaS site with topic clusters.
📄 Output: Delivers a structural scorecard, site tree diagram, URL spec table, internal linking map, or redirect mapping depending on the request.
📦 Add this skill to Claude Code
# 1. Get the skills repo
git clone --depth 1 https://github.com/alirezarezvani/claude-skills /tmp/claude-skills
# 2. Copy this skill into your project (or ~/.claude/skills for all projects)
mkdir -p .claude/skills
cp -r /tmp/claude-skills/marketing-skill/skills/site-architecture .claude/skills/site-architectureSkill source: marketing-skill/skills/site-architecture/SKILL.md
⚠️ Good to know
Requires access to sitemap or site details; assumes CMS capabilities and redirect management are available for restructuring.
❓ FAQ
What is the recommended number of primary nav items?
5-8 items maximum to reduce cognitive load.
How do I find orphan pages?
Export indexed URLs and internal links, then compare; or run the sitemap_analyzer.py script.
Should I use exact match anchor text for internal links?
Use sparingly, 1-2 times per page; partial match is the primary approach.
🤖 Overview, features, install steps and FAQ were generated from the project's SKILL.md on Sep 4, 2026. Always check the original source before running commands.