O que SkillTree faz?
Gerador de árvore de roteamento hierárquico de Skills para agentes de IA (Claude Code / Codex CLI, etc.). Divide/agrega Skills monolíticas em uma estrutura ROOT → ROUTER → SKILL, permitindo que o agente carregue capacidades conforme a intenção do usuário, evitando sobrecarregar o contexto. Suporta três modos: decomposição de Skill único, agregação de múltiplos Skills (com resolução de ambiguidades) e expansão incremental. Compatível com as convenções de caminho .claude/skills e .agent/skills. Puramente em Markdown + Bash, zero dependências.
Propósito
O SkillTree ajuda você a estruturar Skills complexos para agentes de IA. Em vez de ter um único Skill enorme que ocupa todo o contexto do agente, você pode dividi-lo em uma árvore de Skills menores e mais focados. O agente então carrega apenas os Skills necessários com base no comando do usuário.
Estrutura da Árvore
- ROOT: O Skill raiz que contém a lógica de roteamento. Ele analisa a intenção do usuário e determina qual ROUTER ou SKILL carregar.
- ROUTER: Nós intermediários que agrupam Skills relacionados. Eles podem ter seus próprios sub-ROUTERs ou SKILLs.
- SKILL: Nós folha contendo instruções específicas para uma tarefa.
Modos de Operação
1. Decomposição de Skill Único
Divide um Skill monolítico em uma árvore. Útil quando um único Skill se tornou muito grande e complexo.
# Exemplo: Decompor um skill 'deploy' em uma árvore
./skilltree decompor --skill deploy --output ./skills
2. Agregação de Múltiplos Skills
Combina vários Skills independentes em uma única árvore, com resolução automática de ambiguidades.
# Exemplo: Agregar skills 'test', 'build', 'deploy'
./skilltree agregar --skills test,build,deploy --output ./skills
3. Expansão Incremental
Adiciona novos Skills a uma árvore existente sem precisar recriá-la do zero.
# Exemplo: Adicionar skill 'monitor' a uma árvore existente
./skilltree expandir --skill monitor --tree ./skills
Compatibilidade de Caminhos
O SkillTree é compatível com ambas as seguintes convenções de caminho:
.claude/skills.agent/skills
Isso garante que ele funcione com a maioria dos agentes de IA populares, como Claude Code e Codex CLI.
Dependências
Nenhuma. A ferramenta é implementada puramente em Markdown e Bash, sem dependências externas.
Exemplo de Uso
- Crie um diretório de Skills.
- Coloque seus Skills existentes lá.
- Execute o SkillTree no modo desejado.
- O agente carregará automaticamente apenas os Skills relevantes com base na intenção do usuário.
Contribuição
Sinta-se à vontade para enviar problemas ou pull requests para melhorar o SkillTree.
Licença
MIT