skills.rest
artislismanis
artislismanisCOMMUNITY
Explore all skills by this author →
Website𝕏@ArtisLismanisGitHub

note-refactor

Rename, move, or delete notes while inspecting backlinks to prevent broken links.

Updated Mar 29, 2026
Search Tags:#backlinks#delete#obsidian#refactor#rename#vault#move
One-click install
npx skills add https://github.com/artislismanis/obsidian-agent-sandbox --skill note-refactor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: note-refactor
Source: https://github.com/artislismanis/obsidian-agent-sandbox/tree/main/workspace/.claude/skills/note-refactor
Command: npx skills add https://github.com/artislismanis/obsidian-agent-sandbox --skill note-refactor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Structural vault changes — rename, move, delete — are the highest-risk operations. A careless delete silently orphans every link that pointed at it. This skill makes the blast radius visible before acting and uses the review modal when available.

Core Features & Use Cases

  • Rename notes/foo.md to notes/bar.md safely after reviewing backlinks.
  • Move notes to new folders while updating wikilinks and backrefs.
  • Delete a note with backlinks only after user approval, with optional backup and review modal.
  • Reorganize vault structure while preserving backlink integrity and offering archiving when unsure.

Quick Start

Rename notes/foo.md to notes/bar.md and review backlinks before applying.

Frequently Asked Questions about note-refactor

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

FAQPage Schema
How do I safely rename an Obsidian note without breaking incoming backlinks?▼

To safely rename an Obsidian note without breaking backlinks, the skill surfaces all incoming backlinks for review before applying the rename, ensuring wikilinks and backrefs remain intact across the vault structure.

What happens to unresolved links when I delete a note in a vault?▼

When deleting a vault note, the skill prevents unresolved links by surfacing the blast radius of incoming backlinks beforehand. It requires explicit user approval and offers optional archiving and a review modal before final deletion.

Can I move notes to new folders while preserving backlink integrity?▼

Yes, you can move notes to new folders while preserving backlink integrity. The skill updates wikilinks and backrefs during the vault move, verifying that no new unresolved links are created in the process.

Is there a way to preview backlink changes before reorganizing my Obsidian vault?▼

Yes, you can preview backlink changes before reorganizing your Obsidian vault. The skill uses an optional review modal to inspect backlinks, propose structural changes, and verify results before final application.

Why do my vault links break after moving notes across folders?▼

Vault links break after moving notes because wikilinks and backrefs were not updated during the move. This skill prevents broken links by inspecting backlinks first and applying vault_move operations safely across folders.

Related Skills

Explore More Content & Communication Skills→
llm011llm011
9

obsidian

Manage Obsidian vault notes, metadata, tags, and backlinks while preserving structure.

Official
Advanced
rikt46rikt46

vault-audit

Audit vault notes for structural issues, duplicates, broken links, and frontmatter gaps.

Community
Advanced
NousResearchNousResearch
227.8k

obsidian

Manage Obsidian vault notes by reading, listing, searching, creating, and appending Markdown files.

Official
Basic
jrhueiuengjrhueiueng

matter-workspace

Create, list, switch, and archive per-client matter workspaces.

Community
Intermediate