tag-taxonomy

Audit Markdown frontmatter tags against a canonical taxonomy and normalize them.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/HelloWorldSungin/ark-skills --skill tag-taxonomy-helloworldsungin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tag-taxonomy
Source: https://github.com/HelloWorldSungin/ark-skills/tree/main/skills/tag-taxonomy
Command: npx skills add https://github.com/HelloWorldSungin/ark-skills --skill tag-taxonomy-helloworldsungin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Tag variability across vault pages slows search and weakens data quality. This Skill enforces a canonical vocabulary by validating and normalizing tags against the vault's canonical taxonomy, ensuring consistent tagging and easier discovery.

Core Features & Use Cases

  • Tag Audit: identify unknown tags, alias tags, over-tagged pages, and untagged pages by scanning frontmatter across the vault.
  • Tag Normalization: replace aliases with canonical forms and propose additions to the taxonomy for new concepts.
  • Taxonomy Extension: add new canonical tags to _meta/taxonomy.md and commit changes to the repository.

Quick Start

Run a tag-audit workflow against your vault to surface inconsistencies and begin normalization.

Frequently Asked Questions about tag-taxonomy

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

FAQPage Schema
How do I normalize vault tags against a canonical taxonomy?

Vault tag normalization validates frontmatter tags against a canonical taxonomy, replacing aliases with canonical forms and flagging unknown tags. This ensures consistent tagging and easier discovery across all Markdown files in the vault.

What is vault tag auditing and how does it improve search?

Vault tag auditing scans Markdown frontmatter to identify unknown tags, aliases, over-tagged pages, and untagged pages. Enforcing a canonical vocabulary through this audit slows tag variability, strengthens data quality, and ensures easier content discovery.

How do I add new canonical tags to a taxonomy file after an audit?

To add new canonical tags after an audit, use the taxonomy update workflow to append the new concepts to _meta/taxonomy.md. The Skill then commits these normalized changes and the new tags to the repository to maintain the canonical vocabulary.

Does the tag audit work with all Markdown files in my vault?

Yes, the tag audit works across all Markdown files in the vault by scanning their frontmatter tags. It identifies inconsistencies including missing tags, over-tagging, and unknown aliases to apply normalization comprehensively.

What is the best way to enforce consistent tagging across a vault?

The best way to enforce consistent tagging is to validate and normalize tags against a canonical taxonomy. By auditing frontmatter to flag aliases and unknown tags, then committing normalized changes to a taxonomy file, you ensure uniform vocabulary.