convez.ai
SkillAutomaçãoIntermediário
maipianworni

Skill Tree Generator

maipianworni/SkillTree

Estrutura hierárquica de skills para agentes IA com carregamento sob demanda

Ver no GitHub
BomPluginScore · de 0 a 100

Gerador 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/SkillTree

1 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

Estrelas
66
Forks
7
Acompanhando
0
Saúde
28%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
1

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 按需加载子能力,避免一次性把所有指令塞进上下文。

Skill Tree demo

支持的 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

  1. 将 skill-tree-generator/ 放到工程 .bitfun/skills/ 下

  2. 打开 Bitfun

  3. 运行:

    ./scripts/aggregate-skills.sh .bitfun/skills --agent bitfun
    
  4. 把输出的命令贴回 Claude Code(形如 /skill-tree-generator --aggregate ...)

  5. 生成结果:

    • skill-tree 写入 .bitfun/skills/{name}-tree/
    • 项目根 AGENTS.md 追加路由协议(若不存在则创建)

用法 B:Claude Code

  1. 将 skill-tree-generator/ 放到工程 .claude/skills/ 下

  2. 打开 Claude Code

  3. 运行:

    ./scripts/aggregate-skills.sh .claude/skills
    
  4. 把输出的命令贴回 Claude Code(形如 /skill-tree-generator --aggregate ...)

  5. 生成结果:

    • skill-tree 写入 .claude/skills/{name}-tree/
    • 项目根 CLAUDE.md 追加路由协议(若不存在则创建)

用法 C:Codex CLI

  1. 将 skill-tree-generator/ 放到工程 .agent/skills/ 下(或自定义目录)

  2. 一次性 安装 custom prompt,让 Codex CLI 认识 /skill-tree-generator:

    ./scripts/install-codex-prompt.sh
    

    该脚本会把 SKILL.md 拷到 ~/.codex/prompts/skill-tree-generator.md

  3. 运行:

    ./scripts/aggregate-skills.sh .agent/skills --agent codex
    
  4. 把输出的命令贴回 Codex CLI

  5. 生成结果:

    • skill-tree 写入 .agent/skills/{name}-tree/
    • 项目根 AGENTS.md 追加路由协议(若不存在则创建)

如果你不想安装 custom prompt,也可以直接在 Codex 里让它读 SKILL.md 并执行聚合命令,脚本输出里会提示具体写法。

用法 D:OpenCode

  1. 将 skill-tree-generator/ 放到工程 .opencode/skills/ 下(或自定义目录)

  2. 运行:

    ./scripts/aggregate-skills.sh .opencode/skills --agent opencode
    
  3. 按提示将输出的指令贴回 OpenCode(形如 Read .../SKILL.md and execute: /skill-tree-generator --aggregate ...)

  4. 生成结果:

    • skill-tree 写入 .opencode/skills/{name}-tree/
    • 项目根 AGENTS.md 追加路由协议(若不存在则创建)

用法 E:OpenClaw

  1. 将 skill-tree-generator/ 放到工程 .openclaw/skills/ 下(或自定义目录)

  2. 运行:

    ./scripts/aggregate-skills.sh .openclaw/skills --agent openclaw
    
  3. 按提示将输出的指令贴回 OpenClaw(形如 /skill-tree-generator --aggregate ...)

  4. 生成结果:

    • skill-tree 写入 .openclaw/skills/{name}-tree/
    • 项目根 AGENTS.md 追加路由协议(若不存在则创建)

用法 F:Hermes

  1. 将 skill-tree-generator/ 放到工程 .hermes/skills/ 下(或自定义目录)

  2. 运行:

    ./scripts/aggregate-skills.sh .hermes/skills --agent hermes
    
  3. 按提示将输出的指令贴回 Hermes(形如 /skill-tree-generator --aggregate ...)

  4. 生成结果:

    • skill-tree 写入 .hermes/skills/{name}-tree/
    • 项目根 AGENTS.md 追加路由协议(若不存在则创建)

直接使用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

路径约定

AgentSkill 目录记忆文件
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推荐用法

  1. 记忆文件(例如CLAUDE.md)放在根目录,查看是否包含上述“引用”中路由协议模版的内容。
  2. skills目录(例如.claude/skills)下生成Skill Tree以后,将其他skill清空,可以更好的测试Skill Tree的效果。
  3. 运行任务或者输入prompt,测试能否通过Skill Tree的路由功能“触发”相关的Skill。

路由追踪 [可选]

  • 当用户 prompt 包含 "路由调试" / "debug routing" / "路由追踪" 时,激活路由追踪模式,该模式可输出路由追踪日志,可查看skill-tree是否实际触发到了用户需要的skill节点。
  • 正常模式(默认):不输出任何路由信息,直接执行。
Ver o original no GitHub

Bom para

Relacionados