Diagrama ilustrativo · a meta-skill é a caixa que contém e conecta um ecossistema de skills; cada skill tem nível e raridade, e o conjunto acumula XP.
🧬 O que é uma meta-skill
Até agora você construiu skills que fazem coisas. Uma meta-skill é diferente: ela não executa uma tarefa de domínio — ela governa como as outras skills nascem, ganham peso e se conectam. Taproot é exatamente isso: um CLAUDE.md que ensina o agente a ficar melhor ao longo do tempo.
🎮 O agente vira um personagem
Taproot dá ao seu agente atributos de RPG — e isso não é enfeite, é mecânica de incentivo:
- •Nome e classe — uma identidade que persiste entre sessões.
- •Nível e XP — progresso mensurável que cresce quando skills são criadas e usadas.
- •Árvore de skills — um ecossistema interconectado que você abre no navegador.
💡 Por que CLAUDE.md, não SKILL.md
Uma skill comum (SKILL.md) é descoberta e disparada por contexto. Uma meta-skill mora no CLAUDE.md — o arquivo que está sempre no contexto do agente naquele projeto. É o lugar certo para regras que devem reger todo o comportamento, e não apenas uma tarefa. Por isso ela "governa" em vez de "executar".
Não executa tarefa.
Sempre no contexto.
Nível, XP, classe.
Visível no navegador.
⚡ Benefício 1: skills auto-geradas
O primeiro benefício é o coração do conceito: skills que se geram sozinhas. Quando o agente pega o mesmo erro duas vezes, cria uma correção permanente. Quando percebe um padrão recorrente, formaliza numa skill reutilizável. As skills ganham XP, têm níveis de raridade (de Comum a Lendária) e se ramificam num ecossistema conectado.
Erro pego duas vezes → correção permanente
Na primeira vez é acidente. Na segunda, o agente entende que é um padrão e cria uma regra fixa para nunca mais cometer.
Padrão recorrente → skill formalizada
Algo que você faz repetidamente vira uma skill com nome, descrição e gatilhos — parte do arsenal.
XP cria pesos que incentivam o loop
As pontuações de XP geram pesos que incentivam o ciclo de construção de skills — o sistema é desenhado para se alimentar.
| Raridade | O que costuma significar |
|---|---|
| Comum | Correção pequena, usada cedo e com frequência. |
| Incomum / Rara | Padrão de domínio que se provou útil em vários casos. |
| Lendária | Skill central, muito usada e conectada a várias outras. |
💡 A regra de ouro: "duas vezes"
O limiar de "pegar o mesmo erro duas vezes" é deliberado. Uma vez pode ser ruído; duas vezes é sinal. Use esse mesmo gatilho na sua meta-skill — ele evita criar skill para tudo (ruído) e garante que o que vira skill realmente se repete.
📐 Benefício 2: planeja antes de construir
O segundo benefício combate o vício mais comum dos agentes: sair codando em cima de premissas erradas. Taproot roda uma análise de lacunas sobre as próprias suposições e propõe um plano de build antes de escrever uma linha de código. Ela pergunta o que não sabe em vez de chutar.
✓ Agente que planeja
- ✓Faz gap analysis das próprias suposições.
- ✓Propõe um plano de build antes de codar.
- ✓Pergunta o que não sabe — explicitamente.
- ✓Você corrige a rota no plano, barato.
✗ Agente que chuta
- ✗Assume requisitos e começa a escrever código.
- ✗Descobre as lacunas só quando o build quebra.
- ✗Você corrige a rota no código pronto, caro.
- ✗Retrabalho vira a norma.
🔎 Gap analysis na prática
O agente lista o que precisa saber, marca o que já sabe, identifica o que falta e transforma as lacunas em perguntas objetivas. Só depois propõe o plano. É o mesmo princípio do "medir duas vezes, cortar uma" — aplicado a software.
Listadas, não ocultas.
Viram perguntas.
Antes do código.
Barata, no plano.
🌳 Benefício 3: uma árvore que você vê
O terceiro benefício é o que prende a atenção: uma árvore de skills que você realmente vê. Abra o HTML gerado e acompanhe o crescimento do agente — cartão de perfil, arsenal de skills e um grafo de rede mostrando como as skills se conectam. Níveis, XP, progressão de classe, tudo visual.
Recriação ilustrativa da página do Skill Tree (não é um screenshot real):
💡 Por que tornar o progresso visível importa
Quando você vê o que o agente sabe — e o que falta — você toma decisões melhores: onde investir, qual skill ainda está fraca, quais se conectam. Visibilidade muda comportamento. É o mesmo motivo de termos dashboards em vez de logs crus.
Nome, classe, nível.
Skills por raridade.
Como se conectam.
XP e progressão.
📥 Como usar: do CLAUDE.md à árvore
O fluxo de adoção é surpreendentemente curto para algo tão poderoso. Pegue o CLAUDE.md do repositório, largue na raiz do projeto, abra o Claude Code, faça um onboarding de ~30 segundos, construa algo e abra a árvore.
Largue o CLAUDE.md na raiz
O arquivo vai para a raiz do seu projeto. A partir daí, ele está sempre no contexto do agente naquele repositório.
Abra o Claude Code e faça o onboarding
~30 segundos: o agente ganha nome, classe e estado inicial. Você não precisa configurar nada manualmente.
Construa algo → abra o skill tree
Trabalhe normalmente. O agente captura padrões e ganha XP. Abra a página de visualização e veja a árvore crescer.
# Coloque o CLAUDE.md na raiz e abra o Claude Code. # Depois, dispare o onboarding: "Inicie o onboarding do Taproot: me dê nome e classe ao agente, crie o estado inicial e me explique como ganho XP." # Trabalhe normalmente. Quando quiser ver a evolução: "Abra/atualize a árvore de skills (skill tree)."
🧩 Extras inclusos
O repositório também traz a página de visualização do Skill Tree e um addon opcional de orquestração multi-agente — o que conecta naturalmente ao tema do próximo módulo (memória entre agentes).
🔮 A visão de futuro
Vale olhar para onde a ideia pode chegar — não porque tudo isso já existe, mas porque pensar a visão ajuda você a desenhar a sua própria meta-skill com espaço para crescer. A proposta aponta para quatro direções.
🛒 Marketplace de skills
Compartilhar e vender skills individuais que o agente gerou. Import/export com um único arquivo: "esta é a skill que meu agente criou depois de pegar o mesmo erro 3 vezes".
👤 Perfis de comunidade
Cada pessoa ganha uma vitrine mostrando o personagem do agente, arsenal e stats. Navegar pelos agentes dos outros e construir sobre o que a comunidade aprende.
⚔️ Comparação de agentes
Sobrepor árvores de skills lado a lado. Comparar o crescimento do seu agente com o de outros, em fichas de stats no estilo RPG.
🧬 Fusão de skills
Quando duas skills disparam juntas com frequência, elas se fundem numa skill composta. O agente não só coleciona skills — ele as sintetiza.
💡 O que levar para a sua meta-skill
Mesmo sem marketplace, três ideias são aplicáveis hoje: (1) dar identidade persistente ao agente, (2) incentivar a criação de skills com algum tipo de pontuação, e (3) deixar o progresso visível. Comece pequeno; a visão grande dá o norte.
🏋️ Exercícios práticos
Defina a regra do "duas vezes"
Escreva, em uma frase, a regra que vai disparar a criação de uma skill no seu agente. Defina também o que conta como "mesmo erro" no seu domínio.
Desenhe o esquema de XP
Defina quanto XP cada ação dá (criar skill, usar skill existente, corrigir erro) e os limiares de nível. Liste 3 raridades e o critério de cada uma.
Crie um CLAUDE.md de meta-skill rodável
Escreva um CLAUDE.md mínimo que dê identidade ao agente e a regra de criação de skill. Esqueleto:
Salve como CLAUDE.md na raiz de um projeto de teste, abra o Claude Code e construa qualquer coisa. Depois peça "abra a skill tree".
📌 Resumo do módulo
Próximo módulo:
6.3 — 🧠 Multi-Agent Memory + /sessionend