AGENT SKILL

internal-linking-mapper

Maps internal links and anchor text between a new or updated page and an existing URL inventory to strengthen a topic cluster, producing a source/target/anchor link table plus a hub-and-spoke check. Use when someone asks "which pages should this article link to", "how do I internally link my new post", "is this page orphaned", or has a draft plus a sitemap, URL export, or pillar/cluster map and needs to decide the inbound links, outbound links, and anchors. Do NOT use to design the cluster or pillar architecture from a keyword export - use keyword-cluster-builder instead; do NOT use for on-page rewrites of titles, headings, or body copy - use seo-optimizer instead; do NOT use when a page is slipping in rankings and needs SERP-intent update actions - use content-refresh-auditor instead.

License 许可
MIT
所属仓库
SkillMedev/skills
最近更新
2026-10-14
Stars
★ 25
Forks
3

01 前言 Front Matter

name
internal-linking-mapper
metadata
{ "title": "Internal Linking Mapper" }
description
Maps internal links and anchor text between a new or updated page and an existing URL inventory to strengthen a topic cluster, producing a source/target/anchor link table plus a hub-and-spoke check. Use when someone asks "which pages should this article link to", "how do I internally link my new post", "is this page orphaned", or has a draft plus a sitemap, URL export, or pillar/cluster map and needs to decide the inbound links, outbound links, and anchors. Do NOT use to design the cluster or pillar architecture from a keyword export - use keyword-cluster-builder instead; do NOT use for on-page rewrites of titles, headings, or body copy - use seo-optimizer instead; do NOT use when a page is slipping in rankings and needs SERP-intent update actions - use content-refresh-auditor instead.

03 SKILL.md 正文

Internal Linking Mapper

Wire one page into an existing site so the whole topic cluster gains authority: pick the outbound links from the new page, the inbound links into it, and descriptive anchor text for each. The costly mistake this prevents is the orphan - a page with zero inbound internal links that search engines rarely crawl and never rank - and its opposite, exact-match anchor spam that reads as manipulation. This skill assumes the cluster already exists and the page content is set; it only decides the links.

Operating procedure

Order matters: you cannot plan links until you know the inventory, and you cannot write anchors until you know the links.

Step 1: Gather inputs

  • The target page: topic, primary keyword, and draft or URL.
  • The existing URL inventory: sitemap, URL export, or pillar/cluster map. If none is supplied, ask for one - never invent URLs.
  • Optional but valuable: which page is the top money/conversion page, and any pages known to be thin, noindex, or non-canonical (these are link dead-ends).

If the site architecture is unknown, ask one framing question: how many clicks from the homepage is this page's section? Every important page should sit within 3 clicks of the home page; if the new page would land deeper, flag it - internal links from higher-level pages are the fix.

Step 2: Locate the cluster

Identify the page's pillar and its sibling cluster pages by topic match. Anything outside the cluster is a candidate only when genuinely relevant to the reader.

Step 3: Plan outbound links from the new page

  • One link up to the pillar - mandatory in a hub-and-spoke structure.
  • Cross-links to siblings only where the content actually references them.
  • One contextual link to the top money/conversion page when the relevance is real, not forced.
  • Practical cap: roughly 3-8 contextual in-body links for a standard article. Beyond that, each additional link dilutes the rest and reads as padding.

Step 4: Plan inbound links into the new page

Scan the inventory for pages whose body naturally mentions the new topic, and specify exactly where each adds a contextual in-body link pointing to the new page. Target a minimum of 2-3 inbound links, always including one from the pillar. A page with zero inbound internal links is effectively orphaned; one inbound link is a single point of failure.

Step 5: Write anchor text per link

  • Use a descriptive phrase containing the target's topic - a reader should predict the destination from the anchor alone.
  • Vary wording across links to the same target; never repeat one exact-match anchor site-wide.
  • Never "click here", "read more", or a bare URL.
  • Keep anchors natural in-sentence, typically 2-6 words.

Step 6: Place and prune

Links go in body context, not footer or sidebar boilerplate - boilerplate links carry little ranking value and no reader intent. Cut every link that does not help the reader; the map should end shorter than the candidate list.

Step 7: Output the map

Return a table of source page, target page, anchor text, and direction.

Worked artifact: hub-and-spoke link map

New page: /blog/email-warmup-schedule (cluster: email deliverability; pillar: /guides/email-deliverability).

LINK MAP - /blog/email-warmup-schedule

| # | Source page                        | Target page                        | Anchor text                     | Direction |
|---|-----------------------------------|-----------------------------------|---------------------------------|-----------|
| 1 | /blog/email-warmup-schedule       | /guides/email-deliverability      | email deliverability guide      | outbound (to pillar) |
| 2 | /blog/email-warmup-schedule       | /blog/spf-dkim-dmarc-setup        | authenticating your domain      | outbound (sibling) |
| 3 | /blog/email-warmup-schedule       | /product/email-tool               | automate your warmup schedule   | outbound (money page) |
| 4 | /guides/email-deliverability      | /blog/email-warmup-schedule       | domain warmup schedule          | inbound (from pillar) |
| 5 | /blog/new-sending-domain-checklist| /blog/email-warmup-schedule       | how fast to ramp sending volume | inbound (sibling) |

Checks: pillar link up (row 1) - yes. Inbound >= 2 incl. pillar (rows 4-5) - yes.
No repeated exact-match anchors. All URLs from supplied inventory. Depth from home: 2 clicks.

