Skill Tree Generator
maipianworni/SkillTree
Estrutura hierárquica de skills para agentes IA com carregamento sob demanda
Ver no GitHubGerador de árvores de roteamento hierárquico para skills de agentes IA (Claude Code, Codex CLI, etc). Transforma skills monolíticos em estruturas ROOT → ROUTER → SKILL, permitindo carregamento sob demanda de sub-capacidades e evitando sobrecarga de contexto. Suporta três modos: decomposição de skill único, agregação multi-skill com desambiguação e expansão incremental.
Instalação
npx convez-ai maipianworni/SkillTree1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Organizar skills complexos em árvores roteáveis para Claude Code e Codex CLI
- Agregar múltiplos skills evitando duplicação de instruções no contexto
- Gerenciar expansão incremental de capacidades em agentes com suporte AGENTS.md
Veredito

Ferramenta especializada e bem arquitetada para otimizar organização de skills em agentes IA, reduzindo sobrecarga de contexto. Implementação em Bash puro com zero dependências é elegante, mas documentação em chinês limita acessibilidade para público brasileiro.
README
A tradução para o português deste README ainda está na fila.
Skill Tree Generator
⚠️ Research Preview
一个把庞杂 skill 聚合为分层路由树的工具,让 AI agent 按需加载子能力,避免一次性把所有指令塞进上下文。

支持的 Agent
- Bitfun(skill 目录
.bitfun/skills/,记忆文件AGENTS.md) - Claude Code(原生支持,skill 目录
.claude/skills/,记忆文件CLAUDE.md) - Codex CLI(通过
AGENTS.md注入路由协议,skill 目录可自定义,推荐.agent/skills/) - OpenClaw(skill 目录
.openclaw/skills/,记忆文件AGENTS.md) - OpenCode(skill 目录
.opencode/skills/,记忆文件AGENTS.md) - Hermes(skill 目录
.hermes/skills/,记忆文件AGENTS.md) - 其他读取
AGENTS.md的 agent(Cursor、Aider、Jules 等)同理
脚本用法
用法 A:Bitfun
-
将
skill-tree-generator/放到工程.bitfun/skills/下 -
打开 Bitfun
-
运行:
./scripts/aggregate-skills.sh .bitfun/skills --agent bitfun -
把输出的命令贴回 Claude Code(形如
/skill-tree-generator --aggregate ...) -
生成结果:
- skill-tree 写入
.bitfun/skills/{name}-tree/ - 项目根
AGENTS.md追加路由协议(若不存在则创建)
- skill-tree 写入
用法 B:Claude Code
-
将
skill-tree-generator/放到工程.claude/skills/下 -
打开 Claude Code
-
运行:
./scripts/aggregate-skills.sh .claude/skills -
把输出的命令贴回 Claude Code(形如
/skill-tree-generator --aggregate ...) -
生成结果:
- skill-tree 写入
.claude/skills/{name}-tree/ - 项目根
CLAUDE.md追加路由协议(若不存在则创建)
- skill-tree 写入
用法 C:Codex CLI
-
将
skill-tree-generator/放到工程.agent/skills/下(或自定义目录) -
一次性 安装 custom prompt,让 Codex CLI 认识
/skill-tree-generator:./scripts/install-codex-prompt.sh该脚本会把
SKILL.md拷到~/.codex/prompts/skill-tree-generator.md -
运行:
./scripts/aggregate-skills.sh .agent/skills --agent codex -
把输出的命令贴回 Codex CLI
-
生成结果:
- skill-tree 写入
.agent/skills/{name}-tree/ - 项目根
AGENTS.md追加路由协议(若不存在则创建)
- skill-tree 写入
如果你不想安装 custom prompt,也可以直接在 Codex 里让它读
SKILL.md并执行聚合命令,脚本输出里会提示具体写法。
用法 D:OpenCode
-
将
skill-tree-generator/放到工程.opencode/skills/下(或自定义目录) -
运行:
./scripts/aggregate-skills.sh .opencode/skills --agent opencode -
按提示将输出的指令贴回 OpenCode(形如
Read .../SKILL.md and execute: /skill-tree-generator --aggregate ...) -
生成结果:
- skill-tree 写入
.opencode/skills/{name}-tree/ - 项目根
AGENTS.md追加路由协议(若不存在则创建)
- skill-tree 写入
用法 E:OpenClaw
-
将
skill-tree-generator/放到工程.openclaw/skills/下(或自定义目录) -
运行:
./scripts/aggregate-skills.sh .openclaw/skills --agent openclaw -
按提示将输出的指令贴回 OpenClaw(形如
/skill-tree-generator --aggregate ...) -
生成结果:
- skill-tree 写入
.openclaw/skills/{name}-tree/ - 项目根
AGENTS.md追加路由协议(若不存在则创建)
- skill-tree 写入
用法 F:Hermes
-
将
skill-tree-generator/放到工程.hermes/skills/下(或自定义目录) -
运行:
./scripts/aggregate-skills.sh .hermes/skills --agent hermes -
按提示将输出的指令贴回 Hermes(形如
/skill-tree-generator --aggregate ...) -
生成结果:
- skill-tree 写入
.hermes/skills/{name}-tree/ - 项目根
AGENTS.md追加路由协议(若不存在则创建)
- skill-tree 写入
直接使用Skill
1. Single Skill to Skill Tree
/skill-tree-generator skill
2. Multiple Skill to Skill Tree
/skill-tree-generator --aggregate skill1,skill2,... [--domain domain-name]
3. Update Skill Tree
/skill-tree-generator --update tree-path --add skill
路径约定
| Agent | Skill 目录 | 记忆文件 |
|---|---|---|
| Bitfun | .bitfun/skills/ | AGENTS.md |
| Claude Code | .claude/skills/ | CLAUDE.md |
| Codex CLI | .agent/skills/ | AGENTS.md |
| OpenClaw | .openclaw/skills/ | AGENTS.md |
| OpenCode | .opencode/skills/ | AGENTS.md |
| Hermes | .hermes/skills/ | AGENTS.md |
同一仓库想让两种 Agent 都用?
推荐做法(只维护一份):
# skill 目录用 Codex 风格,软链让 Claude Code 也能发现
ln -s .agent/skills .claude/skills
# 记忆文件共用一份
ln -s AGENTS.md CLAUDE.md
引用
路由协议模板见 skill-tree-generator/references/validation_template.md 的 Check 1。
Skill Tree推荐用法
- 记忆文件(例如CLAUDE.md)放在根目录,查看是否包含上述“引用”中路由协议模版的内容。
- skills目录(例如.claude/skills)下生成Skill Tree以后,将其他skill清空,可以更好的测试Skill Tree的效果。
- 运行任务或者输入prompt,测试能否通过Skill Tree的路由功能“触发”相关的Skill。
路由追踪 [可选]
- 当用户 prompt 包含 "路由调试" / "debug routing" / "路由追踪" 时,激活路由追踪模式,该模式可输出路由追踪日志,可查看skill-tree是否实际触发到了用户需要的skill节点。
- 正常模式(默认):不输出任何路由信息,直接执行。