hierarchical-taxonomy-clustering — скилл для Claude Code: установка
Скилл hierarchical-taxonomy-clustering для Claude Code объединяет похожие категории из разных источников в многоуровневую таксономию. Анализирует товары по общей структуре категорий.
Apache-2.0 1 установок ★ 1 933 обновлён 2026-10-24
npx skills add benchflow-ai/skillsbench --skill hierarchical-taxonomy-clustering -a claude-codeЧто делает hierarchical-taxonomy-clustering
Скилл обрабатывает пути категорий из нескольких источников: чистит и нормализует названия, объединяет данные, затем группирует пути по сходству. В результате DataFrame получает уровни единой таксономии, а экспорт создаёт CSV со всеми записями и отдельный файл со структурой категорий.
Работа разделена на четыре шага: подготовка данных, генерация взвешенных эмбеддингов, рекурсивная кластеризация и экспорт. Для расчёта нужны Python-пакеты pandas, numpy, scipy, sentence-transformers, nltk и tqdm; также скрипт загружает наборы wordnet и omw-1.4 через NLTK. Без этих наборов лемматизация не будет настроена как в инструкции.
Запустить весь процесс можно через scripts/pipeline.py. Для названий категорий применяются частотность слов и лемматизация; уровни кластеризуются с косинусным расстоянием. В README приведены ориентиры по числу кластеров, а не жёсткие требования к размеру таксономии.
Какие задачи решает
- объединить похожие пути категорий из разных источников
- свести названия категорий к общей многоуровневой структуре
- подготовить CSV с назначенными категориями и деревом таксономии
- сопоставить товары по категориям для анализа показателей
Примеры запросов агенту
- Объедини пути категорий из нескольких источников в общую таксономию.
- Подготовь данные и запусти полный процесс через
scripts/pipeline.py. - Сгруппируй категории по уровням и экспортируй итоговые CSV-файлы.
Как установить hierarchical-taxonomy-clustering
1Через Skills CLI (Vercel)
npx skills add benchflow-ai/skillsbench --skill hierarchical-taxonomy-clustering -a claude-code2Вручную: положить файлы
~/.claude/skills/hierarchical-taxonomy-clustering/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/hierarchical-taxonomy-clustering/
1Через Skills CLI (Vercel)
npx skills add benchflow-ai/skillsbench --skill hierarchical-taxonomy-clustering -a codex2Вручную: положить файлы
.agents/skills/hierarchical-taxonomy-clustering/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add benchflow-ai/skillsbench --skill hierarchical-taxonomy-clustering -a cursor2Вручную: положить файлы
.cursor/skills/hierarchical-taxonomy-clustering/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install benchflow-ai/skillsbench tasks-extra/taxonomy-tree-merge/environment/skills/hierarchical-taxonomy-clustering2Вручную: положить файлы
.github/skills/hierarchical-taxonomy-clustering/SKILL.md1Через Skills CLI (Vercel)
npx skills add benchflow-ai/skillsbench --skill hierarchical-taxonomy-clustering -a gemini-cli2Командой платформы
gemini skills install https://github.com/benchflow-ai/skillsbench --path tasks-extra/taxonomy-tree-merge/environment/skills/hierarchical-taxonomy-clusteringВручную: положить файлы
.devin/skills/hierarchical-taxonomy-clustering/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add benchflow-ai/skillsbench --skill hierarchical-taxonomy-clustering -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о hierarchical-taxonomy-clustering
Как установить hierarchical-taxonomy-clustering в Claude Code?
Выполните npx skills add benchflow-ai/skillsbench --skill hierarchical-taxonomy-clustering -a claude-code. Файл скилла находится по пути ~/.claude/skills/hierarchical-taxonomy-clustering/SKILL.md.
Что делает hierarchical-taxonomy-clustering?
Он группирует похожие пути категорий из разных источников и формирует общую многоуровневую таксономию. Результаты можно выгрузить в CSV.
Какие Python-пакеты нужны для работы скилла?
Установите pandas, numpy, scipy, sentence-transformers, nltk и tqdm. Для лемматизации инструкция также загружает wordnet и omw-1.4 через NLTK.
Исходный текст
SKILL.md · Apache-2.0
---
name: hierarchical-taxonomy-clustering
description: Build unified multi-level category taxonomy from hierarchical product category paths from any e-commerce companies using embedding-based recursive clustering with intelligent category naming via weighted word frequency analysis.
---
# Hierarchical Taxonomy Clustering
Create a unified multi-level taxonomy from hierarchical category paths by clustering similar paths and automatically generating meaningful category names.
## Problem
Given category paths from multiple sources (e.g., "electronics -> computers -> laptops"), create a unified taxonomy that groups similar paths across sources, generates meaningful category names, and produces a clean N-level hierarchy (typically 5 levels). The unified category taxonomy could be used to do analysis or metric tracking on products from different platform.
## Methodology
1. **Hierarchical Weighting**: Convert paths to embeddings with exponentially decaying weights (Level i gets weight 0.6^(i-1)) to signify the importance of category granularity
2. **Recursive Clustering**: Hierarchically cluster at each level (10-20 clusters at L1, 3-20 at L2-L5) using cosine distance
3. **Intelligent Naming**: Generate category names via weighted word frequency + lemmatization + bundle word logic
4. **Quality Control**: Exclude all ancestor words (parent, grandparent, etc.), avoid ancestor path duplicates, clean special characters
## Output
DataFrame with added columns:
- `unified_level_1`: Top-level category (e.g., "electronic | device")
- `unified_level_2`: Second-level category (e.g., "computer | laptop")
- `unified_level_3` through `unified_level_N`: Deeper levels
Category names use ` | ` separator, max 5 words, covering 70%+ of records in each cluster.
## Installation
```bash
pip install pandas numpy scipy sentence-transformers nltk tqdm
python -c "import nltk; nltk.download('wordnet'); nltk.download('omw-1.4')"
```
## 4-Step Pipeline
### Step 1: Load, Standardize, Filter and Merge (`step1_preprocessing_and_merge.py`)
- **Input**: List of (DataFrame, source_name) tuples, each of the with `category_path` column
- **Process**: Per-source deduplication, text cleaning (remove &/,/'/-/quotes,'and' or "&", "," and so on, lemmatize words as nouns), normalize delimiter to ` > `, depth filtering, prefix removal, then merge all sources. source_level should reflect the processed version of the source level name
- **Output**: Merged DataFrame with `category_path`, `source`, `depth`, `source_level_1` through `source_level_N`
### Step 2: Weighted Embeddings (`step2_weighted_embedding_generation.py`)
- **Input**: DataFrame from Step 1
- **Output**: Numpy embedding matrix (n_records × 384)
- Weights: L1=1.0, L2=0.6, L3=0.36, L4=0.216, L5=0.1296 (exponential decay 0.6^(n-1))
- **Performance**: For ~10,000 records, expect 2-5 minutes. Progress bar will show encoding status.
### Step 3: Recursive Clustering (`step3_recursive_clustering_naming.py`)
- **Input**: DataFrame + embeddings from Step 2
- **Output**: Assignments dict {index → {level_1: ..., level_5: ...}}
- Average linkage + cosine distance, 10-20 clusters at L1, 3-20 at L2-L5
- Word-based naming: weighted frequency + lemmatization + coverage ≥70%
- **Performance**: For ~10,000 records, expect 1-3 minutes for hierarchical clustering and naming. Be patient - the system is working through recursive levels.
### Step 4: Export Results (`step4_result_assignments.py`)
- **Input**: DataFrame + assignments from Step 3
- **Output**:
- `unified_taxonomy_full.csv` - all records with unified categories
- `unified_taxonomy_hierarchy.csv` - unique taxonomy structure
## Usage
**Use `scripts/pipeline.py` to run the complete 4-step workflow.**
See `scripts/pipeline.py` for:
- Complete implementation of all 4 steps
- Example code for processing multiple sources
- Command-line interface
- Individual step usage (for advanced control)
© benchflow-ai · Apache-2.0 · benchflow-ai/skillsbench