Tag Management Skill

Analyze and refactor YAML frontmatter tags in Markdown files.

49|12|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/DavidROliverBA/ArchitectKB --skill tag-management-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Tag Management Skill
Source: https://github.com/DavidROliverBA/ArchitectKB/tree/main/.claude/skills/tag-management
Command: npx skills add https://github.com/DavidROliverBA/ArchitectKB --skill tag-management-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the chaos of inconsistent, inaccurate, and unmanaged tags within a knowledge base, ensuring all tags adhere to a defined taxonomy for better organization and discoverability.

Core Features & Use Cases

  • Tag Analysis: Identifies violations like incorrect casing, missing hierarchies, and template contamination.
  • Tag Refactoring: Automatically corrects tag issues based on predefined rules and a taxonomy.
  • Tag Suggestion: Recommends relevant tags for new or existing notes based on content.
  • Tag Migration: Facilitates batch renaming of tags across the entire vault.
  • Use Case: A Solutions Architect needs to ensure all their project documentation uses a consistent tagging system. They can use this Skill to analyze their vault, identify all non-compliant tags, and then automatically refactor them to match the official taxonomy, improving searchability and AI interpretation.

Quick Start

Run /tag-analyze vault to check for tag violations across your entire knowledge base.

Frequently Asked Questions about Tag Management Skill

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

FAQPage Schema
How do I refactor inconsistent tags in my Markdown vault?

You can refactor tags in your Markdown vault by running Python scripts that analyze YAML frontmatter and automatically correct casing, add missing hierarchies, and remove template variables to enforce a consistent taxonomy.

How do I check my knowledge base for taxonomy violations?

To check your knowledge base for taxonomy violations, run a tag analysis command to scan your Markdown files and identify issues like incorrect casing, missing hierarchies, and template contamination across the entire vault.

Can I automatically suggest tags for existing notes based on content?

Yes, you can automatically suggest tags for existing notes. The Skill analyzes the content of your Markdown files and recommends relevant tags that comply with your predefined taxonomy rules.

What is the best way to batch rename tags across a knowledge base?

The best way to batch rename tags across a knowledge base is to use a tag migration command, which systematically finds and updates specified tags throughout all your Markdown files to maintain taxonomy consistency.

Does this tag management tool work with non-Markdown files?

No, this tag management tool does not work with non-Markdown files. It specifically operates on Markdown files containing YAML frontmatter to analyze and refactor tags according to your defined taxonomy.

Why do my notes have template variables in their tags?

Template variables contaminate tags when a note is created from a template without replacing the variables. The Skill identifies these as taxonomy violations and automatically removes them during the tag refactoring process.