agentleFS
DariuszCiesielskiDariuszCiesielski/polish-agent-skills/skills/seo/internal-linker/SKILL.md

internal-linker

Skill2 starsChanged 7 months agoMITView on GitHub

Optymalizacja linków wewnętrznych — link equity distribution, topic cluster linking, cannibalization prevention, orphan page detection. Triggery: "linki wewnętrzne", "internal linking", "link equity", "orphan pages", "cannibalization", "zoptymalizuj linkowanie", "mapa linków", "internal link audit".

The file

Files
SKILL.md

Internal Linker — Link Equity & Topic Cluster Optimization

Audytuje i optymalizuje strukturę linków wewnętrznych w projekcie. Wykrywa orphan pages, cannibalization, złe anchor texty i nierównomierne rozkłady link equity.

Kiedy używać

  • Strona ma >20 podstron i brak strategii linkowania
  • Blog rośnie ale artykuły nie linkują do siebie
  • Nowe strony nie dostają organic traffic (orphan pages)
  • Podejrzenie keyword cannibalization
  • Użytkownik mówi: "linki wewnętrzne", "orphan pages", "internal link audit"

Komendy

/internal-linker audit          — pełny audyt linków wewnętrznych
/internal-linker orphans        — wykryj orphan pages (0 linków przychodzących)
/internal-linker cannibalization — wykryj keyword cannibalization
/internal-linker suggest <url>  — zaproponuj linki dla konkretnej strony
/internal-linker map            — wygeneruj mapę linków (visual)

Proces audytu

Krok 1: Skan struktury

Przeskanuj projekt i zbuduj graf linków:

Dla każdej strony (page.tsx, post.md, etc.):
  1. URL strony
  2. H1 / title
  3. Target keyword (z meta/frontmatter)
  4. Linki wychodzące (internal) — URL + anchor text
  5. Word count

Krok 2: Zbuduj macierz

| Strona | Linki IN | Linki OUT | Keyword | Orphan? |
|--------|----------|-----------|---------|---------|
| / | 15 | 8 | [brand] | — |
| /blog/art-1 | 0 | 2 | [kw1] | ⚠️ TAK |
| /features | 5 | 3 | [kw2] | — |
| /pricing | 3 | 1 | pricing | — |

Krok 3: Diagnoza

A. Orphan Pages (0 linków IN)

Problem: Google nie może znaleźć strony jeśli żaden link do niej nie prowadzi. Fix: Dodaj min. 3 linki z powiązanych stron.

B. Link Equity Imbalance

Problem: Homepage ma 50 linków IN, blog post 0. Fix: Linkuj z high-authority pages do ważnych stron docelowych.

Reguła dystrybucji:

Homepage → /features, /pricing, /blog (top 3 artykuły)
Pillar page → wszystkie supporting articles
Supporting article → pillar + 2 inne supporting + /features lub /pricing
Feature page → case study + blog post o feature + /pricing

C. Keyword Cannibalization

Problem: 2+ strony targetują ten sam keyword → Google nie wie którą wybrać. Wykrywanie:

Dla każdego keyword:
  Jeśli >1 strona ma go w H1/title → CANNIBALIZATION

Fix opcje:

  1. Merge — połącz 2 strony w jedną (301 redirect ze słabszej)
  2. Differentiate — zmień keyword jednej strony na bardziej specyficzny
  3. Canonical — wskaż canonical na silniejszą stronę

D. Anchor Text Issues

Problem: "kliknij tutaj", "więcej", "link" — zero wartości SEO.

Reguły anchor text:

Dobrze ✓Źle ✗
"strategia content marketing""kliknij tutaj"
"cennik [Produktu]""więcej"
"jak zoptymalizować SEO""ten artykuł"

Zasada: Anchor text = keyword docelowej strony (naturalnie, nie stuffing).

Krok 4: Rekomendacje

Dla każdego problemu wygeneruj konkretną akcję:

## Rekomendacje

### Orphan Pages (3 znalezione)
1. `/blog/artykul-o-seo` — dodaj link z:
   - `/blog/pillar-seo` (anchor: "optymalizacja SEO")
   - `/features/seo-tools` (anchor: "nasze narzędzia SEO")
   - `/` homepage sidebar/footer

### Cannibalization (1 para)
- `/blog/crm-guide` i `/features/crm` oba targetują "CRM"
  → Zmień `/blog/crm-guide` keyword na "jak wybrać CRM dla małej firmy"

### Brakujące linki (5 sugestii)
| Z | Do | Anchor text |
|---|-----|------------|
| /blog/art-1 | /features/X | "funkcja X" |
| /blog/art-2 | /pricing | "sprawdź cennik" |

Reguły linkowania wg typu strony

Homepage

  • Linkuj do: /features, /pricing, /blog (top 3), /about
  • NIE linkuj do: każdego blog posta (rozwadnia equity)

Pillar Page (blog)

  • Linkuj do: WSZYSTKICH supporting articles w clusterze
  • Linkuj do: /features (relevant), /pricing
  • Supporting articles ZAWSZE linkują z powrotem do pillar

Supporting Article (blog)

  • Linkuj do: pillar page (obowiązkowo)
  • Linkuj do: 2-3 inne supporting z tego samego clustera
  • Linkuj do: 1 strona komercyjna (/features, /pricing)
  • Min. 3 linki wewnętrzne, max 10

Feature Page

  • Linkuj do: case study, blog posts o feature, /pricing
  • Linkuj do: powiązane feature pages

Pricing Page

  • Linkuj do: /features (per plan), FAQ, /contact
  • NIE linkuj do: zewnętrznych konkurentów

Format raportu

# Internal Link Audit — [Domena]
Data: [YYYY-MM-DD]

## Podsumowanie
- Stron przeskanowanych: X
- Orphan pages: Y (⚠️ jeśli >0)
- Cannibalization: Z par
- Avg. linków IN per strona: N
- Avg. linków OUT per strona: M

## Orphan Pages
[Lista z fix suggestions]

## Cannibalization
[Lista par z fix suggestions]

## Top rekomendacje (posortowane wg impact)
1. [Akcja 1]
2. [Akcja 2]
3. [Akcja 3]

## Mapa linków
[ASCII/Mermaid diagram struktury]

Cross-references

  • seo → /seo page sprawdza linki wewnętrzne per strona
  • content-strategy → topic clusters definiują strukturę linkowania
  • product-marketing-context → internal-links-map.md jako cel
  • programmatic-seo → generated pages potrzebują strategii linkowania

Pułapki

  • Nie linkuj do wszystkiego ze wszystkiego — rozmywa link equity
  • Nie używaj nofollow na linkach wewnętrznych — marnujesz equity
  • Anchor text variation — nie zawsze dokładnie ten sam keyword, Google może uznać za manipulację
  • Aktualizuj regularnie — nowe artykuły = nowe linki do dodania do starych stron
  • Footer links — linki w footerze mają mniejszą wagę niż in-content links

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.