internal-linking/SKILL.md
Facts to use
- Google finds pages through links. It can follow links that are
<a>elements with anhrefattribute. Links made only with JavaScript click handlers may not be followed. - Anchor text helps Google understand the target page. Use descriptive text, not "click here".
- Every page you want indexed should have at least one link from another page on the site.
Workflow
- Crawl the site from the home page. Export, per URL: inbound internal links, the anchor texts used, and click depth from the home page.
- Compare with the sitemap. A URL in the sitemap with zero inbound links is an orphan.
- For each important page with few inbound links, find 3 to 5 pages on the same topic that should link to it.
- Add links inside the body text where the topic comes up, with anchor text that names the target page's topic.
- Add hub pages for groups of related pages (for example a guides index) and link each child page from the hub and back.
- Fix links that point to redirects or 404s so they point straight to the final URL.
Checks
- No orphan pages among indexable URLs.
- Important pages are at most three clicks from the home page.
- Links are
<a href>in the raw HTML.
Output
A table: target URL, current inbound links, source page to add, anchor text, sentence where the link goes.
Sources
- Google: Understand JavaScript SEO basics (links need <a href>). https://developers.google.com/search/docs/crawling-indexing/javascript/javascript-seo-basics