skills.rest
Thedougler
ThedouglerCOMMUNITY
Explore all skills by this author →
GitHub

cross-linker

Adds missing wikilinks between Obsidian vault pages to resolve orphans and deadends.

Updated May 29, 2026
Search Tags:#markdown#knowledge graph#obsidian#wiki maintenance#cross-reference#wikilinks#orphan pages
One-click install
npx skills add https://github.com/Thedougler/shattered-sea-wiki --skill cross-linker-thedougler
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cross-linker
Source: https://github.com/Thedougler/shattered-sea-wiki/tree/main/.claude/skills/cross-linker
Command: npx skills add https://github.com/Thedougler/shattered-sea-wiki --skill cross-linker-thedougler

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Wiki pages in an Obsidian vault often reference each other in prose without actual wikilinks, leaving orphan pages (no inbound links) and deadend pages (no outbound links) invisible to the knowledge graph. This Skill finds and fixes those missing cross-references in targeted batches. ## Core Features & Use Cases - Orphan Resolution: Searches the vault for text mentions of unlinked pages and wraps the first natural mention in an aliased wikilink. - Deadend Resolution: Reads linkless pages, matches mentioned entity names against the wiki index, and adds outbound links or a Related section. - Batch Triage: Pulls orphan/deadend reports from the wiki-lint command, prioritizes 15-25 targets per run, commits changes to git, and reports a summary. - Use Case: After ingesting new session notes into a campaign wiki, run this Skill to weave the newly created NPC and location pages into the existing link graph. ## Quick Start Ask the agent to find missing links and cross-reference the orphan and deadend pages reported by wiki-lint.

Frequently Asked Questions about cross-linker

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

FAQPage Schema
How do I find and fix orphan pages in an Obsidian vault?▼

Run the wiki-lint command and filter for orphan and deadend reports to get a target list. For each orphan, grep the vault for text mentions of the entity name and wrap the first natural mention in an aliased wikilink like [[slug|Display Name]].

How to add cross-references between markdown wiki pages automatically?▼

Read the page body for unlinked entity names, check each against the wiki index for a matching slug, and wrap the first mention per section. When no prose mention exists, add a Related section linking semantically connected pages.

What is the difference between orphan and deadend wiki pages?▼

Orphan pages have no inbound links, making them invisible to the link graph, while deadend pages have inbound links but link to nothing else. Orphans are prioritized because they cannot be discovered through navigation.

Which pages should be excluded when adding wikilinks?▼

Exclude system directories like wiki/system, wiki/dm, and wiki/rules, plus agent-facing files such as index.md, hot.md, and log.md. Duplicate or broken files with spaces or " 2.md" suffixes should also be skipped.

Why does cross-linking fail on some wiki pages?▼

Stat-block-only creature pages have no prose to link inline, so they need a Related section fallback. Accented entity names may also be missed by grep unless you search both accented and stripped forms.

Related Skills

Explore More Content & Communication Skills→
NirajkashyapNirajkashyap

wiki-ingest

Ingest documents into an Obsidian wiki as interconnected wiki pages.

Community
Advanced
pax-kpax-k
6

daily-update

Run the daily wiki maintenance cycle for freshness, index, and hot.md.

Community
Intermediate
mifunedevmifunedev
28

wiki-lint

Parse frontmatter and analyze inbound links to detect stale, deprecated, orphaned, and broken-link wiki entries.

Official
Advanced
samuelcastrosamuelcastro

cross-linker

Find and insert missing wikilinks across an Obsidian vault.

Community
Advanced