Download .skills/tag-taxonomy/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
Where does tag-taxonomy live?
The publisher keeps it at https://github.com/Ar9av/obsidian-wiki.
Which agents can use tag-taxonomy?
Claude, Cursor, and Codex can read a SKILL.md you add from the publisher's repository.
>
name: tag-taxonomy
description: >
Apply and maintain the wiki's controlled tag vocabulary. Use for choosing, normalizing, auditing, or extending tags when creating or updating wiki pages; consult the taxonomy before assigning tags.
Tag Taxonomy — Controlled Vocabulary for Wiki Tags
You are enforcing consistent tagging across the wiki by normalizing tags to a controlled vocabulary.
Before You Start
Resolve config — follow the Config Resolution Protocol in llm-wiki/SKILL.md (inline @name override → walk up CWD for .env → global config → prompt setup). This gives OBSIDIAN_VAULT_PATH
Read $OBSIDIAN_VAULT_PATH/_meta/taxonomy.md — this is the canonical tag list
Read index.md to understand the wiki's scope
The Taxonomy File
The canonical tag vocabulary lives at $OBSIDIAN_VAULT_PATH/_meta/taxonomy.md. It defines:
Canonical tags — the tags that should be used
Aliases — common alternatives that should be mapped to the canonical form
Rules — max 5 tags per page, lowercase/hyphenated, prefer broad over narrow
Migration guide — specific renames for known inconsistencies
Always read this file before tagging. It's the source of truth.
Reserved System Tags
visibility/ is a reserved tag group with special rules. These tags are not domain or type tags and are managed separately from the taxonomy vocabulary:
Tag
Purpose
visibility/public
Explicitly public — shown in all modes (same as no tag)
visibility/internal
Team-only — excluded in filtered query/export mode
visibility/pii
Sensitive data — excluded in filtered query/export mode
Rules for visibility/ tags:
They do not count toward the 5-tag limit
Only one visibility/ tag per page
Omit entirely when content is clearly public — no tag needed
Never add visibility/internal just because content is technical; use it only for genuinely team-restricted knowledge
When running a tag audit, report visibility/ tag usage separately — do not flag them as unknown or non-canonical
When normalizing tags, leave visibility/ tags untouched — they are not subject to alias mapping.
Mode 1: Tag Audit
When the user wants to see the current state of tags:
Step 1: Scan all pages
Glob: $VAULT_PATH/**/*.md (excluding _archives/, .obsidian/, _meta/)
Extract: tags field from YAML frontmatter
Step 2: Build a tag frequency table
For each tag found, count how many pages use it. Flag:
Unknown tags — not in the taxonomy's canonical list
Alias tags — using an alias instead of the canonical form (e.g., nextjs instead of react)
Over-tagged pages — pages with more than 5 tags
Untagged pages — pages with no tags or empty tags field
Never hand-edit index.md, log.md, or hot.md — the command takes the lock that keeps a parallel writer from dropping your update.
See .skills/llm-wiki/references/MEMORY.md for the full procedure.
QMD Refresh After Vault Writes
QMD is a search index, not the source of truth. If $QMD_WIKI_COLLECTION is empty or unset, skip this step. Run it only after this skill has written or rewritten vault markdown. If QMD refresh fails, do not roll back the vault changes; report the QMD status separately.
Use $QMD_CLI if set; otherwise use qmd.
${QMD_CLI:-qmd} update
If the output says vectors are needed or embeddings may be stale, run:
${QMD_CLI:-qmd} embed
Verify the collection with either:
${QMD_CLI:-qmd} ls "$QMD_WIKI_COLLECTION"
or, when a specific page path is known:
${QMD_CLI:-qmd} get "qmd://$QMD_WIKI_COLLECTION/<page>.md" -l 5
Record one of:
QMD refreshed: update + embed + verified
QMD refreshed: update only + verified
QMD skipped: QMD_WIKI_COLLECTION unset
QMD skipped: qmd CLI unavailable
QMD failed: <short error summary>
How do I install tag-taxonomy?
Download .skills/tag-taxonomy/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
Where does tag-taxonomy live?
The publisher keeps it at https://github.com/Ar9av/obsidian-wiki.
Which agents can use tag-taxonomy?
Claude, Cursor, and Codex can read a SKILL.md you add from the publisher's repository.