Bad anchor, for contrast: five inbound links all reading "email warmup schedule" verbatim - exact-match repetition that looks manipulative. Good: the varied, descriptive anchors in rows 4-5.

Deliverable

Produce the link map table - source, target, anchor, direction - plus a three-line check block confirming the pillar link, the inbound minimum, anchor variety, and click depth from home.

Do NOT

  • Do not link unrelated pages to inflate link count - volume padding dilutes every real link.
  • Do not repeat one exact-match anchor across many links; vary the phrasing.
  • Do not bury links in footers or sidebars and expect ranking value.
  • Do not orphan the new page by skipping inbound links, and do not settle for a single inbound link.
  • Do not link to thin, noindex, or non-canonical pages.
  • Do not fabricate URLs not present in the supplied inventory.

Quality bar

  • The new page has at least 2-3 inbound internal links, including one from its pillar, and a link up to the pillar.
  • Every anchor is descriptive, natural in-sentence, and no exact-match anchor repeats site-wide.
  • Every link is contextual (in body) and topically justified.
  • The page sits within 3 clicks of the homepage, or the map flags the depth problem with a fix.
  • Output names real URLs from the supplied inventory only.

Neighbors

To design the cluster itself from keywords, use keyword-cluster-builder. For on-page optimization of the linked pages, seo-optimizer. For refreshing a decaying page before re-linking it, content-refresh-auditor.

04 同仓库更多 Skills

SkillMedev
SkillMedev/skills

zone-2-cardio-plan

Use when someone asks to build a steady-state cardio plan, train an aerobic base or Zone 2, structure easy or endurance weekly cardio, train by heart-rate zones, or improve resting heart rate, VO2, or endurance. Builds a heart-rate-zone aerobic training block with session structure, modality choice, and progression. General fitness guidance, not medical advice. Do NOT use to design a strength or lifting program (use Strength Training Plan), high-intensity interval conditioning, HIIT, or circuits (use Conditioning & HIIT Program), or a mobility/flexibility routine (use Mobility Routine).

★ 25
SkillMedev
SkillMedev/skills

youtube-script-writer

Writes retention-engineered long-form YouTube scripts on a hook/body/payoff architecture - a first-30-seconds hook that survives the retention cliff, a beat-sheet body with mini-hooks and bridges, timed pattern interrupts, and a payoff that over-delivers - with B-roll and editing cues marked inline. Use when someone says "script my next video", "my retention graph dies at the start", "tighten this draft", or "outline a video on X". Do NOT use for the 3-second opener of TikTok, Reels, or Shorts - use video-hook-writer instead; do NOT use for spoken voiceover synced to on-screen tutorial actions - use narration-script instead; do NOT use for a sales demo built on a buyer's discovery notes - use demo-script instead; do NOT use to design the thumbnail and title - use thumbnail-concept instead.

★ 25
SkillMedev
SkillMedev/skills

win-back-campaign

Designs segmented win-back email sequences for dormant users - dormancy tiers, a three-beat sequence with a single proportional incentive, and a suppression rule - and measures success by re-activation, not opens. Use when someone says "our users went quiet", "design a win-back campaign", "how do I re-engage lapsed customers", "should we email people who haven't logged in for months", or lifecycle messaging has stopped landing with a lapsed segment. Do NOT use for recovering an unfinished checkout - use abandoned-cart-sequence instead. Do NOT use for diagnosing and fixing why active customers cancel - use churn-reduction instead. Do NOT use for building always-on onboarding or nurture flows - use email-drip-builder instead.

★ 25
SkillMedev
SkillMedev/skills

wikipedia-style

Writes neutral, verifiable, encyclopedic prose following Wikipedia's core content policies and manual of style - NPOV, inline citations, notability-backed claims, and a strict ban on promotional language. Use when someone asks "write this like a Wikipedia article", "draft a Wikipedia page for this company or person", "make this neutral and encyclopedic", or "why does my article draft keep getting rejected". Do NOT use for persuasive or opinion writing - use op-ed-writer instead; for thesis-driven academic papers, use academic-essay; for verifying claims in existing text, use fact-checker.

★ 25
SkillMedev
SkillMedev/skills

whitepapers

Structures and writes authoritative B2B whitepapers - a standalone executive summary, a data-sized problem statement, methodology, evidence-driven findings, recommendations, and a soft call to action - flagging every claim that needs a real citation. Use when a marketer asks "write a whitepaper on this topic", "turn our research into a lead-gen asset", "make this credible enough for executives", or a draft reads like a product pitch instead of analysis. Do NOT use for customer-story-driven proof - use case-study-builder instead; for policy audiences, use policy-brief.

★ 25
SkillMedev
SkillMedev/skills

white-space-analysis

Finds unmet market gaps by ranking jobs-to-be-done on importance versus satisfaction, overlaying them against current solutions and workarounds, and validating that each gap is real, winnable, and worth winning. Use when someone asks "where are the gaps in this market", "what's underserved here", "where should we play next", or is hunting for product, feature, or market-entry opportunities. Do NOT use for profiling competitors and building battle cards - use competitive-intelligence instead; for putting a dollar figure on an identified opportunity - use market-sizing instead; for extracting jobs-to-be-done from raw customer interviews - use jtbd-extractor instead.

★ 25