skills.rest
r2d2helm
r2d2helmCOMMUNITY
Explore all skills by this author →
GitHub

obsidian-skill

Run automated health checks, link fixes, and tag normalization on Obsidian vaults.

Updated Aug 27, 2026
Search Tags:#maintenance#obsidian#links#vault#health#frontmatter#tags
One-click install
npx skills add https://github.com/r2d2helm/claude-code-system --skill obsidian-skill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obsidian-skill
Source: https://github.com/r2d2helm/claude-code-system/tree/main/skills/obsidian-skill
Command: npx skills add https://github.com/r2d2helm/claude-code-system --skill obsidian-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Obsidian vaults often degrade in health due to broken links, inconsistent tags, missing frontmatter, and noisy maintenance tasks. This skill provides automated diagnostics, guided cleanups, and standardized metadata to keep vaults reliable and easy to navigate.

Core Features & Use Cases

  • Health scoring and diagnostics to quantify vault quality and track improvements over time.
  • Link integrity checks to identify broken or orphaned links and suggest fixes.
  • Tag normalization and hierarchy insights to reduce duplicates and improve navigation.
  • Frontmatter validation and enrichment to ensure consistent metadata across notes.
  • Maintenance workflows including backups, cleanups, and structured reports for audits.
  • Use Cases: Large vaults with hundreds of notes requiring periodic health checks, or teams needing consistent vault hygiene.

Quick Start

Run the slash command /obs-health to perform a quick vault health check and start maintenance.

Frequently Asked Questions about obsidian-skill

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

FAQPage Schema
How do I fix broken links and normalize tags in my Obsidian vault?▼

Fix broken links and normalize tags in an Obsidian vault by running automated health checks that identify orphaned links and duplicate tags. The skill provides safe, idempotent operations to suggest and apply fixes while preserving your original note structure.

What is the best way to perform an Obsidian vault health check on a large note collection?▼

Performing an Obsidian vault health check on large note collections is best done using an automated health scoring model. It analyzes hundreds of notes, attachments, and templates to generate a quantifiable quality score and structured diagnostic reports for tracking improvements.

Can I enforce consistent frontmatter across all notes in an Obsidian vault?▼

Yes, you can enforce consistent frontmatter across an Obsidian vault using automated validation and enrichment workflows. The skill checks for missing metadata and applies standardized frontmatter fields to ensure consistent navigation and structure.

How do I safely clean up Obsidian vault attachments without losing data?▼

Safely clean up Obsidian vault attachments by using maintenance workflows equipped with validation and dry-run options. These features allow you to preview cleanups and backups idempotently, ensuring no data is lost during the automated removal of orphaned files.

Does this vault maintenance skill support dry-run operations for link integrity checks?▼

Yes, the vault maintenance skill supports dry-run operations for link integrity checks. You can run diagnostics to identify broken links and preview suggested fixes without applying changes, ensuring all maintenance operations remain safe and reversible.

Why are my Obsidian tags inconsistent and how do I analyze tag hierarchy?▼

Obsidian tags become inconsistent due to duplicates and unstructured naming. You can analyze tag hierarchy and normalize tags using automated diagnostics that reduce duplicates, provide hierarchy insights, and improve overall vault navigation.

Related Skills

Explore More Content & Communication Skills→
EdgeAppEdgeApp
1

obsidian

Create and organize Markdown notes in a local Obsidian vault.

Official
Intermediate
lightningfastslslightningfastsls

health

Diagnose vault health across schema, links, and processing throughput.

Community
Advanced
kirakuiinkirakuiin

obsidian-markdown

Create and edit Obsidian-flavored Markdown notes with wikilinks, embeds, callouts, and frontmatter.

Community
Intermediate
lvndrylvndry
47

obsidian

Automate Obsidian note creation, retrieval, and vault organization via obsidian-cli.

Community
Advanced