# n8n-workflow-builder

> Construção de workflows de automação n8n. Gera arquivos JSON prontos para importar no n8n. Usar quando o usuário pedir para criar fluxos, automações, integrações ou workflows no n8n. Exemplos de triggers: crie um fluxo n8n, monte uma automação, gere um workflow para, integração n8n entre X e Y, automatize com n8n.

- Author: Amir Faria
- Repository: drmirf/claude-code-skills
- Version: 20260122163100
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/drmirf/claude-code-skills
- Web: https://mule.run/skillshub/@@drmirf/claude-code-skills~n8n-workflow-builder:20260122163100

---

---
name: n8n-workflow-builder
description: >
  Construção de workflows de automação n8n. Gera arquivos JSON prontos para importar no n8n.
  Usar quando o usuário pedir para criar fluxos, automações, integrações ou workflows no n8n.
  Exemplos de triggers: crie um fluxo n8n, monte uma automação, gere um workflow para,
  integração n8n entre X e Y, automatize com n8n.
---

# n8n Workflow Builder

Skill para construção de workflows n8n exportáveis como JSON.

## Processo de Criação

### 1. Entender o Requisito

Identificar:
- **Trigger**: O que inicia o fluxo? (webhook, schedule, email, manual, chat)
- **Ações**: O que deve acontecer? (enviar email, salvar dados, chamar API, AI)
- **Lógica**: Há condições, loops ou branches?
- **Integrações**: Quais serviços? (Slack, Google Sheets, bancos de dados, OpenAI)
- **Error Handling**: Precisa de tratamento de erros robusto?

### 2. Consultar Referências

Ler os arquivos conforme necessidade:

| Arquivo | Quando Usar |
|---------|-------------|
| `references/json-structure.md` | Estrutura JSON, connections, credenciais |
| `references/common-nodes.md` | Configuração de nodes (triggers, ações, AI, transformação) |
| `references/expressions.md` | Expressões, variáveis, manipulação de dados |
| `references/integration-patterns.md` | Padrões de arquitetura e fluxos |
| `references/best-practices.md` | Design modular, error handling, segurança |

### 3. Construir o Workflow

1. Começar pelo template em `assets/workflow-template.json`
2. Adicionar nodes na ordem do fluxo
3. Gerar UUIDs únicos para cada node
4. Posicionar nodes incrementando X em 250
5. Configurar connections entre nodes
6. Adicionar error handling quando apropriado
7. Definir nome descritivo para o workflow

### 4. Validar e Entregar

- Verificar JSON válido
- Confirmar todas as connections
- Salvar como `.json`
- Explicar credenciais necessárias e como importar

## Regras de Geração

### UUIDs
Gerar UUIDs únicos para cada node:
```
a0000000-0000-0000-0000-000000000001
a0000000-0000-0000-0000-000000000002
```

### Posicionamento
- Fluxo horizontal: incrementar X em 250
- Branches paralelos: variar Y em ±150
- Sticky Notes: posicionar acima dos nodes relacionados

### Credenciais
Usar placeholders descritivos:
```json
"credentials": {
  "googleSheetsOAuth2Api": {
    "id": "CONFIGURE_SUA_CREDENCIAL",
    "name": "Google Sheets - Configurar"
  }
}
```

### Nomenclatura
- Nodes: nomes descritivos da função (ex: "Validar Dados", "Enviar Alerta")
- Workflow: descrever o propósito (ex: "CRM → Sheets Sync")

### Error Handling
Para workflows de produção, sempre incluir:
- Error Workflow configurado nas settings
- Validação de dados na entrada
- Retry em nodes de API externa

## Tipos de Workflow

### Simples (Webhook → Ação)
Consultar: `common-nodes.md`, `json-structure.md`

### Com Lógica (IF/Switch)
Consultar: `common-nodes.md`, `integration-patterns.md`

### AI/LangChain
Consultar: `common-nodes.md` (seção AI), `expressions.md`

### Produção (Robusto)
Consultar: `best-practices.md`, `integration-patterns.md`

## Output

Entregar:
1. **Arquivo JSON** pronto para importar
2. **Instruções**:
   - Credenciais necessárias
   - Variáveis a ajustar (IDs, URLs)
   - Como importar: Menu ⋯ → Import from File
   - Próximos passos (ativar workflow, testar)