cross-linker

Scan Obsidian vaults and insert high-confidence wikilinks between pages.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/Nero-kk/claude-agent-skills --skill cross-linker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cross-linker
Source: https://github.com/Nero-kk/claude-agent-skills/tree/main/claude-skills/cross-linker
Command: npx skills add https://github.com/Nero-kk/claude-agent-skills --skill cross-linker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The cross-linker removes the manual burden of discovering and inserting missing internal links across an Obsidian wiki so the knowledge graph becomes more connected, discoverable, and maintainable.

Core Features & Use Cases

  • Registry-first scanning: Build a vocabulary from frontmatter titles, filenames, aliases, tags, and summaries to limit costly full-file reads.
  • Unlinked mention detection: Detect mentions of page names, titles, and aliases in body text while skipping frontmatter and code blocks.
  • Scoring and safe application: Rank candidates with a composite scoring heuristic, label matches as EXTRACTED, INFERRED, or AMBIGUOUS, and only apply EXTRACTED and INFERRED links as inline links or to a Related section.
  • Respectful editing and logging: Only link the first natural mention, avoid double-linking, skip immutable raw files, and append a concise entry to the log for auditing.
  • Use Case: Run after a large ingest to quickly weave new pages into existing hubs and reduce orphan pages without blindly reading the entire vault.

Quick Start

Link my pages by scanning the Obsidian vault, adding high-confidence wikilinks, and summarizing the changes in a cross-link report.

Frequently Asked Questions about cross-linker

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

FAQPage Schema
How do I automatically add missing wikilinks in an Obsidian vault?

To automatically add missing wikilinks in an Obsidian vault, use a cross-linker tool that scans page names, titles, and aliases to detect unlinked mentions and insert high-confidence inline links.

What is the best way to fix orphan pages and remediate an Obsidian knowledge graph?

The best way to fix orphan pages and remediate an Obsidian knowledge graph is to run a cross-linker that performs case-insensitive alias matching to weave isolated pages into existing content hubs.

Can I safely automate Obsidian cross-linking without breaking frontmatter or code blocks?

Yes, you can safely automate Obsidian cross-linking because the process explicitly skips YAML frontmatter and code blocks, only linking the first natural mention to avoid double-linking.

How does wikilink matching handle ambiguous page name references?

Wikilink matching handles ambiguous references by scoring candidates with composite signals, labeling uncertain matches as AMBIGUOUS, and only applying links labeled EXTRACTED or INFERRED.

Does automated Obsidian cross-linking work for post-ingest content management workflows?

Automated Obsidian cross-linking works effectively for post-ingest content management workflows by quickly weaving newly ingested pages into existing hubs without reading the entire vault.

What are the limitations of using a cross-linker for Obsidian content management?

Limitations include skipping immutable raw files entirely and only adding links labeled EXTRACTED or INFERRED, leaving AMBIGUOUS mentions untouched to preserve linking accuracy and prevent incorrect connections.