seo-aeo-internal-linking
Maps internal link opportunities between pages with anchor text, placement instructions, orphan page detection, and cannibalization checks. Activate when the user wants to build an internal linking strategy or find link opportunities.
What this skill does
# SEO-AEO Internal Linking ## Overview Analyses a set of pages and produces a prioritised list of internal link opportunities with exact anchor text, a context sentence showing where each link should appear, orphan page detection, anchor text cannibalization warnings, and a link equity map showing how authority flows across the content. Part of the [SEO-AEO Engine](https://github.com/mrprewsh/seo-aeo-engine). ## When to Use This Skill - Use when building internal links between a new pillar page and its cluster articles - Use when auditing an existing site for orphan pages - Use after content-cluster generates a topic map - Use when you need anchor text suggestions with placement context ## How It Works ### Step 1: Detect Orphan Pages Flag any page with zero incoming internal links. These are invisible to search engines and must be linked immediately. ### Step 2: Build Semantic Overlap Matrix Match pages by primary keyword similarity and content summary to identify natural linking opportunities. ### Step 3: Assign Link Types Every suggestion gets one of four labels: - **Cluster → Pillar** — highest priority, consolidates authority upward - **Pillar → Cluster** — distributes authority downward - **Cluster → Cluster** — builds semantic depth - **Contextual Boost** — concentrates equity on a focus page ### Step 4: Write Context Sentences For every link opportunity, write the sentence the anchor text should appear in — naturally placed, not forced. ### Step 5: Check Anchor Text Flag any exact-match anchor used more than once for the same target page as a cannibalization risk. Never use generic anchors like "click here". ## Examples ### Example: Link Opportunity Output 🔴 High Priority — Link 1 Type: Cluster → Pillar Source: "How to Build a Budget That Actually Works" Target: "The Complete Guide to Automated Budgeting" Anchor: "automated budgeting guide" Context: "For a full breakdown of every method available, see our [automated budgeting guide]." Impact: Consolidates topical authority on pillar page. Orphan Alert: "PennyWise Pricing Page" has no incoming links. Fix: Add link from comparison table in Article 2. ## Best Practices - ✅ **Do:** Every cluster article must have at least one Cluster → Pillar link - ✅ **Do:** Write a context sentence for every suggestion — anchor text needs natural placement - ✅ **Do:** Fix orphan pages before adding any new links - ❌ **Don't:** Use the same exact-match anchor for the same target page more than once - ❌ **Don't:** Use "click here", "read more", or "learn more" as anchor text — ever - ❌ **Don't:** Add more than 100 outgoing internal links on any single page ## Common Pitfalls - **Problem:** All cluster articles link to the pillar but not to each other **Solution:** Add Cluster → Cluster links between semantically related articles to build depth. - **Problem:** Same anchor text used across multiple pages for the same target **Solution:** Use partial match and branded anchors for subsequent links after the first exact-match use. ## Related Skills - `@seo-aeo-content-cluster` — generates the cluster map this skill links together - `@seo-aeo-schema-generator` — uses link map output for BreadcrumbList schema ## Additional Resources - [SEO-AEO Engine Repository](https://github.com/mrprewsh/seo-aeo-engine) - [Full Internal Linking SKILL.md](https://github.com/mrprewsh/seo-aeo-engine/blob/main/.agent/skills/internal-linking/SKILL.md) ## Limitations - Use this skill only when the task clearly matches the scope described above. - Do not treat the output as a substitute for environment-specific validation, testing, or expert review. - Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
Related in Ads & Marketing
ads
IncludedMulti-platform paid advertising audit and optimization skill. Analyzes Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, and Apple Ads. 250+ checks with scoring, parallel agents, industry templates, and AI creative generation.
banana
IncludedAI image generation Creative Director powered by Google Gemini Nano Banana models. Use this skill for ANY request involving image creation, editing, visual asset production, or creative direction. Triggers on: generate an image, create a photo, edit this picture, design a logo, make a banner, visual for my anything, and all /banana commands. Handles text-to-image, image editing, multi-turn creative sessions, batch workflows, and brand presets.
rpg-migration-analyzer
IncludedAnalyzes legacy RPG (Report Program Generator) programs from AS/400 and IBM i systems for migration to modern Java applications. Extracts business logic from RPG III/IV/ILE source code, identifies data structures (D-specs), file operations (F-specs), program dependencies (CALLB/CALLP), and converts RPG constructs to Java equivalents. Generates migration reports, complexity estimates, and Java implementation strategies with POJO classes, JPA entities, and service methods. Use when modernizing AS/400 or IBM i legacy systems, analyzing RPG source files (.rpg, .rpgle, .RPGLE), converting RPG to Java, mapping data specifications to Java classes, planning legacy system migration, or when user mentions RPG analysis, Report Program Generator, RPG III/IV/ILE, AS/400 modernization, IBM i migration, packed decimal conversion, or mainframe application rewrite.
brand-library-architect
IncludedBuild a complete brand library for a product — visual asset render pipeline, brand documentation set (BRAND, COPY, MANIFESTO, BIOS, FAQ, GLOSSARY, TONE, PRICING), open-source convention files (README, CONTRIBUTING, SECURITY, CODE_OF_CONDUCT), and a self-contained press kit. This skill should be used when the user asks to "build a brand library / brand kit / press kit / brand assets" for a product, "set up a brand library workflow," "create a positioning manifesto plus visual identity," or any combination of brand documentation + visual asset pipeline. Apply phase-by-phase or run end-to-end. Templates are product-agnostic and use {{TOKEN}} placeholders the skill prompts the user to fill.
writing-tech-post
IncludedAuthors engineering blog posts end-to-end: launch deep-dives, incident postmortems, architecture migrations, performance case studies, tutorials, AI/agent system writeups, security disclosures, and research-to-product translations. Picks the correct archetype, plans the abstraction ladder, enforces an evidence cadence (diagrams, benchmarks, profiles, traces, code, ablations), tunes voice against publisher house styles (Datadog, Vercel, GitHub, AWS, Meta, Cloudflare, Jane Street), and runs a pre-publish gate for narrative momentum and disclosure ethics. Use when drafting a new engineering post, restructuring a draft that feels flat, deciding which evidence form belongs where, validating that depth and product context are balanced, or preparing a postmortem, migration, or performance narrative for external publication. Do not use for API reference documentation, README authoring, marketing copy, release notes, generic SEO content, ghost-written executive thought leadership, or non-engineering long-form essays.
blog-google
IncludedGoogle API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity analysis for E-E-A-T, YouTube video search for embedding, and Google Ads Keyword Planner. Progressive feature availability based on credential tier (API key, OAuth/service account, GA4, Ads). Shares config with claude-seo at ~/.config/claude-seo/google-api.json. Use when user says "google data", "page speed", "core web vitals", "search console", "indexation", "GA4", "keyword research", "nlp entities", "blog performance", "youtube search", "google api setup".