tag-taxonomy

The tag-taxonomy skill enforces consistent tagging across an Obsidian-based wiki by applying a controlled vocabulary defined in a canonical taxonomy file. Its primary purpose is to reduce tag sprawl, eliminate inconsistent naming, and ensure that pages are categorized using approved tags rather than ad hoc alternatives. Before assigning or modifying tags, the skill resolves the wiki configuration, reads the taxonomy source of truth, and reviews the wiki index to understand the overall scope of the knowledge base. This helps maintain a coherent tagging system across all content.

The skill supports tag normalization, tag audits, taxonomy compliance checks, and controlled vocabulary enforcement. It maps alias tags to canonical forms, identifies unknown tags that are not part of the taxonomy, detects pages that exceed tagging limits, and finds untagged content. It also follows taxonomy rules such as limiting pages to a maximum of five tags, preferring broad categories over overly specific tags, and preserving reserved visibility tags without modification. During audits, it generates structured reports that summarize tag usage, highlight non-canonical tags, and provide recommendations for taxonomy improvements.

This skill is intended for wiki maintainers, documentation teams, knowledge management practitioners, and anyone responsible for organizing content in an Obsidian vault. It is especially useful when cleaning up inconsistent tags, establishing tagging standards, onboarding new contributors, performing periodic taxonomy reviews, or evaluating whether new tags should be added to the controlled vocabulary. By centralizing tagging decisions around a single taxonomy file, the skill helps keep large documentation collections organized and searchable.