skills.rest
oresttokovenko
oresttokovenkoCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

tag-taxonomy

Normalizes Obsidian wiki tags against a controlled vocabulary defined in a canonical taxonomy file.

Updated Nov 9, 2023
Search Tags:#knowledge management#obsidian#wiki#taxonomy#tag normalization#controlled vocabulary#tag audit
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill tag-taxonomy-oresttokovenko
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tag-taxonomy
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/tag-taxonomy
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill tag-taxonomy-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Wiki tags drift over time: aliases multiply, pages get over-tagged, and inconsistent labels break search and filtering. This Skill audits and normalizes tags across an Obsidian vault so every page uses a consistent, canonical vocabulary. ## Core Features & Use Cases - Tag Audit: Scans all vault pages, builds a tag frequency table, and flags unknown tags, alias usage, over-tagged pages, and untagged pages in a structured report. - Tag Normalization: Replaces alias tags with canonical forms, trims pages exceeding the 5-tag limit, and proposes taxonomy additions for recurring unknown tags. - New Page Tagging & Taxonomy Growth: Selects up to 5 canonical tags (domain, type, project) for new pages and appends genuinely new tags to _meta/taxonomy.md. - Reserved visibility/ Tags: Handles visibility/public, visibility/internal, and visibility/pii separately from the domain taxonomy, exempt from the tag limit and alias mapping. - Use Case: After months of ad-hoc tagging, run a tag audit to discover that nextjs, next-js, and react all refer to the same topic, then normalize 28 pages to the canonical react tag in one pass. ## Quick Start Ask the assistant to run a tag audit on your Obsidian vault and normalize any non-canonical tags it finds.

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 in an Obsidian vault?▼

Run a tag audit that scans every page's YAML frontmatter, maps alias tags like `nextjs` to their canonical form like `react`, and rewrites the frontmatter. The canonical vocabulary lives in the vault's `_meta/taxonomy.md` file.

How do I audit tags across all my wiki pages?▼

A tag audit globs all markdown files excluding archive and config folders, extracts the tags field from frontmatter, and builds a frequency table. It flags unknown tags, alias usage, pages over the 5-tag limit, and untagged pages in a summary report.

What is a controlled vocabulary for wiki tags?▼

A controlled vocabulary is a canonical tag list defining approved tags, their aliases, and usage rules such as a 5-tag maximum and lowercase hyphenated format. It prevents tag drift by giving every concept exactly one canonical label.

Can visibility tags coexist with regular taxonomy tags?▼

Yes. Reserved `visibility/` tags like `visibility/internal` and `visibility/pii` are managed separately from the domain taxonomy. They do not count toward the 5-tag limit, are exempt from alias mapping, and only one visibility tag is allowed per page.

What happens to unknown tags not in the taxonomy?▼

Unknown tags used on two or more pages are suggested as additions to the taxonomy, while single-use tags are recommended for replacement with the closest canonical tag. The user is asked for confirmation before any unknown tag is changed.

Related Skills

Explore More Content & Communication Skills→
Ar9avAr9av
3.2k

tag-taxonomy

Normalize Obsidian wiki page tags to a canonical taxonomy.

Community
Intermediate
onebrain-aionebrain-ai
23

qmd

Configure qmd search indexes and manage embeddings for vault searching.

Official
Intermediate
nadicodeainadicodeai

llm-wiki

Build and maintain interlinked Markdown knowledge bases with YAML frontmatter and wikilinks.

Official
Advanced
NewEarthAINewEarthAI

tag-taxonomy

Enforce predefined tags and audit tagging in Obsidian wikis.

Community
Advanced