taxonomy-manager

Audit Hugo taxonomy terms and generate a health report.

415|44|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/notque/claude-code-toolkit --skill taxonomy-manager
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: taxonomy-manager
Source: https://github.com/notque/claude-code-toolkit/tree/main/skills/taxonomy-manager
Command: npx skills add https://github.com/notque/claude-code-toolkit --skill taxonomy-manager

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Audit and maintain blog taxonomy (categories/tags) for consistency, SEO, and navigation: scan content, detect orphans and duplicates, merge and rename terms, verify builds. Use when user asks to "audit tags", "fix taxonomy", "consolidate categories", "merge tags", or "clean up taxonomy". Do NOT use for writing new content, individual post SEO optimization, or major content restructuring.

Core Features & Use Cases

  • Audit all categories and tags across a Hugo site's content directory
  • Count posts per taxonomy term and generate visual usage statistics
  • Detect orphan tags (single-use), empty categories, case variations, and synonym pairs
  • Suggest and execute merge, rename, add, and remove operations on taxonomy terms
  • Show before/after diffs for every proposed change
  • Verify Hugo build integrity after modifications

Quick Start

Use the taxonomy audit workflow to scan content, analyze terms, and generate a health report.

Frequently Asked Questions about taxonomy-manager

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

FAQPage Schema
How do I audit Hugo taxonomy for orphan tags and empty categories?

To audit Hugo taxonomy, scan your content directory to index all categories and tags. This identifies orphan tags, empty categories, and case variations, mapping each term to its posts for a comprehensive health report.

What is the best way to consolidate duplicate blog tags and categories?

Consolidating duplicate blog tags involves detecting case and plural variations across your content. You can then suggest and execute merge or rename operations on taxonomy terms, verifying build integrity afterward.

Can I detect case variations and synonym pairs in my blog taxonomy automatically?

Yes, taxonomy audits automatically detect case variations and synonym pairs among your tags and categories. The system indexes all terms and maps usage statistics to highlight potential duplicates for consolidation.

How do I merge and rename taxonomy terms without breaking my content builds?

You can merge and rename taxonomy terms by executing suggested operations across your content directory. After modifications are applied, a Hugo build verification ensures navigation and site integrity remain intact.

Does this taxonomy audit apply to major content restructuring workflows?

No, this taxonomy audit specifically targets tag and category consistency, SEO, and navigation. It should not be used for writing new content, individual post SEO optimization, or major content restructuring.

Why do I need to verify Hugo build integrity after modifying taxonomy terms?

Verifying Hugo build integrity after modifying taxonomy terms ensures that merging, renaming, or removing categories and tags has not broken site navigation or generated configuration errors across your content directory.