obsidian-tag-normalizer

Normalize and standardize tags across an Obsidian vault.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/jeongsk/langchain-academy --skill obsidian-tag-normalizer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-tag-normalizer
Source: https://github.com/jeongsk/langchain-academy/tree/main/.claude/skills/obsidian-tag-normalizer
Command: npx skills add https://github.com/jeongsk/langchain-academy --skill obsidian-tag-normalizer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Normalize and standardize tags across Obsidian notes, creating a clean, hierarchical taxonomy across languages.

Core Features & Use Cases

  • Technology Name Normalization: Enforce proper casing (LangChain, LangGraph, OpenAI).
  • Hierarchical Tag Structure: Apply ai/agents and similar structures
  • Consolidate Duplicates: Merge similar tags (ai-agents → ai/agents)
  • Reporting: Generate tag usage analysis.

Quick Start

Run the tag normalization script to analyze and then apply changes across your vault.

Frequently Asked Questions about obsidian-tag-normalizer

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

FAQPage Schema
How do I normalize inconsistent tags across my Obsidian vault?

Tag normalization standardizes tag names, applies hierarchical structures (like ai/agents), consolidates duplicates, and enforces consistent casing across all notes. Run the tag_standardizer.py script to analyze your vault and apply changes.

Can I enforce hierarchical tag structures with forward slashes in Obsidian?

Yes, hierarchical tagging applies forward-slash paths (e.g., ai/agents, ai/llm) to organize tags into taxonomies. The normalizer converts flat tags into this structure while preserving semantic meaning across your vault.

How do I consolidate duplicate tags with different names?

Tag consolidation merges similar tags using mapping rules—for example, converting ai-agents and AI_agents into a single ai/agents tag. The script identifies duplicates and applies standardized names across all frontmatter and inline tags.

Does tag normalization work with multilingual content in Obsidian?

Yes, the normalizer handles English and Korean content, applying consistent taxonomy rules across mixed-language vaults while preserving language-specific semantic meaning in tag hierarchies.

What output does the tag analysis report provide?

The analysis report shows tag usage statistics, identifies duplicates and inconsistencies, and highlights tags that need standardization. Review this before applying changes to ensure mappings align with your vault's taxonomy.

Do I need programming knowledge to run tag normalization in Obsidian?

The tag_standardizer.py script handles the normalization workflow, but you need basic familiarity with running Python scripts. Mapping rules can be configured without coding to enforce your vault's tag standards.