obsidian-untangle-knot

Offload overloaded Obsidian hub notes by creating sub-MOCs and redirecting incoming links.

4|Updated Aug 8, 2026
One-click install
npx skills add https://github.com/alexeyshishin/as-skill --skill obsidian-untangle-knot-alexeyshishin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-untangle-knot
Source: https://github.com/alexeyshishin/as-skill/tree/main/domains/obsidian/skills/obsidian-untangle-knot
Command: npx skills add https://github.com/alexeyshishin/as-skill --skill obsidian-untangle-knot-alexeyshishin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? In a personal knowledge base, hub notes (MOCs) accumulate hundreds of incoming links until they become useless backlink dumps. This Skill diagnoses the tangle by in-degree, splits the hub into sub-MOCs based on its existing structure, and re-links incoming references so the graph becomes navigable again. ## Core Features & Use Cases - Tangle Diagnosis: Counts in-links and out-links across three distinct streams (out-neighbors, up-children in frontmatter, and body mentions) to determine whether a note qualifies as a tangle. - Sub-MOC Creation: Builds sub-MOCs from the hub's existing subheadings or a chosen categorization axis, preserving the author's mental model and keeping the original MOC as a general entry point. - Two-Iteration Re-linking: First re-links up frontmatter fields on neighbors (safe scaffold), then optionally redirects in-links inside resource note bodies, with a confirmation gate between iterations. - Use Case: Your [[DevOps]] map has 222 incoming links and is unreadable. Run this Skill to create sub-maps like DevOps – Деплой и релиз, re-link resource notes to the right sub-map, and cut the hub's in-degree by 50-70%. ## Quick Start Ask the AI to untangle the overloaded hub note [[DevOps]] in your Obsidian vault and redirect its incoming links to new sub-MOCs.

Frequently Asked Questions about obsidian-untangle-knot

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

FAQPage Schema
How do I fix an Obsidian note with too many backlinks?

Identify the hub note, count its incoming links, then split it into sub-MOCs based on its existing subheadings or categories. Redirect incoming links from resource notes to the appropriate sub-MOC while keeping the original note as a general entry point.

What is a MOC in Obsidian and when should I split one?

A MOC (Map of Content) is a hub note that organizes links to related notes. Split it when its in-degree exceeds roughly 50-100 incoming links and its existing structure suggests clear subcategories, creating sub-MOCs named like 'Parent – Category'.

Does re-linking change notes outside my resources folder?

No. Links from projects, journal entries, archive, inbox, and work folders are intentionally left untouched because they were made as general entry points. Only informational notes in the resources area are eligible for re-linking.

Why did my hub's backlink count barely drop after creating sub-MOCs?

The first iteration only re-links up fields in frontmatter, which is a small fraction of total links. The real in-degree reduction comes in the second iteration, when links inside resource note bodies are redirected to sub-MOCs.

When should I not untangle an Obsidian hub note?

Skip untangling when in-degree is below 20, when out-degree is under 5 (nothing to build sub-MOCs from), or when no categorization axis yields at least 3 notes per category. In those cases, use note critique or note splitting instead.