consolidate-on

Consolidate Obsidian wikilinks to canonical [[filename|Display Name]] form.

Updated Mar 9, 2026
One-click install
npx skills add https://github.com/tsemana/obsidian-productivity --skill consolidate-on
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: consolidate-on
Source: https://github.com/tsemana/obsidian-productivity/tree/main/plugin/skills/consolidate-on
Command: npx skills add https://github.com/tsemana/obsidian-productivity --skill consolidate-on

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Consolidates all wikilink references to a specific note across an Obsidian vault, converting any alias-based or inconsistent links ([[First Name]], [[Project Name]], [[username123]]) into the canonical [[filename|Display Name]] format that resolves directly by file path.

Core Features & Use Cases

  • Find target files by matching the note name against title, aliases, or the filename slug across memory/people, memory/projects, references, and the full vault.
  • Extract canonical identity (canonical_filename, display_name, aliases) and perform in-place rewrites of non-canonical links to the canonical [[filename|Display Name]] format.
  • Report counts of files scanned and links updated, and flag any prose mentions that could not be auto-converted.

Quick Start

Run the consolidation tool against your vault to rewrite all non-canonical wikilinks to their canonical [[filename|Display Name]] form.

Frequently Asked Questions about consolidate-on

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

FAQPage Schema
How do I convert Obsidian wikilink aliases to a canonical filename format?

To convert Obsidian wikilink aliases, the tool rewrites all non-canonical links across your vault into the [[filename|Display Name]] format. It requires the vault root path, canonical filename slug, display name, and the list of aliases to map.

Can I consolidate inconsistent wikilinks across my entire Obsidian vault at once?

Yes, you can consolidate inconsistent wikilinks across your entire Obsidian vault at once. The tool applies vault-wide rewrites across people, projects, references, or any note type, reporting the total links updated and files touched.

What types of wikilink formats are supported during link consolidation?

Link consolidation supports multiple wikilink formats including bare aliases [[alias]], display text overrides [[alias|text]], and links containing escaped pipes. It converts all detected variations into the canonical [[filename|Display Name]] form.

How do I fix broken or inconsistent wikilinks pointing to the same note in Obsidian?

Fixing inconsistent wikilinks involves scanning your vault for alias-based references and performing in-place rewrites to the canonical file path. The tool also flags any prose mentions that could not be auto-converted for manual review.

What information do I need to provide before consolidating Obsidian vault wikilinks?

Before consolidating Obsidian vault wikilinks, you need to provide the vault root path, the canonical filename slug, the desired display name, and the complete list of aliases to map. This ensures all non-canonical references are accurately targeted.

Why are some prose mentions of aliases not converted to canonical wikilinks?

Prose mentions are not converted to canonical wikilinks because the tool only targets structured wikilink syntax like [[alias]] and [[alias|text]]. Unlinked text mentions are flagged in the report so you can manually review and update them.