Tag Taxonomy

Keeps your Obsidian wiki tags consistent by enforcing a controlled vocabulary defined in a taxonomy file. Triggered when you say "fix my tags" or "tag audit", or automatically when creating pages. It scans your vault, flags aliases and unknown tags, normalizes them to canonical forms, and respects a 5-tag-per-page limit. Handles visibility tags separately (public/internal/pii) and logs all operations. The implementation is thorough, walking up directories for config resolution and maintaining a migration guide for known inconsistencies. Useful if your wiki has grown organically and tags have gotten messy, or if you want guardrails when multiple people are contributing.

skills.sh installs: 3.2K
GitHub stars: 3.7K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add ar9av/obsidian-wiki --skill tag-taxonomy --agent claude-code

Installs into .claude/skills of the current project.

Files

Tag Taxonomy — Controlled Vocabulary for Wiki Tags

You are enforcing consistent tagging across the wiki by normalizing tags to a controlled vocabulary.

Before You Start

Resolve config — follow the Config Resolution Protocol in llm-wiki/SKILL.md (inline @name override → walk up CWD for .env → global config → prompt setup). This gives OBSIDIAN_VAULT_PATH
Read $OBSIDIAN_VAULT_PATH/_meta/taxonomy.md — this is the canonical tag list
Read index.md to understand the wiki's scope

The Taxonomy File

The canonical tag vocabulary lives at $OBSIDIAN_VAULT_PATH/_meta/taxonomy.md. It defines:

Canonical tags — the tags that should be used
Aliases — common alternatives that should be mapped to the canonical form
Rules — max 5 tags per page, lowercase/hyphenated, prefer broad over narrow
Migration guide — specific renames for known inconsistencies

Always read this file before tagging. It's the source of truth.

Reserved System Tags

visibility/ is a reserved tag group with special rules. These tags are not domain or type tags and are managed separately from the taxonomy vocabulary:

SKILL.md on GitHub