onboarding

Onboarding

Learn how to use the Taxonomy Creation Plugin: what it does, how to invoke each skill, the directory structure, and a worked example.

When to use

• "How do I use this plugin?"
• "Show me an example of creating and loading a taxonomy"
• "Where does the data go?"

Procedure

What this plugin does

The Taxonomy Creation Plugin generates and manages lookup tables and hierarchical taxonomies:

• Standard taxonomies: ISO 3166 countries, ISO 4217 currencies, ISO 639 languages, US states, Canadian provinces, IANA timezones, HTTP status codes, MIME types.
• Custom taxonomies: From a natural-language spec (e.g., "types of evaluations", product categories, content classifications).
• Hierarchical taxonomies: Parent/child trees (categories/subcategories, organizational structures).
• Load & export: Push to Postgres, SQLite, MySQL; or export to CSV, JSON, NDJSON, SQL, YAML.

Data directory structure

All data lives under:

${CLAUDE_USER_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/claude-plugins}/taxonomy-creation/
├── data/                    # Generated taxonomies, ready-to-load
│   ├── countries/
│   │   ├── countries-iso-3166-1.csv
│   │   ├── countries-iso-3166-1.json
│   │   ├── README.md        # Schema and source documentation
│   │   └── exports/         # Alternative formats (JSON, SQL, NDJSON, etc.)
│   └── eval-types/          # Custom taxonomy example
├── cache/                   # Cached standard datasets (30-day TTL)
├── state/                   # Operational logs
│   ├── loads/               # Load operation logs
│   ├── validations/         # Validation reports
│   └── exports/             # Export operation logs
└── config.json              # (Optional) settings: paths, dataset sources, pins

No default config.json is required; all operations are self-contained.

Typical workflow

1. Generate a taxonomy:
   • generate-standard — Pull ISO countries, currencies, languages, or other standard dataset.
   • generate-from-spec — Build a custom taxonomy from a description.
   • hierarchical-taxonomies — Create a tree structure (categories/subcategories).