One-click install
npx skills add https://github.com/CrystallizeAPI/ai --skill taxonomy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: taxonomy
Source: https://github.com/CrystallizeAPI/ai/tree/main/use-crystallize/skills/taxonomy
Command: npx skills add https://github.com/CrystallizeAPI/ai --skill taxonomy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you design and generate hierarchical topic maps so you can tag content and products consistently, then power faceted navigation, filtering, and better discovery in Crystallize.

Core Features & Use Cases

  • Topic map planning and design: Turn user filtering needs into a concrete hierarchical structure for a classification axis (e.g., colors, sizes, materials, styles, seasons).
  • topicTree generation guidance: Produce a JSON-ready tree with correct id, pathIdentifier, and required displayColor values for every topic.
  • Practical design workflow: Use clarifying questions to choose depth, exclusivity vs overlap, and whether you are classifying product attributes, content, or temporal tags.

Quick Start

Ask the taxonomy skill to generate a topicTree JSON for your storefront facet so you can tag items and configure hierarchical filtering.

Frequently Asked Questions about taxonomy

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

FAQPage Schema
How do I design a hierarchical topic tree for faceted navigation?

Designing a hierarchical topic tree for faceted navigation involves planning a classification axis for product attributes or content, then generating a topicTree JSON with URL-friendly topic ids, matching pathIdentifiers, and assigned displayColor values to enable filtering and discovery.

What is a topicTree JSON and how does it enable product filtering?

A topicTree JSON is a hierarchical structure that defines classification topics for product attributes, content categories, or temporal tags like seasons. It enables product filtering and discovery by providing pathIdentifiers and displayColor values that power faceted navigation within Crystallize PIM.

How do I generate URL-friendly topic ids and pathIdentifiers for a Crystallize taxonomy?

Generating URL-friendly topic ids and pathIdentifiers for a Crystallize taxonomy requires structuring your hierarchical topic map so that each node has a unique id and a matching pathIdentifier, ensuring every topic also receives a valid displayColor according to defined color guidelines.

Can I use this approach to classify both product attributes and temporal tags like seasons?

Yes, you can classify both product attributes and temporal tags like seasons and collections. The taxonomy design workflow uses clarifying questions to determine depth, exclusivity vs overlap, and whether you are classifying product attributes, content, or temporal tags for your storefront facet.

What's the best way to structure topic maps for brand, origin, and certification tagging?

The best way to structure topic maps for brand, origin, and certification tagging is to turn user filtering needs into a concrete hierarchical structure, assign a displayColor to every topic, and export a topicTree JSON that supports consistent content classification and faceted navigation.