n8n Squad Skills
matheussco1-cmd/n8n-squad-skills
Skills e agents Claude para automação n8n, WhatsApp e Supabase
Ver no GitHubConjunto de skills, agentes e comandos slash para Claude Code em projetos de automação n8n + WhatsApp + Supabase. Inclui agents de engenharia de prompts, avaliador de qualidade, e comandos para Product Owner, diagnóstico, implementação e gerenciamento de conhecimento.
Instalação
npx convez-ai matheussco1-cmd/n8n-squad-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Estruturar e priorizar demandas de produto com /po
- Diagnosticar e corrigir bugs em produção com /diagnose
- Implementar novas features com plano validado via /implement
- Avaliar e melhorar prompts de agentes antes de produção
- Configurar workflows, webhooks e integrações n8n com especialistas
Veredito

Skill madura e bem estruturada para times que usam n8n + Claude. O ciclo de qualidade de prompts com avaliador automático evita regressões em produção. Requer conhecimento prévio da stack (n8n, Supabase, Evolution API) para máximo proveito.
README
A tradução para o português deste README ainda está na fila.
n8n Squad Skills
Conjunto de skills, agentes e comandos para Claude Code em projetos de automação n8n + WhatsApp + Supabase.
Desenvolvido para a stack: n8n · Chatwoot · WhatsApp API (Evolution) · Supabase · Claude · Gemini.
O que está aqui
agents/
prompt-engineer-n8n.md — Engenheiro de prompt para fluxos WhatsApp/n8n
prompt-quality-evaluator.md — Avaliador de prompts com scorecard 0–10
commands/
po.md — Product Owner: estrutura backlog e prioriza demandas
diagnose.md — Diagnóstico de bugs em produção (menor mudança possível)
implement.md — Implementação de novas features com plano validado
memory.md — Roteamento de conhecimento para o destino certo
skills/
n8n/ — Especialista n8n com acesso ao n8n-mcp
n8n-workflow-patterns/ — Padrões de webhook, schedule, AI agent, batch
n8n-node-configuration/ — Configuração de nós e operações
n8n-code-javascript/ — Code nodes JavaScript
n8n-code-python/ — Code nodes Python
n8n-expression-syntax/ — Expressões n8n ($json, $node, etc.)
n8n-mcp-tools-expert/ — Uso avançado das ferramentas MCP do n8n
n8n-payments/ — Integração com gateways de pagamento
n8n-validation-expert/ — Validação e qualidade de workflows
Instalação
Agents (Claude Code subagents)
Copie os arquivos de agents/ para:
- macOS/Linux:
~/.claude/agents/ - Windows:
C:\Users\[seu-usuario]\.claude\agents\
Commands (slash commands /po, /diagnose, etc.)
Copie os arquivos de commands/ para o diretório .claude/commands/ dentro do seu projeto:
seu-projeto/
└── .claude/
└── commands/
├── po.md
├── diagnose.md
├── implement.md
└── memory.md
Ou para comandos globais (disponíveis em todos os projetos):
- macOS/Linux:
~/.claude/commands/ - Windows:
C:\Users\[seu-usuario]\.claude\commands\
Skills
Copie os diretórios de skills/ para:
- macOS/Linux:
~/.claude/skills/ - Windows:
C:\Users\[seu-usuario]\.claude\skills\
Uso
Após instalar, no Claude Code:
| Comando | Quando usar |
|---|---|
/po | Chegou uma demanda nova — estrutura e prioriza |
/diagnose | Algo quebrou em produção — investiga antes de mudar |
/implement | Nova feature — plano antes de código |
/memory | Guarda aprendizado no lugar certo |
Os agents prompt-engineer-n8n e prompt-quality-evaluator são acionados automaticamente pelo Claude quando detecta uma tarefa de engenharia de prompts, ou explicitamente via Agent tool nas instruções do projeto.
Ciclo de qualidade de prompts
/implement → prompt-engineer-n8n → prompt-quality-evaluator → score ≥ 8.5 → produção
Nunca suba um system prompt de agente sem passar pelo avaliador.
Configuração do projeto (CLAUDE.md)
No CLAUDE.md do seu projeto, referencie as skills instaladas e adapte os caminhos ao seu contexto. Veja o arquivo CLAUDE.md.example neste repo para um template de partida.
Stack pressuposta
- n8n self-hosted (Railway ou VPS)
- Supabase self-hosted (dois Postgres separados: dados cliente + memória agente)
- Chatwoot para atendimento humano e handoff
- Evolution API como gateway WhatsApp
- Claude Sonnet como LLM padrão
As skills funcionam com qualquer configuração, mas os comandos /diagnose e /implement têm checklist baseado nessa stack.