name: taxonomy-generate description: Develop hierarchical classification systems. Creates parent-child categorical structures for content organization. required_roles: scribe: roles/scribe.editor personas: [information-architect, taxonomist, knowledge-manager]
Generate Taxonomy Skill
Develop a hierarchical classification system or taxonomy for a knowledge base or content repository. This skill creates parent-child categorical structures to organize content effectively.
Inputs
PATH- The content source to analyze (e.g., "/knowledge-base")FACETED- (Optional) Boolean, whether to create a faceted classification (multiple dimensions) (default: false)BUSINESS_ALIGNMENT- (Optional) Boolean, whether to align with specific business goals/terminology (default: true)USER_TESTING- (Optional) Boolean, whether to include user validation methodologies in the output (default: false)
Workflow
Step 1: Content Analysis & Term Extraction
Analyze the content at PATH to identify key topics, subjects, and categories.
- Cluster documents by similarity.
- Extract common tags and keywords.
Step 2: Structure Design
Organize the extracted concepts into a hierarchy.
- Hierarchical: Define Broader Terms (Parent) and Narrower Terms (Child).
- Faceted (if enabled): Define dimensions (e.g., Topic, Format, Audience, Region).
Step 3: Business & User Alignment
- Align terms with business vocabulary (if
BUSINESS_ALIGNMENTis true). - If
USER_TESTINGis true, generate a plan for card sorting or tree testing to validate the structure.
Step 4: Taxonomy Definition
Output the defined taxonomy.
Required Outputs
A TAXONOMY_DEFINITION document (e.g., in markdown or YAML format) containing:
- Taxonomy Tree: Visual or indented list of categories.
- Facets (if requested): Definitions of classification dimensions.
- Rules: Guidelines for applying the taxonomy.
- Testing Plan (if requested): Methodologies for validation.
Quick Reference
- Purpose: Systematically classify content for retrieval optimization.
- Types: Hierarchical (Tree) vs. Faceted (Matrix).