tag-audit

Detect and merge case or pluralization tag variants across vault notes.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/artislismanis/obsidian-agent-sandbox --skill tag-audit-artislismanis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tag-audit
Source: https://github.com/artislismanis/obsidian-agent-sandbox/tree/main/workspace/.claude/skills/tag-audit
Command: npx skills add https://github.com/artislismanis/obsidian-agent-sandbox --skill tag-audit-artislismanis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Vault tags drift over time — the same concept ends up as #project, #Project, #projects. This skill finds those variants, proposes a merge plan, and applies it once the user approves.

Core Features & Use Cases

  • Detect variant tag clusters that differ only by case, plurality, or separators and propose canonical merges.
  • Generate per-cluster merge plans and present diffs for review before applying changes.
  • Apply approved merges across notes, updating tag references in content and frontmatter as needed.

Quick Start

Prompt the agent to audit tag variants, generate a merge plan, and apply approved changes across notes.

Frequently Asked Questions about tag-audit

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

FAQPage Schema
How do I consolidate duplicate tags in my vault that differ by case or pluralization?

Consolidating duplicate vault tags involves detecting variant clusters that differ only by case, plurality, or separators and merging them into a single canonical tag. This skill scans vault tags, proposes a merge plan, and applies approved changes across notes.

What is the best way to audit and merge tag variants across notes?

Auditing and merging tag variants across notes is best handled by detecting tag clusters, generating per-cluster merge plans, and presenting diffs for review. Once you approve the merge plan, tag references in content and frontmatter are updated automatically.

Can I review a diff of tag changes before they are applied to my notes?

Yes, you can review a diff of tag changes before they are applied. This skill generates per-cluster merge plans and presents them for your review, ensuring no tag references in content or frontmatter are updated until you give explicit approval.

How do I fix tag sprawl caused by inconsistent naming in my vault?

Fixing vault tag sprawl requires identifying inconsistent tag naming conventions and canonicalizing them. This skill audits your vault tags to find variants, proposes a standardized merge plan, and updates all references after you approve the changes.

Does merging vault tags update both content and frontmatter references?

Merging vault tags updates both content and frontmatter references. When applying an approved merge plan, the skill uses search and replace operations to update tag references in note content and sets the correct frontmatter tags.