tag-taxonomy

Normalize Obsidian wiki page tags to canonical taxonomy forms.

Updated Feb 2, 2016
One-click install
npx skills add https://github.com/zjykzk/blog --skill tag-taxonomy-zjykzk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tag-taxonomy
Source: https://github.com/zjykzk/blog/tree/main/.agents/skills/tag-taxonomy
Command: npx skills add https://github.com/zjykzk/blog --skill tag-taxonomy-zjykzk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enforce consistent tagging across the Obsidian wiki by applying a controlled vocabulary to all pages, preventing tag fragmentation and improving searchability.

Core Features & Use Cases

  • Normalize tags to canonical forms using the central taxonomy and alias mappings.
  • Enforce tagging rules (max 5 tags per page, lowercase/hyphenated) and respect reserved visibility tags.
  • Perform tag audits and updates across pages, and guide the creation of new pages with appropriate tags.
  • Consult the canonical taxonomy before applying tags to any wiki page to ensure consistency.

Quick Start

Inspect the canonical taxonomy and run a tag audit to normalize a page’s tags.

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?

You can enforce consistent Obsidian wiki tags by applying a controlled vocabulary. This Skill consults a canonical taxonomy and uses alias mappings to normalize page tags during audits, updates, and new page creation.

What is a canonical tag taxonomy and how does it prevent tag fragmentation?

A canonical tag taxonomy is a controlled vocabulary that standardizes wiki tags. By mapping aliases to canonical forms, it prevents tag fragmentation where multiple variations of the same concept create isolated, unsearchable pages.

How many tags should a wiki page have when enforcing taxonomy rules?

A wiki page should have a maximum of 5 tags when enforcing taxonomy rules. This Skill enforces a 5-tag limit and requires lowercase, hyphenated formatting while respecting reserved visibility tags in the page frontmatter.

Can I run a tag audit to update frontmatter across existing wiki pages?

Yes, you can run a tag audit to update frontmatter across existing wiki pages. The Skill reads the canonical taxonomy, normalizes tags via aliases, enforces the 5-tag limit, and updates the frontmatter accordingly.

Does this taxonomy checker work without additional dependencies or components?

Yes, this taxonomy checker works without additional dependencies or components. It operates independently to read the canonical taxonomy, apply alias mappings, and enforce tagging rules directly on Obsidian wiki pages.