internal-linking

Analyze internal link structure of AEM Edge Delivery Services sites and generate linking recommendations.

1|Updated Jun 22, 2026
One-click install
npx skills add https://github.com/aemgdc/aemdev --skill internal-linking-aemgdc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: internal-linking
Source: https://github.com/aemgdc/aemdev/tree/main/.agents/skills/internal-linking
Command: npx skills add https://github.com/aemgdc/aemdev --skill internal-linking-aemgdc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Internal link audits are tedious: orphan pages go unnoticed, content silos stay isolated, and link equity is distributed unevenly. This Skill automates the full audit by crawling an AEM Edge Delivery Services site's query index and page content, building a complete link graph, and producing prioritized, actionable recommendations. ## Core Features & Use Cases - Link Graph Construction: Fetches the query index and .plain.html content for every page, extracts and classifies internal links (body contextual, block, CTA, structural nav/footer), and builds a directed graph of inbound and outbound links. - Orphan, Hub, and Silo Detection: Identifies pages with zero inbound body links, hub pages with above-average outbound links, and isolated content silos with a silo ratio score. - Specific Recommendations: Generates prioritized recommendations (Critical/High/Medium/Low) with the exact source page, placement, suggested anchor text, and rationale. - Use Case: After a content migration to AEM Edge Delivery Services, run the audit to find pages that lost all inbound links and get concrete suggestions for restoring their visibility. ## Quick Start Analyze the internal link structure of my AEM site at example.com and give me a report of orphan pages and linking recommendations.

Frequently Asked Questions about internal-linking

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find orphan pages on my AEM Edge Delivery Services site?▼

Fetch the site's query-index.json to build a page inventory, then extract internal links from each page's .plain.html content. Pages with zero inbound body links are orphans; those also missing from nav and footer are critical priority.

How to audit internal links for SEO on an EDS website?▼

Build a directed link graph from the query index and page content, then compute inbound and outbound link counts per page. Analyze orphan pages, hub pages, content silos, and link distribution, then generate prioritized recommendations with suggested anchor text.

What is a content silo and how do I detect one?▼

A content silo is a cluster of pages that link heavily to each other but rarely to other clusters. Compute each cluster's silo ratio (internal links divided by total links); a ratio above 0.8 indicates isolation that needs cross-silo bridge links.

Does this work on non-AEM or non-EDS websites?▼

No, the workflow depends on EDS-specific endpoints: the query-index.json for page inventory and .plain.html variants for content extraction. It is also not intended for external backlink auditing or broken link checking.

What are the limitations for large sites?▼

Sites with 500 or more unscoped pages are not recommended. Filter the query index to a path prefix such as /blog/, or sample a representative subset, and batch page fetches in groups of 10 to 20.

Why does the query index return a 404 error?▼

The site may not expose a query index or may use a different path. Try /query-index.json?limit=500, and ask the site owner whether a custom index configuration is in use.