Skill Tree Generator

Скилл превращает груду скиллов в дерево маршрутизации, чтобы агент загружал только нужные листья

  • 66 ★ репозитория
  • Последний коммит
Скилл

Расширенный доступ

Почему такой уровень

  • Скилл перестраивает каталог скиллов и дописывает протокол маршрутизации в корневой `CLAUDE.md`
Все причины и проверки

openbitfun/skill_tree

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/skill-tree-generator

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Скилл перестраивает каталог скиллов и дописывает протокол маршрутизации в корневой `CLAUDE.md`

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Skill Tree Generator перестраивает плоский набор скиллов в иерархию крошечных файлов маршрутизации: `ROOT.md`, затем `ROUTER.md` ветки и листья `SKILL.md`. Агент сначала читает короткую таблицу в корне, сужает выбор по ветвям и открывает только подходящие листья. Узкий запрос попадает в один лист, запрос на несколько тем разворачивается в несколько листьев, которые читаются параллельно. У скилла три режима. Генерация (`/skill-tree-generator <скилл>`) разбивает один громоздкий скилл на дерево. Агрегация (`/skill-tree-generator --aggregate a,b,... --domain x`) собирает много скиллов в одно дерево, дедуплицируя общие возможности. Обновление (`/skill-tree-generator --update <путь> --add <скилл>`) дописывает скилл в готовое дерево. Для быстрого старта в Claude Code достаточно скопировать `skill-tree-generator` в `.claude/skills/` и запустить `./scripts/aggregate-skills.sh .claude/skills`: скрипт напечатает точную команду, которую вставляют в агента. Результат лежит в `.claude/skills/{имя}-tree/`, а протокол маршрутизации дописывается в корневой `CLAUDE.md`. Скрипт и скилл написаны на Bash и Markdown без зависимостей.

Для кого. Пользователям с десятками установленных скиллов, у которых описания перегружают контекст и мешают агенту выбирать нужный.

Подходит, если

  • В `.claude/skills` накопились десятки скиллов, и контекст забит их описаниями
  • Один большой скилл надо разбить на тематические ветви с отдельными листьями
  • Несколько скиллов из разных областей надо слить в единое дерево без дублей
  • В готовое дерево нужно дописать новый скилл через режим обновления

Не подходит, если

  • Скиллов всего несколько: дерево маршрутизации добавит лишний шаг
  • Нужен жесткий порядок выполнения шагов: дерево выбирает листья по смыслу запроса
  • Агент не читает `AGENTS.md` или `CLAUDE.md` и не способен идти по файлам маршрутизации

Пример запроса к агенту

/skill-tree-generator --aggregate web-dev,data-pipeline,pdf-tools,seo-audit --domain work

Ограничения

Скилл переписывает структуру ваших скиллов и дописывает протокол в корневой `CLAUDE.md`, поэтому перед запуском стоит сделать резервную копию каталога или закоммитить его в Git. Качество маршрутизации зависит от того, как агент разберет описания, и в спорных случаях лист придется выбирать вручную. Для Codex CLI нужна разовая установка командой `./scripts/install-codex-prompt.sh`, для других агентов указывают флаг `--agent` и каталог. Формат запуска разных агентов отличается: одним нужна голая команда `/skill-tree-generator`, другим префикс `Read ... and execute`. Последние изменения в репозитории датируются августом 2026.

Как отключить. Удалите папку `skill-tree-generator` и созданные деревья `{имя}-tree/` из каталога скиллов, затем уберите протокол маршрутизации из `CLAUDE.md`.

Частые вопросы

Как поставить Skill Tree Generator в Claude Code?

Склонируйте репозиторий и выполните `cp -r skill-tree-generator .claude/skills/`. Затем запустите `./scripts/aggregate-skills.sh .claude/skills` и вставьте напечатанную команду в Claude Code.

Какие агенты поддерживаются?

Claude Code, Codex CLI, OpenCode, OpenClaw, Bitfun и Hermes, а также агенты, читающие `AGENTS.md`, например Cursor, Aider и Jules. Каталог и флаг `--agent` у сканера свои для каждого.

Что делает режим агрегации?

