Orphan Pages Internal Linking Opportunities
Find blog and content URLs with zero internal links and get three paste-ready linking suggestions per orphan in an HTML audit report.
Overview
orphan-pages-internal-linking-opportunities is an agent skill most often used in Launch (also Grow) that finds zero-inlink content pages and outputs three specific internal linking fixes per orphan.
Install
npx skills add https://github.com/infrasity-labs/dev-gtm-claude-skills --skill orphan-pages-internal-linking-opportunitiesWhat is this skill?
- Discovers content URLs via sitemap and flags zero incoming internal links (Ahrefs)
- Clusters orphan pages by topic and derives keywords per URL
- Generates 3 linking suggestions per orphan with anchor text, placement, and copy-paste context
- Outputs a styled filterable HTML report for client or team delivery
- Built for SEO, content, and dev-marketing teams fixing navigation gaps in growing libraries
- 3 specific linking suggestions per orphan page
Adoption & trust: 1 installs on skills.sh; 24 GitHub stars; trending (+100% hot-view momentum).
What problem does it solve?
You publish content that nothing on your site links to, so users and crawlers cannot reach it through normal navigation.
Who is it for?
Founders or small SEO/content teams with a sitemap, Ahrefs access, and a growing blog or docs library.
Skip if: Sites without a content sitemap, teams without inbound-link data tooling, or purely single-page marketing sites.
When should I use this skill?
User needs orphan page discovery, internal linking opportunity audits, or HTML reports for content sections with missing inbound internal links.
What do I get? / Deliverables
You receive a filterable HTML report listing every orphan with topic clusters and three ready-to-implement internal links including anchor and placement guidance.
- Filterable HTML orphan-page report
- Per-orphan anchor and placement recommendations
- Topic clusters for orphaned URLs
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Orphan fixes matter most when you are trying to get discovered—launch SEO is the canonical shelf for internal linking structure. The skill is an SEO technical audit focused on internal links, anchors, and crawl paths—not product coding.
Where it fits
Before a launch week, wire new tutorial posts into pillar pages so crawlers find them.
Quarterly pass to link orphaned case studies from related product docs and changelog posts.
Pair fixed internal paths with distribution—ensure landing hubs expose posts you promote on social.
How it compares
Use for orphan-specific internal link briefs instead of generic ‘write more backlinks’ SEO chat advice.
Common Questions / FAQ
Who is orphan-pages-internal-linking-opportunities for?
Solo builders, SEO leads, and dev-marketing teams who need a concrete internal linking audit deliverable, not a vague content strategy memo.
When should I use orphan-pages-internal-linking-opportunities?
At Launch when tightening site architecture before a push, and during Grow when new posts are not wired into hubs—after you have a sitemap and link data available.
Is orphan-pages-internal-linking-opportunities safe to install?
It implies sitemap and third-party SEO API usage; review the Security Audits panel on this page and scope API keys to read-only site analytics where possible.
SKILL.md
READMESKILL.md - Orphan Pages Internal Linking Opportunities
# Orphan Pages: Internal Linking Opportunities Discovers every blog or content page that receives zero incoming internal links, clusters them by topic, and generates 3 specific linking suggestions per orphan, with exact anchor text, placement guidance, and ready-to-paste context copy. Outputs a styled, filterable HTML report. --- ## What this skill does An **orphan page** is a page that no other page on the site links to. It cannot be discovered through normal navigation and is invisible to crawlers following internal links. This audit finds every orphan in a content section and recommends exactly which existing pages should link to each one. The skill discovers all content pages via sitemap, identifies which have incoming links using Ahrefs, derives keywords for each orphan, clusters pages by topic, and generates 3 fully formed linking suggestions per orphan, including the anchor text to use, where in the source page to place the link, and a sentence ready to copy and paste. Built for: - **SEO and content teams** finding pages that are being published but never surfaced through navigation - **Developer marketing** fixing structural link gaps across a growing content library - **Agencies** delivering an internal linking audit as a client deliverable --- ## Installation ### Claude Code (Recommended) Clone the repo. The skill activates automatically when you open it in Claude Code: ```bash git clone https://github.com/Infrasity-Labs/dev-gtm-claude-skills.git cd dev-gtm-claude-skills claude ``` Then trigger it with: ``` /dev-gtm orphan-pages example.com/blog/ ``` Or describe what you want. Claude activates the skill when you provide a domain and ask for an orphan page audit or internal linking report. ### Claude Web (Free / Pro) 1. Go to **[Settings → Capabilities](https://claude.ai/settings/capabilities)** and enable **Code execution and file creation** 2. Go to **[Customize → Skills](https://claude.ai/customize/skills)** 3. Click **+** → **Create skill** → **Upload a skill** 4. Zip this skill folder and upload it: ```bash cd dev-gtm-claude-skills/skills/orphan-pages-internal-linking-opportunities zip -r ../orphan-pages-internal-linking-opportunities.zip . ``` Upload `orphan-pages-internal-linking-opportunities.zip` and toggle it on. --- ## Ahrefs Setup (Required) This skill uses two Ahrefs tools to identify orphan pages and fetch keyword data. An active Ahrefs account with API access is required. ### Claude Code Open `.claude/settings.json` in the cloned repo and add your Ahrefs MCP credentials: ```json { "mcpServers": { "Ahrefs": { "command": "npx", "args": ["-y", "@ahrefs/mcp-server"], "env": { "AHREFS_API_KEY": "your-ahrefs-api-key" } } } } ``` ### Claude Web (Free / Pro) Go to **[Settings → Integrations](https://claude.ai/settings/integrations)**, find **Ahrefs**, and connect your account. --- ## How to use ``` Run an orphan page audit for example.com ``` ``` Which pages on example.com/blog/ have no internal links? ``` ``` Find pages nobody links to on my site ``` ``` /dev-gtm orphan-pages example.com/blog/ ``` If the content section prefix (`/blog/`, `/articles/`, etc.) is not clear from the input, Claude asks before starting. --- ## Inputs | Field | Required | Notes | |-------|----------|-------| | Domain or URL | ✅ | Domain (`example.com`), full URL, sitemap URL, or blog prefix URL | | Content prefix | ⬜ | Optional. If not provided and not inferrable from the URL, Claude asks | --- ## Output A self-contained filterable HTML report saved to `/mnt/user-data/outputs/[domain]-orphan-linking-audit.html` and presented with a download link. The report contains: - **Header stats**: Total Pages, Orphan Count, Pages With Links, Gap Rate %, Total Suggestions - **Cluster sidebar**: topic clusters built automatically from the orphan set, clickable for filtering - **Search and filter bar**: live search across all orphan titles and keywords - **Per-orph