Internal Links
- 813 installs
- 787 repo stars
- Updated June 9, 2026
- kostja94/marketing-skills
internal-links is a marketing-skills SEO skill (v1.0.1) that generates internal linking recommendations to improve crawlability, distribute link equity, and eliminate orphan pages on developer-built sites.
About
internal-links is version 1.0.1 in kostja94/marketing-skills and guides on-page internal linking strategy for SEO and navigation. It assesses site structure, identifies orphan pages with few inbound links, and recommends hub-to-spoke links from pillar content to cluster articles with descriptive anchor text. The skill advises keeping important pages within three clicks of the homepage and placing contextual body links instead of footer-only links. Developers invoke it when users mention internal links, anchor text, link equity, orphan pages, or internal linking strategy. It reads .claude/project-context.md or .cursor/project-context.md when present for site-specific guidance.
- Analyzes site structure, hub pages, pillar content and orphan pages
- Recommends contextual internal links with descriptive anchor text
- Ensures important pages are reachable within 3 clicks from homepage
- Reads project-context.md to understand existing site architecture
- Provides internal linking strategy for SEO and user navigation
Internal Links by the numbers
- 813 all-time installs (skills.sh)
- +6 installs in the week ending Jul 29, 2026 (Skillselion tracking)
- Ranked #544 of 1,879 Marketing & SEO skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Jul 31, 2026 (Skillselion catalog sync)
npx skills add https://github.com/kostja94/marketing-skills --skill internal-linksAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 813 |
|---|---|
| repo stars | ★ 787 |
| Security audit | 3 / 3 scanners passed |
| Last updated | June 9, 2026 |
| Repository | kostja94/marketing-skills ↗ |
How do you fix orphan pages with internal links?
Generate smart internal linking recommendations that improve crawlability, distribute link equity, and reduce orphan pages.
Who is it for?
Developers optimizing site architecture who need actionable internal link recommendations for crawlability and link equity distribution.
Skip if: Skip internal-links when the task is information architecture sitemap design without SEO link-equity goals—use website-structure instead.
When should I use this skill?
User mentions internal links, internal linking strategy, anchor text, link equity, or orphan pages.
What you get
Internal linking recommendations, orphan-page fixes, hub-to-spoke link map, and anchor-text guidance for priority URLs
- internal linking recommendations
- orphan page list
- anchor text guidance
By the numbers
- Skill version 1.0.1 in kostja94/marketing-skills
- Recommends priority pages within 3 clicks of homepage
Files
SEO On-Page: Internal Links
Guides internal linking strategy for SEO: crawlability, link equity distribution, and user navigation.
When invoking: On first use, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output.
Scope (On-Page SEO)
- Internal links: Contextual links; descriptive anchor text; related posts; hub pages
- Breadcrumbs: Implement for large sites (e.g. ecommerce); see breadcrumb-generator
Initial Assessment
Check for project context first: If .claude/project-context.md or .cursor/project-context.md exists, read it for site structure and key pages.
Identify: 1. Site structure: Hub pages, pillar content, supporting pages 2. Orphan pages: Pages with no or few internal links 3. Priority pages: Pages that need more link equity
Best Practices
Link Structure
| Principle | Guideline |
|---|---|
| Depth | Important pages within 3 clicks from homepage |
| Orphan pages | Avoid; ensure every page has at least one internal link; see site-crawlability for technical detection and crawl issues |
| Hub-to-spoke | Link from hub/pillar pages to cluster articles; topic cluster structure |
| Contextual | Place links in relevant body content, not just footers |
Anchor Text
| Principle | Guideline |
|---|---|
| Descriptive | Use anchor text that describes the target page |
| Variation | Avoid over-optimization; use natural variation |
| Keyword | Include target keyword when natural |
Placement
| Location | Use |
|---|---|
| First paragraph | Primary link to related content |
| Body | Contextual links throughout |
| Related/Recommended | End-of-article links |
| Navigation | Key site sections |
Common Issues
| Issue | Fix |
|---|---|
| Orphan pages | Add internal links from hub pages or navigation; site-crawlability for technical audit |
| Too many links | Focus on most important; avoid link stuffing |
| Generic anchors | Use descriptive "learn more about X" instead of "click here" |
| Broken links | Audit and fix 404s; see site-crawlability for technical audit |
Output Format
- Internal link audit (if auditing)
- Link opportunities for key pages
- Anchor text recommendations
- Structure improvements
Related Skills
- article-page-generator: Related posts, contextual links, end-of-article recommendations
- website-structure: Plan page structure and hierarchy; informs internal linking
- site-crawlability: Internal links enable crawling
- url-structure: URL structure affects link patterns
- content-strategy: Topic clusters inform link structure; pillar <-> cluster; cluster <-> cluster
- breadcrumb-generator: Breadcrumbs are internal links; category hierarchy
Related skills
Seo AuditRun structured SEO audits on their SaaS site or content hub and receive a prioritized action plan.173k42.2kCopywritingGenerate, rewrite, or strengthen persuasive website and landing-page copy that converts visitors into users.164k42.2k
Viral Short FormQuickly generate high-retention hooks, scripts, and outlines for TikTok, Reels, YouTube Shorts, and carousels.132k67Viral HooksWrite and critique viral hooks for short-form video opening sequences.123k67Viral Captions And CtasOptimize social media captions and CTAs for viral short-form video reach and saves.123k67Viral Youtube ShortsWrite and diagnose YouTube Shorts for Shorts Feed and long-form funnel.123k67How it compares
Use internal-links for SEO link-equity strategy; use website-structure when the primary goal is information architecture, not link distribution.
FAQ
What orphan-page rule does internal-links recommend?
internal-links advises that every page should have at least one internal link and flags orphan pages with no or few inbound links. It pairs with site-crawlability for technical detection of unreachable URLs.
How deep should priority pages be in internal-links guidance?
internal-links recommends keeping important pages within three clicks from the homepage and placing contextual links in body content rather than relying only on footer navigation for discovery.
Is Internal Links safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.