Criar Subagente

Skill: Criar Subagente

Quando usar essa skill

Acione essa skill SEMPRE que o usuario quiser adicionar um novo subagente ao time. Frases gatilho:

• "cria um subagente pra X"
• "preciso de um agente especialista em Y"
• "monta um subagente novo de Z"
• "adiciona um agente novo no time"
• "expande a equipe com mais um agente"
• "quero um SDR especializado em "
• "preciso de um copywriter de "
• "monta um analista de dados / pesquisador / designer / gerente / etc"

O que essa skill faz

Cria um subagente novo, do zero, com:

1. Nome validado (lowercase, sem espacos, sem caracteres especiais)
2. Descricao com triggers (palavras-chave de quando ativar)
3. System prompt completo em PT-BR (personalidade, hierarquia, tom, regras, anti-patterns)
4. Tools restritas conforme especialidade (matriz em CATALOGO-TOOLS.md)
5. Modelo apropriado (sonnet 4.6 default, opus pra coordenacao critica, haiku pra triagem)
6. Arquivo salvo no destino correto (Claude Code OU OpenClaw)
7. Validacao e ativacao automatica

Decisao: Claude Code ou OpenClaw?

Antes de tudo, identificar a plataforma do aluno. Pergunta direta se nao estiver claro:

• Claude Code CLI: arquivo em ~/.claude/agents/.md
• OpenClaw: edita /root/.openclaw/openclaw.json + cria workspace dedicado

Se o aluno tiver os dois, perguntar onde quer adicionar. Default sugerido: Claude Code (mais simples).

Pipeline (8 etapas obrigatorias)

1. Coletar inputs

Perguntar ao aluno (ou inferir da conversa):

• Nome do subagente: lowercase, sem espacos. Ex: sdr-estetica, copy-financeiro, analista-dados
• Especialidade: o que ele faz de fato. Ex: "vende para clinicas de estetica", "escreve copy pra mercado financeiro"
• Nicho de atuacao: contexto/mercado. Ex: "estetica feminina premium", "renda fixa publico 40+"
• Tools que precisa: derivar da especialidade via CATALOGO-TOOLS.md. Se duvida, perguntar.
• Modelo: default sonnet. Subir pra opus so se for tarefa critica/coordenacao. haiku pra triagem rapida.

2. Validar nome

Regras:

• Lowercase obrigatorio
• Apenas a-z, 0-9 e hifen -
• Sem espacos, sem acentos, sem underscore, sem maiuscula
• Maximo 30 caracteres
• Nao colidir com nome existente

Se invalido, devolver opcoes corrigidas (ex: "Carolina SDR" → carolina-sdr).

3. Gerar descricao com triggers

Formato fixo:

. . Acionar quando: "", "", "".

Exemplo: SDR especialista em estetica. Qualifica leads de clinicas via SPIN selling. Acionar quando: "lead de estetica chegou", "qualifica essa clinica", "agenda call com a esteticista".

Triggers devem ser frases reais que o usuario diria, nao termos tecnicos.

4. Escolher tools (matriz em CATALOGO-TOOLS.md)

Resumo (ler CATALOGO-TOOLS.md para detalhe):

| Tipo | Tools | |---|---| | Dev / Engenheiro | Read, Write, Edit, Bash, WebFetch, Grep, Glob | | Copywriter | Read, Write, Edit, WebFetch, WebSearch, Grep | | SDR / Vendas | Read, Write, WebFetch | | Designer | Read, Write, Edit, Bash, WebFetch, Grep, Glob | | Analista de dados | Read, Bash, WebFetch, WebSearch, Grep, Glob | | Pesquisador | Read, WebFetch, WebSearch, Grep, Write | | Gestor / PM | Read, Write, Edit, Grep, Glob, Agent | | Triagem / Roteador | Read, Grep |

Regra: dar a MENOR quantidade de tools que resolva o trabalho. Sem Bash pra quem nao precisa rodar comando. Sem Agent pra quem nao coordena.

