aiskillstore/marketplace / skills/aaron-he-zhu/site-structure-optimizer
site-structure-optimizer
VerifiedUse when the user asks to "plan my site structure", "design the page hierarchy / navigation / URL taxonomy", "fix internal linking", or "find orphan pages"; runs two modes — architecture (hierarchy, nav, URL patterns, hub/spoke clusters, Mermaid site maps) and linking (link graph, authority flow, anchor text, orphan disposition, source/target/anchor plan) — and outputs a structure score /100 plus a handoff summary. Not for external backlinks — use offsite-signal-analyzer; not for XML sitemap or indexation issues — use technical-seo-checker. 网站架构/信息架构/站点地图/内链优化
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 15.4 KB |
| references/link-architecture-patterns.md | markdown | 7.8 KB |
| references/linking-example.md | markdown | 2.7 KB |
| references/linking-templates.md | markdown | 4.3 KB |
| references/mermaid-templates.md | markdown | 3.1 KB |
| references/site-type-patterns.md | markdown | 3.5 KB |
| skill-report.json | config | 59.1 KB |
skill-report.json
View on GitHub{
"schema_version": "2.0",
"meta": {
"generated_at": "2026-07-12T14:06:08.403Z",
"slug": "aaron-he-zhu-site-structure-optimizer",
"source_url": "https://github.com/aaron-he-zhu/aaron-marketing-skills/tree/main/seo-geo/optimize/site-structure-optimizer",
"source_ref": "main",
"model": "codex",
"analysis_version": "3.0.0",
"source_type": "community",
"content_hash": "db7e1c45a474028936bed4fada47b4daf04ad3d143e6a62fa1e83fb22a7631e1",
"tree_hash": "205372dd64ac3c82df3742f3181a92150d9899a464fdffd1923320e113801d6f",
"provenance": {
"model_effective": "codex",
"fallback_chain": [
{
"agent": "codex",
"outcome": "success"
}
],
"analysis_version": "3.0.0"
}
},
"skill": {
"name": "site-structure-optimizer",
"description": "Plans website hierarchies, navigation, URL taxonomies, topic clusters, and internal links. It identifies orphans and produces scored, prioritized implementation plans.",
"summary": "Design clearer site architecture and stronger internal linking.",
"icon": "📦",
"version": "13.0.2",
"author": "aaron-he-zhu",
"license": "Apache-2.0",
"tags": [
"seo",
"information-architecture",
"internal-linking",
"site-navigation",
"url-taxonomy"
],
"supported_tools": [
"claude",
"codex",
"claude-code"
],
"risk_factors": [
"filesystem",
"external_commands",
"network"
],
"category": "productivity"
},
"security_audit": {
"risk_level": "safe",
"is_blocked": false,
"safe_to_publish": true,
"analysis_status": "ok",
"summary": "Two findings are confirmed because the skill instructs agents to run Python crawler and link-analysis helpers. All other findings are Markdown formatting, relative documentation links, diagrams, or repository metadata. No prompt injection or malicious intent was found.",
"remediation": [
{
"issue": "Crawler commands start external processes and access a user-supplied URL.",
"suggestion": "Require confirmation, validate schemes and hosts, block private addresses, and pass URLs as isolated arguments without shell interpolation.",
"severity": "medium"
}
],
"risk_factor_evidence": [
{
"factor": "filesystem",
"evidence": [
{
"file": "references/link-architecture-patterns.md",
"line_start": 3,
"line_end": 3
},
{
"file": "references/linking-example.md",
"line_start": 3,
"line_end": 3
},
{
"file": "references/linking-templates.md",
"line_start": 3,
"line_end": 3
},
{
"file": "references/mermaid-templates.md",
"line_start": 3,
"line_end": 3
},
{
"file": "references/site-type-patterns.md",
"line_start": 3,
"line_end": 3
},
{
"file": "SKILL.md",
"line_start": 33,
"line_end": 33
},
{
"file": "SKILL.md",
"line_start": 61,
"line_end": 61
},
{
"file": "SKILL.md",
"line_start": 65,
"line_end": 65
},
{
"file": "SKILL.md",
"line_start": 71,
"line_end": 71
},
{
"file": "SKILL.md",
"line_start": 75,
"line_end": 75
},
{
"file": "SKILL.md",
"line_start": 156,
"line_end": 156
},
{
"file": "SKILL.md",
"line_start": 159,
"line_end": 159
},
{
"file": "SKILL.md",
"line_start": 160,
"line_end": 160
}
]
},
{
"factor": "external_commands",
"evidence": [
{
"file": "SKILL.md",
"line_start": 20,
"line_end": 20
},
{
"file": "SKILL.md",
"line_start": 26,
"line_end": 26
},
{
"file": "SKILL.md",
"line_start": 27,
"line_end": 27
},
{
"file": "SKILL.md",
"line_start": 29,
"line_end": 29
},
{
"file": "SKILL.md",
"line_start": 35,
"line_end": 47
},
{
"file": "SKILL.md",
"line_start": 47,
"line_end": 51
},
{
"file": "SKILL.md",
"line_start": 51,
"line_end": 54
},
{
"file": "SKILL.md",
"line_start": 54,
"line_end": 55
},
{
"file": "SKILL.md",
"line_start": 55,
"line_end": 55
},
{
"file": "SKILL.md",
"line_start": 57,
"line_end": 68
},
{
"file": "SKILL.md",
"line_start": 68,
"line_end": 69
},
{
"file": "SKILL.md",
"line_start": 69,
"line_end": 87
},
{
"file": "SKILL.md",
"line_start": 87,
"line_end": 107
},
{
"file": "SKILL.md",
"line_start": 107,
"line_end": 109
},
{
"file": "SKILL.md",
"line_start": 109,
"line_end": 121
},
{
"file": "SKILL.md",
"line_start": 121,
"line_end": 144
},
{
"file": "SKILL.md",
"line_start": 144,
"line_end": 144
}
]
},
{
"factor": "network",
"evidence": [
{
"file": "SKILL.md",
"line_start": 10,
"line_end": 10
},
{
"file": "SKILL.md",
"line_start": 13,
"line_end": 13
}
]
}
],
"static_findings": [
{
"id": "filesystem:references/link-architecture-patterns.md:3:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "references/link-architecture-patterns.md",
"line_start": 3,
"line_end": 3,
"snippet": "Internal-link topologies, selection thresholds, migration safeguards, and measurement targets. Used "
},
{
"id": "blocker:references/link-architecture-patterns.md:12:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/link-architecture-patterns.md",
"line_start": 12,
"line_end": 12,
"snippet": "| Pyramid | Home → category → subcategory → page hierarchy, 3–4 levels max, breadcrumbs | News/media"
},
{
"id": "blocker:references/link-architecture-patterns.md:15:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/link-architecture-patterns.md",
"line_start": 15,
"line_end": 15,
"snippet": "**Default**: hub-spoke. Use silo when topical separation matters more than cross-topic discovery; us"
},
{
"id": "blocker:references/link-architecture-patterns.md:21:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/link-architecture-patterns.md",
"line_start": 21,
"line_end": 21,
"snippet": "| Signal | Hub-spoke | Silo | Flat | Pyramid | Mesh |"
},
{
"id": "blocker:references/link-architecture-patterns.md:24:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/link-architecture-patterns.md",
"line_start": 24,
"line_end": 24,
"snippet": "| Distinct topics | 3–15 pillars | many rigid categories | 1–3 | many, hierarchical | 1–2 |"
},
{
"id": "blocker:references/link-architecture-patterns.md:31:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/link-architecture-patterns.md",
"line_start": 31,
"line_end": 31,
"snippet": "| Metric | Hub-spoke target | Silo target | Flat target | Pyramid target | Mesh target |"
},
{
"id": "blocker:references/link-architecture-patterns.md:69:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/link-architecture-patterns.md",
"line_start": 69,
"line_end": 69,
"snippet": "| Model | Required links | Optional / conditional links | Avoid |"
},
{
"id": "blocker:references/link-architecture-patterns.md:74:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/link-architecture-patterns.md",
"line_start": 74,
"line_end": 74,
"snippet": "| Pyramid | Each level links down and up; breadcrumbs | Related-content links at page level | More t"
},
{
"id": "blocker:references/link-architecture-patterns.md:82:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/link-architecture-patterns.md",
"line_start": 82,
"line_end": 82,
"snippet": "| Silo | Hub-spoke | Silos too rigid for topical authority | Medium |"
},
{
"id": "blocker:references/link-architecture-patterns.md:83:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/link-architecture-patterns.md",
"line_start": 83,
"line_end": 83,
"snippet": "| Pyramid | Hub-spoke | Want topic clusters over hierarchy | High |"
},
{
"id": "filesystem:references/linking-example.md:3:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "references/linking-example.md",
"line_start": 3,
"line_end": 3,
"snippet": "One worked internal-linking example for a small blog, referenced from the Example section of [SKILL."
},
{
"id": "blocker:references/linking-example.md:11:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/linking-example.md",
"line_start": 11,
"line_end": 12,
"snippet": "```mermaid"
},
{
"id": "blocker:references/linking-example.md:46:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/linking-example.md",
"line_start": 46,
"line_end": 47,
"snippet": "```mermaid"
},
{
"id": "filesystem:references/linking-templates.md:3:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "references/linking-templates.md",
"line_start": 3,
"line_end": 3,
"snippet": "Copy-paste output templates for linking mode in [SKILL.md](../SKILL.md). Each template maps to one s"
},
{
"id": "blocker:references/linking-templates.md:10:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/linking-templates.md",
"line_start": 10,
"line_end": 10,
"snippet": "- **One primary target per anchor**: avoid pointing the same exact-match anchor at multiple pages."
},
{
"id": "filesystem:references/mermaid-templates.md:3:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "references/mermaid-templates.md",
"line_start": 3,
"line_end": 3,
"snippet": "Copy-paste `mermaid` diagrams for architecture Step 7 (Draw the Site Map) and linking-mode site maps"
},
{
"id": "blocker:references/mermaid-templates.md:1:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/mermaid-templates.md",
"line_start": 1,
"line_end": 1,
"snippet": "# Mermaid Templates — site hierarchy & link graph"
},
{
"id": "blocker:references/mermaid-templates.md:3:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/mermaid-templates.md",
"line_start": 3,
"line_end": 3,
"snippet": "Copy-paste `mermaid` diagrams for architecture Step 7 (Draw the Site Map) and linking-mode site maps"
},
{
"id": "blocker:references/mermaid-templates.md:7:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/mermaid-templates.md",
"line_start": 7,
"line_end": 8,
"snippet": "```mermaid"
},
{
"id": "blocker:references/mermaid-templates.md:20:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/mermaid-templates.md",
"line_start": 20,
"line_end": 21,
"snippet": "```mermaid"
},
{
"id": "blocker:references/mermaid-templates.md:36:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/mermaid-templates.md",
"line_start": 36,
"line_end": 37,
"snippet": "```mermaid"
},
{
"id": "blocker:references/mermaid-templates.md:48:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/mermaid-templates.md",
"line_start": 48,
"line_end": 48,
"snippet": "Solid = hub↔spoke links; `---` = cross-links between spokes. Purple = the hub/pillar."
},
{
"id": "blocker:references/mermaid-templates.md:54:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/mermaid-templates.md",
"line_start": 54,
"line_end": 55,
"snippet": "```mermaid"
},
{
"id": "blocker:references/mermaid-templates.md:78:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/mermaid-templates.md",
"line_start": 78,
"line_end": 79,
"snippet": "```mermaid"
},
{
"id": "blocker:references/mermaid-templates.md:100:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/mermaid-templates.md",
"line_start": 100,
"line_end": 101,
"snippet": "```mermaid"
},
{
"id": "filesystem:references/site-type-patterns.md:3:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "references/site-type-patterns.md",
"line_start": 3,
"line_end": 3,
"snippet": "Depth, topology, and URL taxonomy defaults by site type. Used at Step 2 (Pick the Model) and Step 4 "
},
{
"id": "blocker:references/site-type-patterns.md:31:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/site-type-patterns.md",
"line_start": 31,
"line_end": 31,
"snippet": "| Rule | Do | Avoid |"
},
{
"id": "external_commands:SKILL.md:20:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 20,
"line_end": 20,
"snippet": "**Scope guard**: this skill does not compute the CORE-EEAT score or run vetoes (T04, C01, R10) — tha"
},
{
"id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 26,
"line_end": 26,
"snippet": "| `architecture` | Whole-site layout | New build or restructure; the layout itself is the question |"
},
{
"id": "external_commands:SKILL.md:27:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 27,
"line_end": 27,
"snippet": "| `linking` | Links inside an existing layout | Pages exist; the question is how they connect | Orph"
},
{
"id": "external_commands:SKILL.md:29:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 29,
"line_end": 29,
"snippet": "Pick the mode from `--mode` if given. Otherwise infer: \"plan / design structure / URL taxonomy / hub"
},
{
"id": "external_commands:SKILL.md:35:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 35,
"line_end": 47,
"snippet": "```text"
},
{
"id": "external_commands:SKILL.md:47:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 47,
"line_end": 51,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:51:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 51,
"line_end": 54,
"snippet": "**Expected output** (mode-dependent): architecture mode → a page hierarchy (ASCII tree), a URL map t"
},
{
"id": "external_commands:SKILL.md:54:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 54,
"line_end": 55,
"snippet": "- **Writes**: a user-facing structure plan plus a reusable summary that can be stored under `memory/"
},
{
"id": "external_commands:SKILL.md:55:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 55,
"line_end": 55,
"snippet": "- **Promotes**: blocking defects (e.g. URL migrations without redirects, high-value orphans), recurr"
},
{
"id": "external_commands:SKILL.md:57:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 57,
"line_end": 68,
"snippet": "- **Primary next skill**: use the `Next Best Skill` below once the mode's deliverable is set."
},
{
"id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 68,
"line_end": 69,
"snippet": "- Architecture / seed inventory: `python3 \"${CLAUDE_PLUGIN_ROOT}/scripts/connectors/crawl.py\" <url>`"
},
{
"id": "external_commands:SKILL.md:69:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 69,
"line_end": 87,
"snippet": "- Linking metrics: `python3 \"${CLAUDE_PLUGIN_ROOT}/scripts/connectors/crawl.py\" <url> | python3 \"${C"
},
{
"id": "external_commands:SKILL.md:87:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 87,
"line_end": 107,
"snippet": "7. **Draw the Site Map (Mermaid)** — Render a `graph TD` with one subgraph per nav zone. Put orphans"
},
{
"id": "external_commands:SKILL.md:107:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 107,
"line_end": 109,
"snippet": "To make orphan pages and link islands visible, draw a Mermaid `graph TD` with one subgraph per nav z"
},
{
"id": "external_commands:SKILL.md:109:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 109,
"line_end": 121,
"snippet": "```mermaid"
},
{
"id": "external_commands:SKILL.md:121:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 121,
"line_end": 144,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:144:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 144,
"line_end": 144,
"snippet": "Ask to save results; if yes, write a dated summary to `memory/seo-geo/optimize/site-structure-optimi"
},
{
"id": "network:SKILL.md:10:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "SKILL.md",
"line_start": 10,
"line_end": 10,
"snippet": "homepage: \"https://github.com/aaron-he-zhu/aaron-marketing-skills\""
},
{
"id": "network:SKILL.md:13:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "SKILL.md",
"line_start": 13,
"line_end": 13,
"snippet": "metadata: {\"author\": \"aaron-he-zhu\", \"version\": \"17.0.0\", \"discipline\": \"seo-geo\", \"phase\": \"optimiz"
},
{
"id": "filesystem:SKILL.md:33:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "SKILL.md",
"line_start": 33,
"line_end": 33,
"snippet": "Start with one of these prompts, then finish with the standard handoff summary from [Skill Contract]"
},
{
"id": "filesystem:SKILL.md:61:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "SKILL.md",
"line_start": 61,
"line_end": 61,
"snippet": "> Emit the standard shape from [skill-contract.md §Handoff Summary Format](../../../references/skill"
},
{
"id": "filesystem:SKILL.md:65:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "SKILL.md",
"line_start": 65,
"line_end": 65,
"snippet": "Uses ~~web crawler, ~~SEO tool, and ~~analytics when connected; otherwise asks the user for site typ"
},
{
"id": "filesystem:SKILL.md:71:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "SKILL.md",
"line_start": 71,
"line_end": 71,
"snippet": "See [scripts/connectors/README.md](../../../scripts/connectors/README.md)."
},
{
"id": "filesystem:SKILL.md:75:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "SKILL.md",
"line_start": 75,
"line_end": 75,
"snippet": "Label every metric **Measured** (tool/export), **User-provided**, or **Estimated** (model inference)"
},
{
"id": "filesystem:SKILL.md:156:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "SKILL.md",
"line_start": 156,
"line_end": 156,
"snippet": "Termination: apply the global visited-set / `max-depth: 3` / ambiguity-stop rules from [skill-contra"
},
{
"id": "filesystem:SKILL.md:159:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "SKILL.md",
"line_start": 159,
"line_end": 159,
"snippet": "- If you ran **linking** mode: primary → [on-page-seo-auditor](../on-page-seo-auditor/SKILL.md) — ve"
},
{
"id": "filesystem:SKILL.md:160:path-traversal-sequence",
"category": "filesystem",
"severity": "high",
"pattern": "Path traversal sequence",
"file": "SKILL.md",
"line_start": 160,
"line_end": 160,
"snippet": "- If the structure is publish-ready and a scored gate is needed: [content-quality-auditor](../conten"
},
{
"id": "blocker:SKILL.md:6:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 6,
"line_end": 6,
"snippet": "description: 'Use when the user asks to \"plan my site structure\", \"design the page hierarchy / navig"
},
{
"id": "blocker:SKILL.md:18:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 18,
"line_end": 18,
"snippet": "Works one lever of site structure at two altitudes. **Architecture mode** designs the whole-site inf"
},
{
"id": "blocker:SKILL.md:26:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 26,
"line_end": 26,
"snippet": "| `architecture` | Whole-site layout | New build or restructure; the layout itself is the question |"
},
{
"id": "blocker:SKILL.md:51:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 51,
"line_end": 51,
"snippet": "**Expected output** (mode-dependent): architecture mode → a page hierarchy (ASCII tree), a URL map t"
},
{
"id": "blocker:SKILL.md:56:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 56,
"line_end": 56,
"snippet": "- **Done when**: the chosen mode's core outputs are produced (architecture: hierarchy + URL taxonomy"
},
{
"id": "blocker:SKILL.md:87:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 87,
"line_end": 87,
"snippet": "7. **Draw the Site Map (Mermaid)** — Render a `graph TD` with one subgraph per nav zone. Put orphans"
},
{
"id": "blocker:SKILL.md:107:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 107,
"line_end": 107,
"snippet": "To make orphan pages and link islands visible, draw a Mermaid `graph TD` with one subgraph per nav z"
},
{
"id": "blocker:SKILL.md:109:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 109,
"line_end": 110,
"snippet": "```mermaid"
},
{
"id": "blocker:SKILL.md:149:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 149,
"line_end": 149,
"snippet": "- [Mermaid Templates](references/mermaid-templates.md) — Copy-paste site-map diagrams: hierarchy, na"
}
],
"finding_verdicts": [
{
"id": "filesystem:references/link-architecture-patterns.md:3:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The traversal sequence appears only inside a relative Markdown link to skill documentation. No filesystem API or path-based read or write operation is present."
},
{
"id": "blocker:references/link-architecture-patterns.md:12:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:references/link-architecture-patterns.md:15:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:references/link-architecture-patterns.md:21:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:references/link-architecture-patterns.md:24:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:references/link-architecture-patterns.md:31:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:references/link-architecture-patterns.md:69:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:references/link-architecture-patterns.md:74:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:references/link-architecture-patterns.md:82:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:references/link-architecture-patterns.md:83:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "filesystem:references/linking-example.md:3:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The traversal sequence appears only inside a relative Markdown link to skill documentation. No filesystem API or path-based read or write operation is present."
},
{
"id": "blocker:references/linking-example.md:11:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:references/linking-example.md:46:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "filesystem:references/linking-templates.md:3:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The traversal sequence appears only inside a relative Markdown link to skill documentation. No filesystem API or path-based read or write operation is present."
},
{
"id": "blocker:references/linking-templates.md:10:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "filesystem:references/mermaid-templates.md:3:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The traversal sequence appears only inside a relative Markdown link to skill documentation. No filesystem API or path-based read or write operation is present."
},
{
"id": "blocker:references/mermaid-templates.md:1:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:references/mermaid-templates.md:3:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:references/mermaid-templates.md:7:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:references/mermaid-templates.md:20:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:references/mermaid-templates.md:36:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:references/mermaid-templates.md:48:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:references/mermaid-templates.md:54:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:references/mermaid-templates.md:78:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:references/mermaid-templates.md:100:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "filesystem:references/site-type-patterns.md:3:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The traversal sequence appears only inside a relative Markdown link to skill documentation. No filesystem API or path-based read or write operation is present."
},
{
"id": "blocker:references/site-type-patterns.md:31:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "external_commands:SKILL.md:20:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The backticks format skill names in a scope statement; they are Markdown literals and do not execute a shell."
},
{
"id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The backticks format the architecture mode name inside a Markdown table; no command is present."
},
{
"id": "external_commands:SKILL.md:27:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The backticks format the linking mode name inside a Markdown table; no command is present."
},
{
"id": "external_commands:SKILL.md:29:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The backticks format mode arguments and labels in prose; the line contains no executable backtick expression."
},
{
"id": "external_commands:SKILL.md:35:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The matched backticks open a fenced text example containing user prompts, not executable shell or Ruby code."
},
{
"id": "external_commands:SKILL.md:47:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The matched backticks close a fenced text example and do not invoke any command."
},
{
"id": "external_commands:SKILL.md:51:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The backticks format a memory path in descriptive output requirements; no process execution occurs."
},
{
"id": "external_commands:SKILL.md:54:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The backticks format a proposed memory directory in prose; this finding does not contain a command."
},
{
"id": "external_commands:SKILL.md:55:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The backticks format a Markdown file path and status label; they are not shell execution syntax here."
},
{
"id": "external_commands:SKILL.md:57:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The backticks format a section name in prose; no external command is invoked."
},
{
"id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
"verdict": "confirmed",
"confidence": 0.9,
"reason": "This line invokes an external Python crawler against a supplied URL. The command and resulting network crawl have side effects that require explicit user authorization.",
"severity": "medium"
},
{
"id": "external_commands:SKILL.md:69:ruby-shell-backtick-execution",
"verdict": "confirmed",
"confidence": 0.9,
"reason": "This line runs a crawler and pipes its output into another Python helper. These external processes and network activity are real operational risks.",
"severity": "medium"
},
{
"id": "external_commands:SKILL.md:87:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The backticks format Mermaid syntax in documentation; Mermaid graph text is output content, not a shell command."
},
{
"id": "external_commands:SKILL.md:107:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The backticks format Mermaid syntax in prose; the instruction only asks for a diagram."
},
{
"id": "external_commands:SKILL.md:109:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The matched backticks open a Mermaid diagram fence, which is rendered documentation rather than executable shell code."
},
{
"id": "external_commands:SKILL.md:121:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The matched backticks close a Mermaid diagram fence and do not execute a command."
},
{
"id": "external_commands:SKILL.md:144:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The backticks format memory paths and a skill name in save instructions; they are Markdown literals, not backtick execution."
},
{
"id": "network:SKILL.md:10:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The URL is repository metadata pointing to the author's GitHub project. This line does not make a request or transmit user data."
},
{
"id": "network:SKILL.md:13:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The URL is repository metadata pointing to the author's GitHub project. This line does not make a request or transmit user data."
},
{
"id": "filesystem:SKILL.md:33:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The traversal sequence appears only inside a relative Markdown link to skill documentation. No filesystem API or path-based read or write operation is present."
},
{
"id": "filesystem:SKILL.md:61:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The traversal sequence appears only inside a relative Markdown link to skill documentation. No filesystem API or path-based read or write operation is present."
},
{
"id": "filesystem:SKILL.md:65:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The traversal sequence appears only inside a relative Markdown link to skill documentation. No filesystem API or path-based read or write operation is present."
},
{
"id": "filesystem:SKILL.md:71:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The traversal sequence appears only inside a relative Markdown link to skill documentation. No filesystem API or path-based read or write operation is present."
},
{
"id": "filesystem:SKILL.md:75:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The traversal sequence appears only inside a relative Markdown link to skill documentation. No filesystem API or path-based read or write operation is present."
},
{
"id": "filesystem:SKILL.md:156:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The traversal sequence appears only inside a relative Markdown link to skill documentation. No filesystem API or path-based read or write operation is present."
},
{
"id": "filesystem:SKILL.md:159:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The traversal sequence appears only inside a relative Markdown link to skill documentation. No filesystem API or path-based read or write operation is present."
},
{
"id": "filesystem:SKILL.md:160:path-traversal-sequence",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The traversal sequence appears only inside a relative Markdown link to skill documentation. No filesystem API or path-based read or write operation is present."
},
{
"id": "blocker:SKILL.md:6:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:SKILL.md:18:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:SKILL.md:26:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:SKILL.md:51:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:SKILL.md:56:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:SKILL.md:87:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:SKILL.md:107:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:SKILL.md:109:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
},
{
"id": "blocker:SKILL.md:149:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The matched text describes website hierarchy, SEO structure, or Mermaid diagram content. It does not inspect the host system or collect system information."
}
],
"semantic_findings": [],
"critical_findings": [],
"high_findings": [],
"medium_findings": [
{
"title": "Ruby/shell backtick execution",
"description": "- Architecture / seed inventory: `python3 \"${CLAUDE_PLUGIN_ROOT}/scripts/connectors/crawl.py\" <url>`",
"locations": [
{
"file": "SKILL.md",
"line_start": 68,
"line_end": 69
}
],
"review_kind": "capability",
"source_category": "external_commands",
"source_severity": "medium",
"confidence": 0.9,
"confidence_reasoning": "This line invokes an external Python crawler against a supplied URL. The command and resulting network crawl have side effects that require explicit user authorization."
},
{
"title": "Ruby/shell backtick execution",
"description": "- Linking metrics: `python3 \"${CLAUDE_PLUGIN_ROOT}/scripts/connectors/crawl.py\" <url> | python3 \"${C",
"locations": [
{
"file": "SKILL.md",
"line_start": 69,
"line_end": 87
}
],
"review_kind": "capability",
"source_category": "external_commands",
"source_severity": "medium",
"confidence": 0.9,
"confidence_reasoning": "This line runs a crawler and pipes its output into another Python helper. These external processes and network activity are real operational risks."
}
],
"low_findings": [],
"dangerous_patterns": [],
"files_scanned": 6,
"total_lines": 631,
"audit_model": "codex",
"audited_at": "2026-07-12T14:06:08.403Z",
"agent_auto_install_policy": "allowed",
"manual_install_policy": "allowed"
},
"content": {
"user_title": "Optimize Your Site Structure and Internal Links",
"value_statement": "Complex websites hide important pages and weaken navigation. This skill creates a clear hierarchy, URL plan, link map, and prioritized implementation roadmap.",
"seo_keywords": [
"Claude",
"Codex",
"Claude Code",
"site structure optimizer",
"internal linking",
"information architecture",
"URL taxonomy",
"orphan page audit",
"SEO site map",
"topic clusters"
],
"actual_capabilities": [
"Selects architecture or linking mode from the request.",
"Designs page hierarchies, navigation zones, and URL taxonomies.",
"Maps hub-and-spoke topic clusters and cross-section links.",
"Identifies orphan pages, link islands, crawl-depth issues, and anchor-text problems.",
"Produces Mermaid site maps, structure scores, redirect guidance, and prioritized action plans."
],
"limitations": [
"Requires a domain, sitemap, page inventory, or user-provided site details.",
"Cannot measure live metrics without connected crawler, SEO, or analytics tools.",
"Does not analyze external backlinks, XML sitemap health, or indexation.",
"Recommendations need human review before URL changes, redirects, deletion, or noindex actions."
],
"use_cases": [
{
"title": "Plan a New Website",
"description": "Create a page hierarchy, navigation model, URL taxonomy, and topic clusters before development begins.",
"target_user": "Product marketers and website strategists"
},
{
"title": "Restructure a Growing Site",
"description": "Find buried pages, inconsistent URL parents, weak navigation, and migration risks across an established website.",
"target_user": "SEO managers and content leads"
},
{
"title": "Improve Internal Links",
"description": "Identify orphans, weak authority flow, generic anchors, and specific source-to-target link opportunities.",
"target_user": "Content editors and SEO specialists"
}
],
"prompt_templates": [
{
"title": "Create a Basic Site Plan",
"scenario": "Beginner planning for a new website",
"prompt": "Use architecture mode for a new [site type] website. Organize these pages: [page list]. Propose hierarchy, navigation, URLs, and topic clusters."
},
{
"title": "Restructure an Existing Site",
"scenario": "Intermediate website reorganization",
"prompt": "Review this sitemap or page inventory: [pages]. Preserve these URLs: [URLs]. Design a clearer structure and include redirects for changed URLs."
},
{
"title": "Audit Internal Linking",
"scenario": "Advanced analysis of an existing website",
"prompt": "Use linking mode for [domain or sitemap]. Identify orphans, deep pages, link islands, anchor issues, and prioritized source-target-anchor recommendations."
},
{
"title": "Plan a Controlled Migration",
"scenario": "Advanced architecture and linking program",
"prompt": "Design a phased migration from [current model] to [target model]. Include URL mapping, redirects, navigation changes, link updates, risks, metrics, and validation gates."
}
],
"output_examples": [
{
"input": "Plan the architecture for a SaaS site with product, pricing, use-case, customer, and resource pages.",
"output": [
"Architecture mode selected with a shallow SaaS hierarchy.",
"The plan groups features and use cases under stable parent sections.",
"Navigation, URL mapping, topic clusters, site map, score, and phased actions are included."
]
},
{
"input": "Find internal linking problems in a content site with a sitemap and crawl export.",
"output": [
"The audit lists measured orphan pages, deep pages, and under-linked priorities.",
"Each recommended link includes its source, target, anchor, reason, and priority.",
"The result includes an anchor review, structure score, and tracking plan."
]
},
{
"input": "Add internal links for a new article about email marketing best practices.",
"output": [
"The plan connects the article to list building, segmentation, automation, subject lines, and tools pages.",
"Each spoke receives a descriptive return link to the main article.",
"Low-value orphan pages receive a review recommendation before redirect or removal."
]
}
],
"best_practices": [
"Provide a complete page inventory and mark the most important pages.",
"Separate measured data, user-provided facts, and estimates.",
"Review traffic and rankings before deleting, redirecting, or hiding orphan pages."
],
"anti_patterns": [
"Do not change live URLs without a complete redirect map.",
"Do not treat estimated crawl or link metrics as measured results.",
"Do not add links only to meet a quota when topics are unrelated."
],
"faq": [
{
"question": "What information should I provide?",
"answer": "Provide the site type, goals, page inventory or sitemap, priority pages, audiences, and URLs that must remain unchanged."
},
{
"question": "Can it crawl my website?",
"answer": "It can use a connected crawler with your approval. Without one, it works from a sitemap, export, or page list."
},
{
"question": "What is the difference between the two modes?",
"answer": "Architecture mode designs the website layout. Linking mode improves connections among pages that already exist."
},
{
"question": "Does it create an XML sitemap?",
"answer": "No. It creates visual site maps and URL plans, while XML sitemap and indexation checks require technical SEO tooling."
},
{
"question": "How does it handle orphan pages?",
"answer": "It identifies each orphan, estimates its value, and recommends adding links, redirecting, applying noindex, or removing it after review."
},
{
"question": "Will it change my website automatically?",
"answer": "No. It produces recommendations and implementation plans. A person should approve navigation, URL, redirect, deletion, and noindex changes."
}
]
},
"file_structure": [
{
"name": "references",
"type": "dir",
"path": "references",
"children": [
{
"name": "link-architecture-patterns.md",
"type": "file",
"path": "references/link-architecture-patterns.md",
"lines": 118
},
{
"name": "linking-example.md",
"type": "file",
"path": "references/linking-example.md",
"lines": 74
},
{
"name": "linking-templates.md",
"type": "file",
"path": "references/linking-templates.md",
"lines": 96
},
{
"name": "mermaid-templates.md",
"type": "file",
"path": "references/mermaid-templates.md",
"lines": 120
},
{
"name": "site-type-patterns.md",
"type": "file",
"path": "references/site-type-patterns.md",
"lines": 62
}
]
},
{
"name": "SKILL.md",
"type": "file",
"path": "SKILL.md",
"lines": 161
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |