seo-geo-report-engine: Skill for Claude Code

internal-linking

Designs the link architecture that connects keyword clusters and programmatic pages into crawlable, equity-flowing silos — and routes that equity toward money/conversion pages. This is planning, not auditing: technical-seo-audit flags broken/orphaned links as issues; this skill decides the target graph. Prefer Ahrefs MCP (knowledge/ahrefs-mcp-map.md); call doc on a tool before first use. Reuse the hub-spoke seed in playbooks/programmatic-seo.md §7.

Inputs

• projects/<client>/research/keyword-map.md + keywords.csv (from keyword-research) — clusters, intent, target pages. One cluster = one pillar candidate.
• client.yml — domain, money/conversion pages (sales, pricing, demo, signup, key services).

Methodology (PERCEIVE → ANALYZE → VALIDATE → ACT)

PERCEIVE — map the current graph. Resolve project (./bin/mkt config show --project <client>). Pull the live internal-link structure:

• site-explorer-pages-by-internal-links — inbound internal links per URL. Sort it: the long tail with 0–1 inbound internal links = orphans / near-orphans; the top fat-head pages are where equity is hoarded.
• site-explorer-linked-anchors-internal — the internal anchor-text profile (what text currently points where). Flags exact-match over-optimization and generic "click here / read more" waste.
• site-explorer-pages-by-traffic + site-explorer-top-pages — which pages actually hold equity and traffic, so we link from strength into targets.
• Cross-check orphans against keywords.csv — an orphan that's a real cluster target is high-value rescue; an orphan with no demand may just be prunable.

ANALYZE — design the target graph.

• Cluster → hub-and-spoke. Each keyword-research cluster becomes one pillar (hub) ↔ N spokes. Pillar = the broad/commercial head target; spokes = the informational long-tail pages. Where keyword-research used SERP-overlap to group terms, that same overlap defines which spokes are sibling-related and should cross-link.
• Link rules (the silo): every spoke links up to its pillar; pillar links down to every spoke; siblings within a cluster cross-link where contextually relevant; pillars link laterally to adjacent pillars only when topically justified (avoid diluting the silo).
• Equity flow to money pages. Identify high-equity/high-traffic pages from PERCEIVE and route contextual links into money/conversion pages from them. Money pages are the sink of the graph, not just nav-linked.
• Anchor distribution. Vary anchors per target: a mix of exact, partial, and semantic/branded — relevance-scored to the destination's primary keyword. Replace generic anchors surfaced by -linked-anchors-internal. No single exact-match anchor should dominate a target (over-optimization risk).
• Cannibalization flag. If two pages target the same intent/keyword (same target_page collision in keywords.csv, or both rank for one term in site-explorer-organic-keywords), don't cross-link them as equals — pick the canonical, point the other's equity into it, and flag for consolidation.