obsidian

Refactor Obsidian notes to Obsidian-flavored Markdown and vault-safe conventions.

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/kingkillery/pk-qmd --skill obsidian-kingkillery
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/kingkillery/pk-qmd/tree/main/.agents/skills/obsidian
Command: npx skills add https://github.com/kingkillery/pk-qmd --skill obsidian-kingkillery

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines note creation, organization, and maintenance in Obsidian, addressing user needs for clean note structures, stable links, and consistent metadata.

Core Features & Use Cases

  • Note Refactoring: Refactor existing notes to adhere to Obsidian-flavored Markdown (OFM) standards.
  • Vault Structure: Clean up and reorganize vaults for better searchability and navigation.
  • Link Management: Ensure all links within notes are stable, with proper backlinks and canonical names.
  • Tag and Property Management: Normalize tags and properties in notes for consistency.

Quick Start

Use the obsidian skill to refactor the existing note 'Project X' to follow best practices.

Frequently Asked Questions about obsidian

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

FAQPage Schema
How do I refactor existing markdown notes to follow Obsidian-flavored Markdown standards?

To refactor markdown notes, you process existing content to adhere to Obsidian-flavored Markdown and vault-safe conventions. This standardization improves note quality, structural stability, and long-term maintainability across your vault.

What's the best way to fix broken links and backlinks in an Obsidian vault?

Fixing broken links and backlinks in an Obsidian vault requires checking all internal connections for stability and proper canonical names. This link management process ensures notes reference each other correctly without dead ends.

How do you normalize tags and properties for consistent metadata in Obsidian?

Normalizing tags and properties in Obsidian involves standardizing metadata fields across all notes for consistency. This process cleans up disorganized tags and properties, making vault content easier to search and filter accurately.

Can I reorganize my Obsidian vault structure for better searchability and navigation?

You can reorganize your Obsidian vault structure by cleaning up and restructuring note hierarchies. This reorganization directly improves vault searchability and navigation, allowing you to find notes more efficiently.

Does refactoring notes to vault-safe conventions affect existing note content?

Refactoring notes to vault-safe conventions optimizes the underlying markdown structure without destroying existing content. It enhances note quality and stability by applying consistent formatting, link checks, and metadata standardization.

When do I need to optimize Obsidian notes for better vault stability?

You need to optimize Obsidian notes when experiencing disorganized vault structures, inconsistent metadata, or unstable links. Refactoring notes to vault-safe conventions resolves these issues and restores structural stability.