taxonomize

Migrate flat vaults to hierarchical and faceted tag and folder schemes.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/hodor/claude-compass --skill taxonomize
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: taxonomize
Source: https://github.com/hodor/claude-compass/tree/main/plugin/skills/taxonomize
Command: npx skills add https://github.com/hodor/claude-compass --skill taxonomize

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps organize your vault by migrating flat specs to a hierarchical and faceted scheme, improving navigation and discoverability.

Core Features & Use Cases

  • Bulk Migrate: Converts flat vaults to a structured format with faceted tags and folder hierarchy.
  • Tag Vocabulary Analysis: Proposes tag synonyms, removals, additions, and implicit tags.
  • Folder Grouping: Suggests folder promotions and groupings for related specs.
  • Non-Destructive: Preserves existing tags and references during migration.
  • Use Case: If you have a large number of flat specs that need to be organized into a more structured format, this Skill can help you achieve that without losing any existing information.

Quick Start

Run the taxonomize skill with the --apply flag to execute the migration proposal for your specs.

Frequently Asked Questions about taxonomize

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

FAQPage Schema
How do I reorganize a flat vault into a folder hierarchy with faceted tags?

To reorganize a flat vault, this Skill bulk migrates your documents by analyzing existing tags, proposing a faceted vocabulary, and restructuring your folder hierarchy. It improves navigation and discoverability across your knowledge base.

What's the best way to clean up project knowledge tagging in a large document vault?

The best way to clean up project knowledge tagging is using a Skill that analyzes your current tags to propose synonyms, removals, and additions. This establishes a structured, faceted vocabulary that makes related documents easier to discover.

Can I migrate my vault folder structure without losing existing tags and references?

Yes, you can migrate your vault folder structure without losing existing tags. The migration is non-destructive, preserving all current tags and document references while promoting folders and grouping related specs together.

How do I apply a proposed tag vocabulary and folder grouping to my vault?

To apply a proposed tag vocabulary and folder grouping, run the taxonomize Skill with the `--apply` flag. This executes the migration proposal, converting your flat specs into a structured, hierarchical format.

When do I need to convert flat specs to a hierarchical and faceted scheme?

You need to convert flat specs to a hierarchical and faceted scheme when navigating a large knowledge base becomes difficult. This restructuring improves document discoverability by grouping related project specs into organized folders.

Does vault organization with faceted tags support bulk migration of all existing documents?

Yes, vault organization with faceted tags supports bulk migration of all existing documents. It analyzes your entire flat vault to suggest tag improvements and folder promotions, restructuring everything simultaneously without data loss.