# Criar Subagente

> Cria um subagente novo do zero (Claude Code ou OpenClaw), com personalidade, system prompt, tools restritas e nicho especifico. Acionar quando o aluno disser "cria um subagente pra X", "preciso de um agente especialista em Y", "monta um subagente novo de Z", "quero um SDR de estetica", "cria um copywriter de mercado financeiro", "monta um analista de dados", "adiciona um agente novo no time", "ex…

- **Type:** Skill
- **Install:** `agentstack add skill-denderson2013-bot-agente-claude-update-alunos-denderson-criar-subagente`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [denderson2013-bot](https://agentstack.voostack.com/s/denderson2013-bot)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [denderson2013-bot](https://github.com/denderson2013-bot)
- **Source:** https://github.com/denderson2013-bot/agente-claude-update-alunos-denderson/tree/main/skills/criar-subagente

## Install

```sh
agentstack add skill-denderson2013-bot-agente-claude-update-alunos-denderson-criar-subagente
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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
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`

```bash
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](https://github.com/denderson2013-bot)
- **Source:** [denderson2013-bot/agente-claude-update-alunos-denderson](https://github.com/denderson2013-bot/agente-claude-update-alunos-denderson)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** yes
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-denderson2013-bot-agente-claude-update-alunos-denderson-criar-subagente
- Seller: https://agentstack.voostack.com/s/denderson2013-bot
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.