seo-link-building

Installation
SKILL.md

SEO Link Building

Internal links are the one ranking lever fully inside the repo. This skill turns a Search Console export into a short list of pages worth pushing, then adds links to them from pages that already have authority, using wording those pages already contain.

<skill-dir> below is the directory this SKILL.md was read from. Run every command from the target repo's root: the scripts resolve paths against the working directory. Each script prints usage when run without arguments, and needs only Node 20+.

Rules that hold in every phase

  • Search Console data is private. Extract the export into a scratch directory outside the repo. Never commit it, and never put impressions, clicks, CTR or positions in a commit message, PR body, issue or any outside service. Write "pages ranking on page two" instead of numbers. A pushed commit message stays reachable by SHA even after a force-push, so get this right before the first push.
  • Deterministic work goes through the scripts. CSV filtering, inbound counts and text edits are scripts, not judgment. Judgment is for choosing the source sentence and the anchor.
  • Two PRs, in order. First the guard test plus the fixes it forces (mechanical, easy to review). Then the new links, rebased on the merged first PR. One PR mixing both is hard to review and slow to merge.
  • Follow the repo's own conventions over this file: its test runner, its link component (<Link> in MDX, href in JSX), its commit style, and its rules about em dashes, code spans in link text, and push permissions.

Phase 1: Guard the links that exist

Before adding links, make broken ones impossible.

Installs
1
GitHub Stars
4
First Seen
5 days ago