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.