5. Gerar system prompt

Estrutura fixa (template em templates/subagent-template.md):

1. Quem e: nome + papel + emoji opcional
2. Hierarquia: filial da Naia, reporta pra Naia. Nunca fala direto com Chefe sem passar pela Naia.
3. Tom: definir conforme nicho (tecnico, criativo, formal, casual)
4. O que faz: 4-6 bullets
5. O que NAO faz: 3-4 bullets (limites claros)
6. Tools permitidas: lista + motivo de cada
7. Anti-patterns universais: sem travessoes, PT-BR sempre, sem voz robotica de IA, sem elogio vazio
8. Referencias: arquivos relevantes pro nicho (knowledge/, memory/)

6. Salvar arquivo

Claude Code

Caminho: ~/.claude/agents/.md

Usar script: scripts/criar-subagente-claude.sh

bash skills/criar-subagente/scripts/criar-subagente-claude.sh \
  --nome "sdr-estetica" \
  --descricao "SDR especialista em estetica..." \
  --tools "Read, Write, WebFetch" \
  --modelo "sonnet" \
  --prompt-file /tmp/sdr-estetica-prompt.md

OpenClaw

Caminho do JSON: /root/.openclaw/openclaw.json Caminho do workspace: /root/.openclaw/workspace-/

Usar script: scripts/criar-subagente-openclaw.py

python3 skills/criar-subagente/scripts/criar-subagente-openclaw.py \
  --nome "sdr-estetica" \
  --descricao "SDR especialista em estetica..." \
  --tools "fs.read,fs.write,web.fetch" \
  --modelo "claude-sonnet-4-5" \
  --prompt-file /tmp/sdr-estetica-prompt.md

O script:

1. Faz backup openclaw.json.bak. antes de editar
2. Valida JSON antes de salvar (json.loads)
3. Cria workspace /root/.openclaw/workspace-/ com SOUL.md, MEMORY.md, BOOTSTRAP.md
4. Restart systemctl restart openclaw-gateway
5. Roda openclaw doctor no fim

7. Validar e ativar

Claude Code

• Disponibilidade imediata (sem restart). O subagente fica disponivel no proximo turno.
• Validar com: Agent(subagent_type="", description="teste curto", prompt="responde so 'ok'")

OpenClaw

• Restart obrigatorio: systemctl restart openclaw-gateway
• Validar com: openclaw doctor
• Esperar gateway voltar (porta 18789)

8. Output final ao aluno

Formato fixo:

Subagente  criado.

Onde: 
Modelo: 
Tools: 
Triggers: "", "", ""

Como usar:
- Em conversa: ""
- Em codigo (Claude Code): Agent(subagent_type="", ...)
- Em codigo (OpenClaw): chamada via gateway com agent_id=""

Status: ativo

Arquivos da skill

• SKILL.md (esse) — entrada principal
• scripts/criar-subagente-claude.sh — script Claude Code
• scripts/criar-subagente-openclaw.py — script OpenClaw
• templates/subagent-template.md — skeleton Claude Code
• templates/subagent-soul-template.md — skeleton SOUL.md OpenClaw
• EXEMPLOS.md — 5 exemplos prontos
• CATALOGO-TOOLS.md — matriz tools x especialidade
• PLAYBOOK.md — quando criar vs adaptar existente

Regras de ouro

1. PT-BR sempre no system prompt do subagente
2. Sem travessoes no prompt do subagente (anti-pattern de voz de IA)
3. Hierarquia clara: subagente reporta pra Naia, nao fala com Chefe direto
4. Menos tools = mais seguro: dar so o necessario
5. Backup antes de editar JSON (OpenClaw) — sempre, com timestamp
6. Validar JSON antes de salvar — json.loads ou jq
7. Nao quebrar agentes existentes — verificar colisao de nome antes de salvar

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: denderson2013-bot
• Source: denderson2013-bot/agente-claude-update-alunos-denderson
• License: MIT

Install and usage instructions live in the source repository linked above.