skills-devops

Coleção de Skills para Claude Code, Gemini CLI, OpenAI Codex e GitHub Copilot desenvolvidas pela Promovaweb para auditoria e verificação de stacks Docker Swarm, seguindo as boas práticas e padrões internos de infraestrutura de acordo com o que é ensinado nas nossas mentorias e treinamentos.

---

Sobre o Projeto

Cada skill é um agente especializado que inspeciona um serviço ou componente da infraestrutura Docker Swarm e gera um relatório detalhado de conformidade, com problemas identificados e ações recomendadas.

As skills são escritas em português e compatíveis com os principais agentes de IA do mercado: Claude Code, Gemini CLI, OpenAI Codex e GitHub Copilot.

Versão atual das skills: 1.1

---

Skills Disponíveis

Ambiente e Fundamentos

Skill	Descrição
promovaweb-devops-docker	Verifica o ambiente Docker — versão do Engine, status do Swarm, nós do cluster, rede network_swarm_public e volumes externos
promovaweb-devops-docker-networking	Configuração de redes Docker para containers, incluindo bridge, overlay e service discovery
promovaweb-devops-docker-swarm	Orquestração Docker Swarm, gerenciamento de cluster e implantações em produção
promovaweb-devops-docker-volumes	Armazenamento persistente com Docker volumes, bind mounts e estratégias de backup
promovaweb-devops-dockerfile-basics	Fundamentos do Dockerfile e boas práticas para criar imagens de container prontas para produção

Infraestrutura de Base

Skill	Descrição
promovaweb-devops-review-portainer-stack	Auditoria do stack Portainer — parâmetros, rotas Traefik, volumes, recursos e conformidade
promovaweb-devops-review-traefik-stack	Auditoria do stack Traefik — parâmetros, rotas, volumes, recursos e conformidade

Bancos de Dados

Skill	Descrição
promovaweb-devops-review-mongodb-stack	Auditoria do stack MongoDB — parâmetros, rotas Traefik, volumes, recursos e conformidade
promovaweb-devops-review-mysql-stack	Auditoria do stack MySQL — parâmetros, rotas Traefik, volumes, recursos e conformidade
promovaweb-devops-review-postgres-stack	Auditoria do stack PostgreSQL — parâmetros, rotas Traefik, volumes, recursos e conformidade
promovaweb-devops-review-redis-stack	Auditoria do stack Redis — parâmetros, rotas Traefik, volumes, recursos e conformidade

Aplicações

Skill	Descrição
promovaweb-devops-review-chatwoot-stack	Auditoria do stack Chatwoot — parâmetros, rotas Traefik, volumes, recursos e conformidade
promovaweb-devops-review-evolution-go-stack	Auditoria do stack Evolution Go — parâmetros, rotas Traefik, volumes, recursos e conformidade
promovaweb-devops-review-kestra-stack	Auditoria do stack Kestra — parâmetros, rotas Traefik, volumes, recursos e conformidade
promovaweb-devops-review-mautic-stack	Auditoria do stack Mautic — parâmetros, rotas Traefik, volumes, recursos e conformidade
promovaweb-devops-review-metabase-stack	Auditoria do stack Metabase — parâmetros, rotas Traefik, volumes, recursos e conformidade
promovaweb-devops-review-n8n-stack	Auditoria do stack N8N — parâmetros, rotas Traefik, volumes, recursos e conformidade

Monitoramento e Utilitários

Skill	Descrição
promovaweb-devops-review-databasus-stack	Auditoria do stack Databasus — parâmetros, rotas Traefik, volumes, recursos e conformidade
promovaweb-devops-review-uptime-kuma-stack	Auditoria do stack Uptime Kuma — parâmetros, rotas Traefik, volumes, recursos e conformidade

---

Requisitos

• AI Agent instalado (Claude Code, Gemini CLI, etc.)
• Node.js 18 ou superior

---

Instalação

As skills podem ser instaladas individualmente ou todas de uma vez a partir do repositório GitHub.

Instalar todas as skills de uma vez (Recomendado)

npx skills install github:promovaweb/skills-devops

Instalar uma skill específica

npx skills install github:promovaweb/skills-devops/skills/promovaweb-devops-docker

---

Como Usar

Após a instalação, as skills ficam disponíveis como comandos no seu agente de IA preferido. Execute-as dentro do servidor que deseja auditar.

Exemplos de uso

/promovaweb-devops-docker

Executa a auditoria completa do ambiente Docker.

/promovaweb-devops-review-traefik-stack

Audita a configuração do stack Traefik.

/promovaweb-devops-review-n8n-stack

Audita a configuração do stack N8N, incluindo dependências com PostgreSQL e Redis.

Formato do relatório

Cada skill de auditoria gera um relatório estruturado com:

• Resumo — total de verificações, aprovadas, avisos e erros
• Resultados por categoria — status de cada item verificado (OK, AVISO, ERRO)
• Ações recomendadas — classificadas em Crítico, Recomendado e Opcional

---

O que cada skill verifica

As skills de auditoria realizam verificações nas seguintes categorias:

• Imagem — versão correta, sem uso de tag latest, pinagem de versão major
• Variáveis de ambiente — presença de todas as variáveis obrigatórias, ausência de placeholders
• Portas — se portas estão expostas indevidamente para o host
• Volumes — uso de external: true para persistência de dados
• Réplicas — número correto de réplicas para cada serviço
• Recursos — limites de CPU e memória configurados
• Deploy — placement constraints, restart policy, update strategy
• Redes — uso correto da rede overlay network_swarm_public
• Segurança — autenticação, senhas fortes, exposição de interfaces administrativas
• Integração com Traefik — labels de roteamento, TLS/HTTPS, domínio configurado

---

Contribuindo

Contribuições são bem-vindas. Para adicionar uma nova skill:

1. Crie um diretório em skills/ com o nome da skill
2. Adicione o arquivo SKILL.md seguindo o padrão das skills existentes (frontmatter YAML + instruções em português)
3. Abra um Pull Request

---

Licença

MIT — consulte CREDITS.md para detalhes e atribuições.