convez.ai
SkillAutomaçãoAvançado
matheussco1-cmd

n8n Squad Skills

matheussco1-cmd/n8n-squad-skills

Skills e agents Claude para automação n8n, WhatsApp e Supabase

Ver no GitHub
InicialPluginScore · de 0 a 100

Conjunto 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-skills

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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:

ComandoQuando usar
/poChegou uma demanda nova — estrutura e prioriza
/diagnoseAlgo quebrou em produção — investiga antes de mudar
/implementNova feature — plano antes de código
/memoryGuarda 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.

Ver o original no GitHub

Bom para

Relacionados