internal-link-auditlisted

Internal-linking tool for an Astro site built with the new-website kit. Builds the site's inbound-link graph from dist/ and reports which pages are ORPHANED (in the sitemap but no internal link points at them), THIN (a single inbound link, no contextual in-body link), or DEEP (more than ~3 clicks from home), then suggests WHERE to add the missing links using `site-architecture`'s internal-linking strategy. The judgment-side complement to the offline `tests/orphans.spec.ts` gate. Run before a release, after adding pages, or when GSC reports orphaned/low-coverage pages. Trigger phrases: "internal link audit", "orphaned pages", "are any pages orphaned", "internal linking", "which pages link to nothing", "fix orphan pages", "improve internal links", "cross-link the comparison pages".
karero/website-builder · ★ 4 · AI & Automation · score 74

Install: claude install-skill karero/website-builder

# Internal Link Audit Pages rot in the OTHER direction too: not the links that go dead, but the pages that nothing links TO. A page can be in the sitemap, pass every QA spec, and still be **orphaned** — reachable by no internal link, so crawlers find it late (or never) and no human browsing the site ever lands on it. The classic cause: a footer/nav link group that lists only ONE of a sibling set (e.g. one `acme-vs-<competitor>` comparison), leaving the rest linked from nowhere. This is the internal-link twin of `outgoing-link-audit`: | | offline CI gate | active sweep (this) | |---|---|---| | **outgoing** (dead/rebranded) | `tests/links.spec.ts` | `outgoing-link-audit` | | **internal** (orphan/thin) | `tests/orphans.spec.ts` | **`internal-link-audit`** | Read-only with respect to the site: it diagnoses and suggests. You apply fixes only after the user confirms. ## The strategy it enforces This skill does not invent its own linking rules — it **measures the built site against the strategy in `site-architecture`** (its "Internal Linking Strategy" section, plus its "3-Click Rule"; read them before suggesting fixes). The strategies, and how this audit checks each: | Strategy (from `site-architecture`) | How the audit enforces it | |---|---| | **No orphan pages** — every page has ≥1 inbound internal link | ORPHANS list (0 inbound) — the hard gate `tests/orphans.spec.ts` also fails on this | | **Hub-and-spoke / topic clusters** — hub links all spokes, spokes link the hub and