Site Architecture Skill Security Audit
What the author says it does (original text)
When the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal linking. Also use when the user mentions "sitemap," "site map," "visual sitemap," "site structure," "page hierarchy," "information architecture," "IA," "navigation design," "URL structure," "breadcrumbs," "internal linking strategy," "website planning," "what pages do I need," "h
No obvious risks found in this check
- Files checked
- 5
- Risks found
- 0
Inside this skill
This Skill plans page hierarchy, navigation, URL patterns, and internal links. Its main outputs are text trees, Mermaid sitemaps, URL maps, navigation specifications, and internal-linking plans. The supplied files contain no executable scripts, installation steps, or account actions.
View source
You are an information architecture expert. Your goal is to help plan website structure — page hierarchy, navigation, URL patterns, and internal linking — so the site is intuitive for users and optimized for search engines.When creating a site architecture plan, provide these deliverables:### 1. Page Hierarchy (ASCII Tree)Full site structure with URLs at each node. Use the ASCII tree format from the Page Hierarchy Design section.### 2. Visual Sitemap (Mermaid)Mermaid diagram showing page relationships and navigation zones. Use `graph TD` with subgraphs for nav zones where helpful.### 4. Navigation Spec- Header nav items (ordered, with CTA)- Footer sections and links- Sidebar nav (if applicable)- Breadcrumb implementation notes### 5. Internal Linking Plan- Hub pages and their spokes- Cross-section link opportunities- Orphan page audit (if restructuring)- Recommended links per key pageBefore planning, it looks for and reads a product-marketing context file in the project, then asks only for information not already covered. The read is limited to three named candidate paths and is directly related to site planning; the text does not instruct uploading or externally sending the content.
View source
**Check for product marketing context first:**If `.agents/product-marketing.md` exists (or `.claude/product-marketing.md`, or the legacy `product-marketing-context.md` filename, in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.Gather this context (ask if not provided):For an existing-site restructure, the Skill asks which old URLs must be preserved and requires 301 redirects when URLs change, reducing broken links and lost search value. It gives planning guidance and does not instruct direct modification or deletion of website files.
View source
### 2. Current State- New site or restructuring an existing one?- If restructuring: what's broken? (high bounce, poor SEO, users can't find things)- Existing URLs that must be preserved (for redirects)?### Common Mistakes- **Dates in blog URLs** — `/blog/2024/01/15/post-title` adds no value and makes URLs long. Use `/blog/post-title`.- **Over-nesting** — `/products/category/subcategory/item/detail` is too deep. Flatten where possible.- **Changing URLs without redirects** — Every old URL needs a 301 redirect to its new URL. Without them, you lose backlink equity and create broken pages for anyone with the old URL bookmarked or linked.- **IDs in URLs** — `/product/12345` is not human-readable. Use slugs.- **Query parameters for content** — `/blog?id=123` should be `/blog/post-title`.The referenced files are static templates for page hierarchies, navigation, and Mermaid diagrams. The main instructions point to these local files, and the manifest confirms all three references are present; the visible content does not request network access, external services, or elevated permissions.
View source
**For full page hierarchy templates**: See [references/site-type-templates.md](references/site-type-templates.md)**For detailed navigation patterns**: See [references/navigation-patterns.md](references/navigation-patterns.md)**For more Mermaid templates**: See [references/mermaid-templates.md](references/mermaid-templates.md)File reference map
References: 3Files and check records5 files
Coverage and gaps
Content covered in each file
These are the source ranges included in this check, not a guarantee that every issue has been resolved.
SKILL.mdFull text includedreferences/mermaid-templates.mdFull text includedreferences/navigation-patterns.mdFull text includedreferences/site-type-templates.mdFull text includedevals/evals.jsonFull text included
This report is for the version above. We read the available code and instructions without running the skill or checking extra packages it installs. This is not a promise of safety: a different version or setup may behave differently.
SKILL.mdInstructionsevals/evals.jsonSupporting filereferences/mermaid-templates.mdSupporting filereferences/navigation-patterns.mdSupporting filereferences/site-type-templates.mdSupporting file
Operations mentioned in code and instructions
Connect to websites
<nav aria-label="Breadcrumb"> <ol itemscope itemtype="https://schema.org/BreadcrumbList"> <li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem"> <ol itemscope itemtype="https://schema.org/BreadcrumbList"> <li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem"> <a itemprop="item" href="/"><span itemprop="name">Home</span></a> </li> <li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem"> <a itemprop="item" href="/features"><span itemprop="name">Features</span></a>- Lines read
- 1,264
- File checksum (to compare versions)
- cff3a09c1ba6e8c754dbcb45dfca79d8ab05a09e3c7189757a06292d8686b8de