`/skill-tree-generator --aggregate a,b,... --domain x` собирает перечисленные скиллы в одно дерево и убирает дубли общих возможностей, чтобы они жили в одной ветви.

Как добавить скилл в готовое дерево?

Выполните `/skill-tree-generator --update <путь-к-дереву> --add <скилл>`. Дерево пополняется поэтапно, без полной пересборки.

Нужны ли зависимости?

Нет, скилл и скрипты написаны на Bash и Markdown. Для Codex CLI нужна разовая установка prompt-файла в `~/.codex/prompts/`.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

11 скиллов для Claude Code: написание SKILL.md, улучшение промптов, рефакторинг, ревью правок и планирование в файлах.

СкиллМинимальный доступ286Звезды репозитория

Метаскилл превращает разрозненные правила в AGENTS.md, CLAUDE.md и Cursor в один проверяемый скилл проекта с маршрутами задач.

ПлагинРасширенный доступ622Звезды репозитория

Рабочая папка для Claude Code, где агент задает вопросы и пишет новый скилл по рекомендациям Anthropic, а не по памяти.

СкиллРасширенный доступ242Звезды репозитория

Skill Flow собирает скиллы из разных источников в группы и разворачивает их сразу на десятки агентов: Claude Code, Cursor, Codex.

CLIРасширенный доступ265Звезды репозитория

Скилл для создания скиллов, который проверяет их работой: замер до и после, регрессионные тесты и аудит экосистемы

СкиллРасширенный доступ918Звезды репозитория

Настольное приложение и CLI, чтобы ставить, синхронизировать и раскладывать скиллы агентов между Claude Code, Codex, Cursor и другими инструментами

CLIРасширенный доступ7,5 тыс.Звезды репозитория

Коротко о README

README объясняет проблему раздувания контекста, показывает дерево до и после, три режима, быстрый старт на 60 секунд для Claude Code, таблицу команд для других агентов и устройство репозитория.

Бейдж для README

Исходный SKILL.md

---
name: skill-tree-generator
description: Generates, aggregates, and extends modular skill-trees with hierarchical routing. Supports three modes — (1) convert a monolithic skill into a tree with ROOT.md/ROUTER.md/SKILL.md, (2) aggregate multiple skills into a unified cross-domain tree with shared leaves and disambiguation, (3) incrementally update an existing tree by adding new skills. Use when users need to restructure, merge, or extend skills into context-aware, load-on-demand hierarchies.
---

# Skill Tree Generator

## Usage

```
/skill-tree-generator <skill-name-or-skill-path-or-description>
/skill-tree-generator --aggregate skill1,skill2,... [--domain domain-name] [--no-decompose]
/skill-tree-generator --update <tree-path> --add <skill>
```

| 输入特征 | Mode | 描述 |
|---------|------|------|
| 单个 skill 路径/描述,无特殊 flag | **Mode 1** | 将单体 skill 转为路由树 |
| `--aggregate skill1,skill2,...` | **Mode 2** | 聚合多个 skill 为统一跨域树 |
| `--update <tree-path> --add <skill>` | **Mode 3** | 增量更新已有 tree |

**可选 flag**:

| Flag | 适用 Mode | 作用 |
|------|----------|------|
| `--domain <name>` | Mode 2 | 声明同域聚合,ROOT.md 按域内能力差异路由 |
| `--no-decompose` | Mode 2 | 跳过 Step A1 能力拆解,所有源 skill 一律按单叶处理。仅当源 skill 已预先拆到原子粒度时使用 |

## Overview

Transform monolithic skills into modular, hierarchical skill-trees (ROOT.md → ROUTER.md → SKILL.md) with dynamic routing. Use when:
- A skill has grown too complex and needs modularization
- Multiple distinct workflows exist within a single skill
- Multiple related skills need to be unified under one routing tree
- Cross-domain workflows span multiple skills
- Overlapping capabilities across skills need deduplication
- An existing skill-tree needs new skills or capabilities added

## Strict Conformance

Before creating or modifying tree output, read and follow `references/strict_conformance.md`. Do not use substitute workflows, fast versions, heuristic-only splitting, or partial validation. If full conformance is impractical, stop and report the blocker before continuing.

---

## Mode 1: Single Skill Tree Generation

Сообщить о проблеме