wiki-cross-link

Detects and inserts missing wikilinks between Obsidian vault pages with typed relationships.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/phm-aguiar/test_documentacao --skill wiki-cross-link-phm-aguiar
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wiki-cross-link
Source: https://github.com/phm-aguiar/test_documentacao/tree/main/.claude/skills/wiki-cross-link
Command: npx skills add https://github.com/phm-aguiar/test_documentacao --skill wiki-cross-link-phm-aguiar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Pages in an Obsidian vault often fail to reference each other, leaving the knowledge graph fragmented and new pages orphaned after ingestion. This Skill scans the vault, finds unlinked mentions of existing pages, and inserts the missing [[wikilinks]] automatically. ## Core Features & Use Cases - Missing Link Detection: Builds a page registry from frontmatter (titles, aliases, tags) and scans page bodies for unlinked mentions using case- and diacritic-insensitive matching. - Confidence Scoring: Ranks candidates as EXTRACTED, INFERRED, or AMBIGUOUS based on signals like exact name matches, shared tags, and hub/peripheral link counts, acting only on confident suggestions. - Typed Relationships: Infers semantic relationship types (extends, implements, uses, derived_from, etc.) from sentence context and writes them to a relationships frontmatter block. - Use Case: After ingesting a batch of new notes, run the Skill to weave them into the existing graph, update misc/ page affinity scores, and receive a report of links added, orphans remaining, and promotion candidates. ## Quick Start Ask the assistant to link your pages by saying "find missing links in my Obsidian wiki and connect pages that should reference each other".

Frequently Asked Questions about wiki-cross-link

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

FAQPage Schema
How do I find missing links between Obsidian notes?▼

Run the cross-linking pass, which builds a registry of page titles, aliases, and tags from frontmatter, then scans each page body for unlinked mentions. Candidates are scored and only confident matches are wrapped in [[wikilinks]].

How does automatic wikilink insertion avoid false positives?▼

Each candidate link receives a confidence score from signals like exact name matches, shared tags, and hub reach. Only EXTRACTED (score 6+) and INFERRED (3-5) candidates are applied; AMBIGUOUS ones are skipped unless requested.

Does it support markdown links instead of wikilinks?▼

Yes, the OBSIDIAN_LINK_FORMAT config value controls body link format, with relative .md paths computed when set to markdown. Frontmatter relationship targets always use wikilink syntax regardless of this setting.

Can it add typed relationships to Obsidian frontmatter?▼

Yes, it infers relationship types like extends, implements, uses, or derived_from from the sentence surrounding each inserted link. These are appended to the page's relationships YAML block without duplicating existing targets.

What are the limitations of automated wiki cross-linking?▼

It skips pages in _archives/, avoids linking inside code blocks and frontmatter, and only links the first natural mention of a term. Pages with no textual or tag overlap remain orphans and are reported rather than force-linked.