tag-taxonomy

Normalize Obsidian wiki tags to a controlled taxonomy and log audits.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/Nero-kk/claude-agent-skills --skill tag-taxonomy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tag-taxonomy
Source: https://github.com/Nero-kk/claude-agent-skills/tree/main/claude-skills/tag-taxonomy
Command: npx skills add https://github.com/Nero-kk/claude-agent-skills --skill tag-taxonomy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates inconsistent and messy tagging in an Obsidian wiki by normalizing tags to a canonical controlled vocabulary and helping maintain tag hygiene across many pages.

Core Features & Use Cases

  • Tag Audit: Scan the vault for tags, build frequency tables, and identify unknown tags, aliases, over-tagged and untagged pages.
  • Tag Normalization: Replace alias tags with canonical forms, suggest removals when pages exceed tag limits, and optionally update frontmatter.
  • Taxonomy Management: Propose and append new canonical tags with aliases to the vault's _meta/taxonomy.md when agreed.
  • Use Case: Run a site-wide audit to map legacy aliases to canonical tags, reduce tag clutter to five tags per page, and generate an audit log of changes.

Quick Start

Use the tag-taxonomy skill to audit and normalize tags in my Obsidian vault and propose taxonomy updates when needed.

Frequently Asked Questions about tag-taxonomy

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

FAQPage Schema
How do I normalize inconsistent tags across an Obsidian wiki?▼

To normalize Obsidian wiki tags, map alias tags to canonical forms within a controlled taxonomy, enforce tag limits per page, and update the frontmatter to maintain consistent metadata across the vault.

What is a wiki tag audit and when do I need to run one?▼

A wiki tag audit scans your vault to build frequency tables and identify unknown tags, aliases, over-tagged, and untagged pages. Run it when legacy tags accumulate and clutter your content structure.

How do I enforce a controlled taxonomy and limit tags per page in Obsidian?▼

Enforce a controlled taxonomy by reading the vault taxonomy file, replacing aliases with canonical tags, and suggesting removals when pages exceed a five-tag limit to reduce tag clutter.

Can I append new canonical tags and aliases to the vault taxonomy file?▼

Yes, you can propose and append new canonical tags with their aliases to the vault's `_meta/taxonomy.md` file, while appending structured audit entries to a log to track taxonomy management changes.

Does this tag normalization approach work without external dependencies?▼

Yes, this tag normalization approach works without external dependencies, reading the vault taxonomy file directly to map aliases to canonical tags and enforce page-level metadata hygiene.