🤖 Dolu Agents & Skills

Coleção de agentes especialistas e skills para OpenCode AI

Transforme seu OpenCode em uma equipe de especialistas virtuais

📖 Sobre o Projeto

Dolu Agents & Skills é uma coleção curada de 13 agentes especialistas e 13 skills projetadas para funcionarem com OpenCode, o assistente de IA para desenvolvimento de software.

Este projeto fornece especialistas virtuais para diferentes domínios do desenvolvimento de software, desde arquitetura de backend até análise de segurança, passando por debugging sistemático e documentação técnica, e agora incluindo especialistas em DevOps para deploy, web servers e gestão de servidores.

🎯 Por que usar?

Especialização Real: Cada agente é treinado com deep knowledge em seu domínio
Coordenação Inteligente: O Orchestrator delega automaticamente para os especialistas certos
Segurança First: Práticas de segurança integradas em todos os agentes
Instalação Segura: Scripts que preservam suas configurações existentes
Open Source: Licença MIT - faça o que quiser!

✨ Features

Feature	Descrição
🤖 13 Agentes Especialistas	Cada um com expertise profunda em um domínio específico
🛠️ 13 Skills	Workflows e processos estruturados para tarefas complexas
🔒 Foco em Segurança	Práticas de segurança integradas em todos os agentes
📦 Instalação Fácil	Script de instalação com merge seguro (preserva suas configs)
🗑️ Desinstalação Limpa	Remove todos os arquivos sem afetar configurações existentes
🔗 MCP Servers	Integração com Chrome DevTools, Playwright, Memory e Fetch
📚 Bem Documentado	Cada agente e skill com instruções detalhadas

🤖 Agentes Disponíveis

Agente	Especialidade	Melhor Para
orchestrator 🎯	Coordenação	Tarefas complexas que precisam de múltiplos especialistas
backend-engineer ⚙️	Backend	APIs, databases, microservices, sistemas distribuídos
frontend-dev 🎨	Frontend	Web apps, performance, accessibility, UX
api-specialist 🔌	APIs	REST, GraphQL, gRPC, API-first design
security-analyst 🔐	Segurança	Pentesting, vulnerabilidades, attack vectors
code-review 👀	Qualidade	Code review focado em segurança e boas práticas
debugger 🐛	Debugging	Root cause analysis, logs, stack traces, profiling
test-runner 🧪	Testes	Automated testing: criação, execução e gerenciamento
documentation-writer 📝	Documentação	Technical writer: documentação clara e manutenível
researcher 🔍	Pesquisa	Web researcher: busca, navegação, extração de conteúdo
deploy-specialist 🚀	NOVO	CI/CD, deployments, Kubernetes, Docker, automação de infraestrutura
web-server-setup 🌐	NOVO	Nginx, Apache, Traefik, Caddy, SSL/TLS, load balancing
server-management 🖥️	NOVO	Administração de servidores Linux, hardening, monitoramento, backups

Como Escolher o Agente Certo

Tarefa Complexa?              → orchestrator (ele delega)
API ou Backend?               → backend-engineer
UI/Frontend?                  → frontend-dev
Segurança ou Vulnerabilidades?→ security-analyst
Bug ou Erro?                  → debugger
Testes?                       → test-runner
Documentação?                 → documentation-writer
Code Review?                  → code-review
Design de API?                → api-specialist
Pesquisa na Web?              → researcher
Deploy/CI/CD?                 → deploy-specialist
Web Server/SSL?               → web-server-setup
Hardening/Servidores?         → server-management

🛠️ Skills Disponíveis

Skill	Quando Usar
brainstorming 💡	ANTES de qualquer trabalho criativo - explorar requisitos e design
writing-plans 📋	Quando tem specs/requirements para tarefas multi-step
executing-plans ▶️	Quando tem um plano escrito para executar em sessão separada
requesting-code-review 🔍	Quando completa tarefas, implementa features, ou antes de merge
receiving-code-review 📥	Quando recebe feedback de code review
verification-before-completion ✅	ANTES de claimar que trabalho está completo
systematic-debugging 🔧	Quando encontra bugs, test failures, ou comportamento inesperado
frontend-design 🎨	Para criar interfaces frontend de alta qualidade
skill-creator 🛠️	Quando quer criar ou atualizar skills
stripe-best-practices 💳	Para integrações com Stripe
deploy-automation 🚀	NOVO
server-hardening 🔒	NOVO
webserver-configuration 🌐	NOVO

Fluxo Recomendado de Skills

Nova Feature:
  brainstorming → writing-plans → executing-plans → verification-before-completion

Bug Fix:
  systematic-debugging → [implementar fix] → verification-before-completion

Code Review:
  requesting-code-review → [receber feedback] → receiving-code-review

Frontend:
  frontend-design → [implementar] → verification-before-completion

Deploy:
  deploy-automation → [setup CI/CD] → verification-before-completion

Hardening:
  server-hardening → [security audit] → verification-before-completion

📋 Pré-requisitos

OpenCode instalado
jq (para instalação segura com merge)

Instalar jq

# Ubuntu/Debian
sudo apt install jq

# Fedora
sudo dnf install jq

# Arch Linux
sudo pacman -S jq

# macOS
brew install jq

# Windows (com Chocolatey)
choco install jq

🚀 Instalação

Método Rápido (Recomendado)

# Clone o repositório
git clone https://github.com/dolutech/dolu-agents-skills.git
cd dolu-agents-skills

# Execute o instalador
chmod +x install.sh
./install.sh

Instalação Manual

# Criar diretórios
mkdir -p ~/.config/opencode/agent
mkdir -p ~/.config/opencode/skills

# Copiar agentes
cp agents/*.md ~/.config/opencode/agent/

# Copiar skills
cp -r skills/* ~/.config/opencode/skills/

# Copiar GUIDELINES
cp GUIDELINES.md ~/.config/opencode/

# Merge da configuração (requer jq)
# O script detecta automaticamente se você usa opencode.json ou opencode.jsonc
jq -s '
  .[0] as $user | .[1] as $pack |
  $user * {
    "agent": ($pack.agent * ($user.agent // {})),
    "mcp": ($pack.mcp * ($user.mcp // {}))
  }
' ~/.config/opencode/opencode.jsonc opencode.agents.json > /tmp/merged.json
mv /tmp/merged.json ~/.config/opencode/opencode.jsonc

Opções de Instalação

O script install.sh oferece 4 opções:

Opção	Descrição
1) Everything	Instala agentes + skills + MCPs (recomendado)
2) Agents + MCPs only	Apenas agentes e MCPs
3) Skills only	Apenas skills
4) Choose individually	Escolher cada componente individualmente

Segurança da Instalação

✅ O script de instalação:

Preserva suas configurações existentes (API keys, providers, models)
Faz backup automático antes de modificar
Faz merge seguro (não sobrescreve agentes existentes com mesmo nome)
Só adiciona, nunca remove

🗑️ Desinstalação

./uninstall.sh

O script de desinstalação:

✅ Remove todos os agentes do Dolu
✅ Remove todas as skills do Dolu
✅ Limpa entradas no opencode.json/opencode.jsonc
✅ PRESERVA suas configurações existentes (API keys, providers, etc.)
✅ Cria backup antes de modificar

Compatibilidade: testado com opencode 1.18.x (schema atual com mcp em vez de mcpServers). Agentes são carregados via variável {file:...} no prompt, suportada pelas versões modernas.

📁 Estrutura do Projeto

dolu-agents-skills/
├── 📁 agents/                        # Definições dos agentes especialistas (13 agentes)
│   ├── orchestrator.md              # Coordenador de tarefas complexas
│   ├── backend-engineer.md          # Especialista em backend
│   ├── frontend-dev.md              # Especialista em frontend
│   ├── api-specialist.md            # Arquiteto de APIs
│   ├── security-analyst.md          # Analista de segurança ofensiva
│   ├── code-review.md               # Revisor de código
│   ├── debugger.md                  # Especialista em debugging
│   ├── test-runner.md               # Especialista em testes
│   ├── documentation-writer.md      # Escritor técnico
│   ├── researcher.md                # Pesquisador web
│   ├── deploy-specialist.md         # NOVO - Especialista em CI/CD e deployments
│   ├── web-server-setup.md          # NOVO - Especialista em web servers
│   └── server-management.md         # NOVO - Especialista em gestão de servidores
│
├── 📁 skills/                        # Skills especializadas (13 skills)
│   ├── brainstorming/               # Exploração de ideias
│   ├── executing-plans/             # Execução de planos
│   ├── writing-plans/               # Criação de planos
│   ├── requesting-code-review/      # Solicitar code review
│   ├── receiving-code-review/       # Receber code review
│   ├── skill-creator/               # Criador de skills
│   ├── stripe-best-practices/       # Integrações Stripe
│   ├── systematic-debugging/        # Debugging sistemático
│   ├── frontend-design/             # Design de interfaces
│   ├── verification-before-completion/  # Verificação pré-entrega
│   ├── deploy-automation/           # NOVO - Automação de CI/CD e deployments
│   ├── server-hardening/            # NOVO - Hardening de servidores
│   └── webserver-configuration/     # NOVO - Configuração de web servers
│
├── 📁 docs/                          # Documentação técnica
│   ├── DEVOPS_AGENTS.md             # Documentação dos agentes DevOps
│   └── MCP_SERVERS_FIX.md           # Guia de MCP servers
│
├── 📄 opencode.agents.json           # Configuração dos agentes e MCPs
├── 📄 AGENTS.md                      # Regras operacionais para IA
├── 📄 GUIDELINES.md                  # Diretrizes de segurança e desenvolvimento
├── 🔧 install.sh                     # Script de instalação
├── 🔧 uninstall.sh                   # Script de desinstalação
├── 📖 README.md                      # Este arquivo
├── 📖 CONTRIBUTING.md                # Guia de contribuição
└── ⚖️ LICENSE                        # Licença MIT

💡 Exemplos de Uso

Exemplo 1: Usando o Orchestrator para Feature Completa

Você: "Preciso implementar um sistema de notificações push"

Orchestrator vai:
1. 📋 Analisar requisitos e criar plano
2. ⚙️ Delegar para backend-engineer (API + Background Jobs)
3. 🎨 Delegar para frontend-dev (UI de preferências)
4. 🔐 Delegar para security-analyst (revisão de segurança)
5. 🧪 Coordenar testes com test-runner
6. 📝 Documentar com documentation-writer
7. ✅ Verificar qualidade com code-review

Exemplo 2: Usando o Security Analyst

Você: "Analise este código em busca de vulnerabilidades"

Security Analyst vai:
1. 🔍 Mapear superfície de ataque
2. 🎯 Identificar vulnerabilidades (OWASP Top 10)
3. 💣 Desenvolver provas de conceito
4. 📊 Calcular CVSS scores
5. 🛡️ Fornecer remediação completa com código seguro

Exemplo 3: Usando Systematic Debugging Skill

Você: "Os testes estão falhando aleatoriamente"

Skill vai:
1. 📖 Ler mensagens de erro completamente
2. 🔄 Reproduzir consistentemente
3. 🔎 Verificar mudanças recentes
4. 📊 Coletar evidências em cada camada
5. 🔍 Rastrear fluxo de dados
6. ✅ Identificar causa raiz ANTES de propor fix

Exemplo 4: Fluxo Completo de Feature

Você: "Quero adicionar autenticação OAuth2"

1. 💡 brainstorming skill
   → Explora requisitos, opções, design
   
2. 📋 writing-plans skill
   → Cria plano detalhado de implementação
   
3. ▶️ executing-plans skill (ou orchestrator)
   → Executa plano task por task
   
4. 🔍 requesting-code-review skill
   → Solicita review do código
   
5. 📥 receiving-code-review skill
   → Processa feedback do review
   
6. ✅ verification-before-completion skill
   → Verifica tudo antes de claimar completo

Exemplo 5: Usando o Deploy Specialist

Você: "Configure um pipeline CI/CD para minha aplicação"

Deploy Specialist vai:
1. 📋 Analisar requisitos da aplicação
2. ⚙️ Escolher plataforma (GitHub Actions, GitLab CI, Jenkins)
3. 🧪 Configurar testes automatizados
4. 🔐 Adicionar security scanning (SAST, SCA)
5. 🚀 Implementar estratégia de deploy (rolling, canary)
6. 🔁 Configurar rollback automático
7. 📊 Adicionar monitoring e notifications

Exemplo 6: Usando o Web Server Setup

Você: "Configure Nginx com SSL para minha API"

Web Server Setup vai:
1. 🔧 Instalar e configurar Nginx
2. 🔒 Obter certificado SSL (Let's Encrypt)
3. ⚙️ Configurar reverse proxy
4. 🛡️ Adicionar security headers
5. ⚡ Otimizar performance (gzip, caching)
6. 📊 Configurar logging e monitoring
7. ✅ Testar configuração

Exemplo 7: Usando o Server Management

Você: "Hardenize meu servidor Ubuntu para produção"

Server Management vai:
1. 📋 Avaliar configuração atual
2. 🔒 Aplicar CIS Benchmarks
3. 🛡️ Configurar firewall (UFW)
4. 🔐 Hardening do SSH
5. 📊 Instalar monitoring (Prometheus, Grafana)
6. 💾 Configurar backups automatizados
7. 🔍 Instalar intrusion detection (Fail2ban)

🔒 Segurança

Este projeto foi desenvolvido com segurança em primeiro lugar:

Nos Agentes

✅ Todos seguem práticas de segurança OWASP
✅ security-analyst usa mindset de red team
✅ Validação de input em todos os exemplos
✅ Proteção contra injection em todos os patterns

Nos Skills

✅ systematic-debugging encontra causa raiz antes de fixes
✅ verification-before-completion garante qualidade
✅ brainstorming considera implicações de segurança

Documentação

✅ GUIDELINES.md com diretrizes abrangentes
✅ AGENTS.md com checklists de segurança
✅ Exemplos de código sempre mostram versão segura

🔗 MCP Servers Configurados

MCP Server	Status	Descrição
chrome-devtools	✅ Habilitado	Controle do Chrome para debugging e testing
playwright	⚪ Opcional	Automação de browser para testes E2E
memory	✅ Habilitado	Memória persistente entre sessões
fetch	⚪ Opcional	Fetch de URLs para pesquisa

🤝 Contribuindo

Contribuições são bem-vindas! Por favor, leia CONTRIBUTING.md para detalhes.

Formas de Contribuir

🐛 Reportar bugs
💡 Sugerir novas features
🤖 Adicionar novos agentes
🛠️ Criar novas skills
📚 Melhorar documentação
🌍 Traduzir para outros idiomas

Quick Start para Contribuidores

# Fork e clone
git clone https://github.com/seu-usuario/dolu-agents-skills.git

# Crie uma branch
git checkout -b feature/minha-feature

# Faça suas mudanças
# ...

# Commit seguindo Conventional Commits
git commit -m "feat: adiciona novo agente xyz"

# Push e PR
git push origin feature/minha-feature

📈 Roadmap

✅ v1.1 (Março 2026) - DevOps & Infrastructure

Deploy Specialist Agent (CI/CD, Kubernetes, Docker)
Web Server Setup Agent (Nginx, Apache, Traefik, Caddy)
Server Management Agent (Linux, hardening, monitoring)
Deploy Automation Skill
Server Hardening Skill
Web Server Configuration Skill
Complete documentation in PT/EN

✅ v1.2 (Agosto 2026) - Compatibilidade OpenCode 1.18.x

Compatibilidade com o schema atual do opencode (chave mcp, não mcpServers)
Suporte a opencode.json e opencode.jsonc no instalador
Merge seguro que preserva agentes do usuário
Desinstalador corrigido (limpa mcp, lista dinâmica dos 13 agentes/skills)
Removido campo instructions inválido do agente security-analyst
docs/CHANGELOG.md adicionado

🔜 v1.3 - Cloud & Advanced Features

AWS Specialist Agent
GCP Specialist Agent
Azure Specialist Agent
Cloud Infrastructure Skills
Terraform/CloudFormation patterns
Kubernetes advanced patterns

🔜 v1.4 - Database & Performance

Database Specialist Agent (PostgreSQL, MySQL, MongoDB)
Performance Optimization Agent
Database migration skills
Query optimization patterns
Caching strategies

🔜 v1.5 - Monitoring & Observability

Monitoring Specialist Agent
Observability patterns
Logging best practices
Alerting strategies
Dashboard templates

🔮 Futuro (2026+)

Multi-language support (ES, FR, DE)
Project templates
Integration with more MCPs
AI-powered code suggestions
Custom agent creation tool

📄 Licença

Este projeto está licenciado sob a licença MIT.

Em resumo: Você pode fazer o que quiser com este código! 🎉

✅ Uso comercial
✅ Modificação
✅ Distribuição
✅ Uso privado

Veja o arquivo LICENSE para detalhes completos.

🙏 Créditos e Agradecimentos

Autor

Lucas Catão de Moraes - Dolutech

Atribuições

Algumas skills foram adaptadas e/ou inspiradas em projetos open source:

Skill	Fonte	Licença
`systematic-debugging`	Anthropic Skills	Apache 2.0
`verification-before-completion`	Anthropic Skills	Apache 2.0
`requesting-code-review`	Anthropic Skills	Apache 2.0
`receiving-code-review`	Anthropic Skills	Apache 2.0
`brainstorming`	Anthropic Skills	Apache 2.0
`writing-plans`	Anthropic Skills	Apache 2.0
`executing-plans`	Anthropic Skills	Apache 2.0
`skill-creator`	Anthropic Skills	Apache 2.0
`stripe-best-practices`	Stripe Documentation	Stripe

Inspirado por

OpenCode - O melhor CLI de IA para desenvolvimento
Claude - IA que realmente entende código
Melhores práticas de desenvolvimento de software e segurança

Agradecimentos

Comunidade OpenCode
Todos os contribuidores
Você, por usar este projeto! ❤️

📞 Contato e Suporte

Issues: GitHub Issues
Discussões: GitHub Discussions
Autor: Lucas Catão de Moraes

⭐ Se este projeto foi útil, considere dar uma estrela! ⭐

⬆ Voltar ao topo

Made with ❤️ by Lucas Catão de Moraes | Dolutech

🆕 Novos Agentes e Skills DevOps (v1.1)

Acabamos de adicionar 3 novos agentes especialistas em DevOps e 3 novas skills para automação de infraestrutura!

🚀 Novo: Deploy Specialist Agent

Especialidade: CI/CD, deployments, Kubernetes, Docker e automação de infraestrutura

O que faz:

Configura pipelines de CI/CD (GitHub Actions, GitLab CI, Jenkins)
Implementa estratégias de deploy (rolling, blue-green, canary)
Cria procedimentos de rollback automático
Gerencia ambientes múltiplos (dev, staging, production)
Automatiza migrações de banco de dados
Implementa GitOps com ArgoCD

Quando usar:

"Configure um pipeline CI/CD para minha aplicação Node.js"
"Implemente blue-green deployment no Kubernetes"
"Crie uma estratégia de canary deployment com rollback automático"
"Configure GitOps com ArgoCD"

Skill associada: deploy-automation

🌐 Novo: Web Server Setup Agent

Especialidade: Nginx, Apache, Traefik, Caddy, SSL/TLS e load balancing

O que faz:

Instala e configura web servers (Nginx, Apache, Traefik, Caddy)
Configura certificados SSL/TLS (Let's Encrypt, Certbot)
Implementa reverse proxy e load balancing
Otimiza performance (HTTP/2, HTTP/3, caching, compressão)
Adiciona security headers
Configura virtual hosts

Quando usar:

"Configure Nginx como reverse proxy com SSL"
"Implemente load balancing entre 3 servidores backend"
"Configure certificados SSL automáticos com Let's Encrypt"
"Otimize Nginx para aplicações de alto tráfego"
"Configure Traefik com Docker e HTTPS automático"

Skill associada: webserver-configuration

🖥️ Novo: Server Management Agent

Especialidade: Administração de servidores Linux, security hardening, monitoramento e backups

O que faz:

Hardening de servidores baseado em CIS Benchmarks
Configura firewall (UFW, iptables)
Implementa SSH hardening
Configura monitoring (Prometheus, Grafana, Netdata)
Cria estratégias de backup (BorgBackup, Restic)
Otimiza performance do sistema
Configura intrusion detection (Fail2ban)

Quando usar:

"Hardenize meu servidor Ubuntu seguindo CIS Benchmarks"
"Configure Prometheus e Grafana para monitoramento"
"Crie uma estratégia completa de backup"
"Configure Fail2ban e detecção de intrusão"
"Otimize parâmetros do kernel Linux para performance"

Skill associada: server-hardening

🛠️ Novas Skills DevOps

Deploy Automation

Para que serve: Workflows completos para CI/CD, estratégias de deploy e releases em produção

Inclui:

Padrões de CI/CD (GitHub Actions, GitLab CI, Jenkins)
Estratégias de deployment (rolling, blue-green, canary)
Procedimentos de rollback
Migrações de banco de dados seguras
Feature flags

Quando usar:

"Use a skill deploy-automation para criar um pipeline CI/CD"
"Implemente canary deployment com a skill deploy-automation"

Server Hardening

Para que serve: Hardening completo de servidores baseado em CIS Benchmarks

Inclui:

Scripts de hardening automatizado
CIS Benchmarks implementation guide
Security checklist completa
Configuração de audit logging
Monitoramento de segurança

Quando usar:

"Use a skill server-hardening para proteger meu servidor"
"Implemente CIS Benchmarks com a skill server-hardening"

Web Server Configuration

Para que serve: Configuração completa de web servers

Inclui:

Configurações de Nginx para produção
Configurações de Apache e virtual hosts
Setup de Traefik e Caddy
SSL/TLS configuration guide
Performance tuning

Quando usar:

"Use a skill webserver-configuration para configurar Nginx"
"Configure SSL/TLS com a skill webserver-configuration"

🇺🇸 English Version

🤖 Dolu Agents & Skills

Collection of specialist agents and skills for OpenCode AI

Transform your OpenCode into a team of virtual specialists

📖 About

Dolu Agents & Skills is a curated collection of 13 specialist agents and 13 skills designed to work with OpenCode, the AI assistant for software development.

This project provides virtual specialists for different software development domains, from backend architecture to security analysis, through systematic debugging and technical documentation, and now including DevOps specialists for deployment, web servers, and server management.

🎯 Why Use?

Real Specialization: Each agent is trained with deep knowledge in their domain
Smart Coordination: The Orchestrator automatically delegates to the right specialists
Security First: Security practices integrated in all agents
Safe Installation: Scripts that preserve your existing configurations
Open Source: MIT License - do whatever you want!

✨ Features

Feature	Description
🤖 13 Specialist Agents	Each with deep expertise in a specific domain
🛠️ 13 Skills	Structured workflows and processes for complex tasks
🔒 Security Focus	Security practices integrated in all agents
📦 Easy Installation	Installation script with safe merge (preserves your configs)
🗑️ Clean Uninstall	Removes all files without affecting existing settings
🔗 MCP Servers	Integration with Chrome DevTools, Playwright, Memory and Fetch
📚 Well Documented	Each agent and skill with detailed instructions

🤖 Available Agents

Agent	Specialty	Best For
orchestrator 🎯	Coordination	Complex tasks requiring multiple specialists
backend-engineer ⚙️	Backend	APIs, databases, microservices, distributed systems
frontend-dev 🎨	Frontend	Web apps, performance, accessibility, UX
api-specialist 🔌	APIs	REST, GraphQL, gRPC, API-first design
security-analyst 🔐	Security	Pentesting, vulnerabilities, attack vectors
code-review 👀	Quality	Code review focused on security and best practices
debugger 🐛	Debugging	Root cause analysis, logs, stack traces, profiling
test-runner 🧪	Testing	Automated testing: creation, execution, management
documentation-writer 📝	Documentation	Technical writer: clear, maintainable documentation
researcher 🔍	Research	Web researcher: search, navigation, content extraction
deploy-specialist 🚀	NEW	CI/CD, deployments, Kubernetes, Docker, infrastructure automation
web-server-setup 🌐	NEW	Nginx, Apache, Traefik, Caddy, SSL/TLS, load balancing
server-management 🖥️	NEW	Linux server administration, hardening, monitoring, backups

How to Choose the Right Agent

Complex Task?              → orchestrator (it delegates)
API or Backend?            → backend-engineer
UI/Frontend?               → frontend-dev
Security or Vulnerabilities? → security-analyst
Bug or Error?              → debugger
Testing?                   → test-runner
Documentation?             → documentation-writer
Code Review?               → code-review
API Design?                → api-specialist
Web Research?              → researcher
Deploy/CI/CD?              → deploy-specialist
Web Server/SSL?            → web-server-setup
Hardening/Servers?         → server-management

🛠️ Available Skills

Skill	When to Use
brainstorming 💡	BEFORE any creative work - explore requirements and design
writing-plans 📋	When you have specs/requirements for multi-step tasks
executing-plans ▶️	When you have a written plan to execute in separate session
requesting-code-review 🔍	When completing tasks, implementing features, or before merge
receiving-code-review 📥	When receiving code review feedback
verification-before-completion ✅	BEFORE claiming work is complete
systematic-debugging 🔧	When encountering bugs, test failures, or unexpected behavior
frontend-design 🎨	For creating high-quality frontend interfaces
skill-creator 🛠️	When you want to create or update skills
stripe-best-practices 💳	For Stripe integrations
deploy-automation 🚀	NEW
server-hardening 🔒	NEW
webserver-configuration 🌐	NEW

Recommended Skills Flow

New Feature:
  brainstorming → writing-plans → executing-plans → verification-before-completion

Bug Fix:
  systematic-debugging → [implement fix] → verification-before-completion

Code Review:
  requesting-code-review → [receive feedback] → receiving-code-review

Frontend:
  frontend-design → [implement] → verification-before-completion

Deploy:
  deploy-automation → [setup CI/CD] → verification-before-completion

Hardening:
  server-hardening → [security audit] → verification-before-completion

📋 Prerequisites

OpenCode installed
jq (for safe installation with merge)

Install jq

# Ubuntu/Debian
sudo apt install jq

# Fedora
sudo dnf install jq

# Arch Linux
sudo pacman -S jq

# macOS
brew install jq

# Windows (with Chocolatey)
choco install jq

🚀 Installation

Quick Method (Recommended)

# Clone the repository
git clone https://github.com/dolutech/dolu-agents-skills.git
cd dolu-agents-skills

# Run the installer
chmod +x install.sh
./install.sh

Manual Installation

# Create directories
mkdir -p ~/.config/opencode/agent
mkdir -p ~/.config/opencode/skills

# Copy agents
cp agents/*.md ~/.config/opencode/agent/

# Copy skills
cp -r skills/* ~/.config/opencode/skills/

# Copy GUIDELINES
cp GUIDELINES.md ~/.config/opencode/

# Merge configuration (requires jq)
# The script auto-detects whether you use opencode.json or opencode.jsonc
jq -s '
  .[0] as $user | .[1] as $pack |
  $user * {
    "agent": ($pack.agent * ($user.agent // {})),
    "mcp": ($pack.mcp * ($user.mcp // {}))
  }
' ~/.config/opencode/opencode.jsonc opencode.agents.json > /tmp/merged.json
mv /tmp/merged.json ~/.config/opencode/opencode.jsonc

Installation Options

The install.sh script offers 4 options:

Option	Description
1) Everything	Installs agents + skills + MCPs (recommended)
2) Agents + MCPs only	Only agents and MCPs
3) Skills only	Only skills
4) Choose individually	Choose each component individually

Installation Safety

✅ The installation script:

Preserves your existing settings (API keys, providers, models)
Creates automatic backup before modifying
Does safe merge (doesn't overwrite existing agents with same name)
Only adds, never removes

🗑️ Uninstallation

./uninstall.sh

The uninstallation script:

✅ Removes all Dolu agents
✅ Removes all Dolu skills
✅ Cleans entries from opencode.json/opencode.jsonc
✅ PRESERVES your existing settings (API keys, providers, etc.)
✅ Creates backup before modifying

Compatibility: tested with opencode 1.18.x (current schema using mcp instead of mcpServers). Agents are loaded via the {file:...} variable in prompt, supported by modern versions.

💡 Usage Examples

Example 1: Using Orchestrator for Complete Feature

You: "I need to implement a push notification system"

Orchestrator will:
1. 📋 Analyze requirements and create plan
2. ⚙️ Delegate to backend-engineer (API + Background Jobs)
3. 🎨 Delegate to frontend-dev (Preferences UI)
4. 🔐 Delegate to security-analyst (security review)
5. 🧪 Coordinate tests with test-runner
6. 📝 Document with documentation-writer
7. ✅ Verify quality with code-review

Example 2: Using Security Analyst

You: "Analyze this code for vulnerabilities"

Security Analyst will:
1. 🔍 Map attack surface
2. 🎯 Identify vulnerabilities (OWASP Top 10)
3. 💣 Develop proof-of-concept exploits
4. 📊 Calculate CVSS scores
5. 🛡️ Provide complete remediation with secure code

Example 3: Using Systematic Debugging Skill

You: "Tests are failing randomly"

Skill will:
1. 📖 Read error messages completely
2. 🔄 Reproduce consistently
3. 🔎 Check recent changes
4. 📊 Collect evidence at each layer
5. 🔍 Trace data flow
6. ✅ Identify root cause BEFORE proposing fix

Example 4: Complete Feature Flow

You: "I want to add OAuth2 authentication"

1. 💡 brainstorming skill
   → Explores requirements, options, design
   
2. 📋 writing-plans skill
   → Creates detailed implementation plan
   
3. ▶️ executing-plans skill (or orchestrator)
   → Executes plan task by task
   
4. 🔍 requesting-code-review skill
   → Requests code review
   
5. 📥 receiving-code-review skill
   → Processes review feedback
   
6. ✅ verification-before-completion skill
   → Verifies everything before claiming complete

🔗 Configured MCP Servers

MCP Server	Status	Description
chrome-devtools	✅ Enabled	Chrome control for debugging and testing
playwright	⚪ Optional	Browser automation for E2E tests
memory	✅ Enabled	Persistent memory between sessions
fetch	⚪ Optional	URL fetching for research

🆕 New DevOps Agents & Skills (v1.1)

We've just added 3 new DevOps specialist agents and 3 new skills for infrastructure automation!

🚀 New: Deploy Specialist Agent

Specialty: CI/CD, deployments, Kubernetes, Docker, and infrastructure automation

What it does:

Sets up CI/CD pipelines (GitHub Actions, GitLab CI, Jenkins)
Implements deployment strategies (rolling, blue-green, canary)
Creates automatic rollback procedures
Manages multiple environments (dev, staging, production)
Automates database migrations
Implements GitOps with ArgoCD

When to use:

"Set up a CI/CD pipeline for my Node.js application"
"Implement blue-green deployment on Kubernetes"
"Create a canary deployment strategy with automatic rollback"
"Configure GitOps with ArgoCD"

Associated Skill: deploy-automation

🌐 New: Web Server Setup Agent

Specialty: Nginx, Apache, Traefik, Caddy, SSL/TLS, and load balancing

What it does:

Installs and configures web servers (Nginx, Apache, Traefik, Caddy)
Configures SSL/TLS certificates (Let's Encrypt, Certbot)
Implements reverse proxy and load balancing
Optimizes performance (HTTP/2, HTTP/3, caching, compression)
Adds security headers
Configures virtual hosts

When to use:

"Configure Nginx as a reverse proxy with SSL"
"Set up load balancing across 3 backend servers"
"Configure automatic SSL certificates with Let's Encrypt"
"Optimize Nginx for high-traffic applications"
"Set up Traefik with Docker and automatic HTTPS"

Associated Skill: webserver-configuration

🖥️ New: Server Management Agent

Specialty: Linux server administration, security hardening, monitoring, and backups

What it does:

Hardens servers based on CIS Benchmarks
Configures firewalls (UFW, iptables)
Implements SSH hardening
Sets up monitoring (Prometheus, Grafana, Netdata)
Creates backup strategies (BorgBackup, Restic)
Optimizes system performance
Configures intrusion detection (Fail2ban)

When to use:

"Harden my Ubuntu server following CIS Benchmarks"
"Set up Prometheus and Grafana monitoring"
"Create a comprehensive backup strategy"
"Configure Fail2ban and intrusion detection"
"Optimize Linux kernel parameters for performance"

Associated Skill: server-hardening

🛠️ New DevOps Skills

Deploy Automation

Purpose: Complete workflows for CI/CD, deployment strategies, and production releases

Includes:

CI/CD pipeline patterns (GitHub Actions, GitLab CI, Jenkins)
Deployment strategies (rolling, blue-green, canary)
Rollback procedures
Safe database migrations
Feature flags

When to use:

"Use deploy-automation skill to create a CI/CD pipeline"
"Implement canary deployment with deploy-automation skill"

Server Hardening

Purpose: Complete server hardening based on CIS Benchmarks

Includes:

Automated hardening scripts
CIS Benchmarks implementation guide
Complete security checklist
Audit logging configuration
Security monitoring

When to use:

"Use server-hardening skill to secure my server"
"Implement CIS Benchmarks with server-hardening skill"

Web Server Configuration

Purpose: Complete web server configuration

Includes:

Production Nginx configurations
Apache and virtual hosts configurations
Traefik and Caddy setup
SSL/TLS configuration guide
Performance tuning

When to use:

"Use webserver-configuration skill to configure Nginx"
"Configure SSL/TLS with webserver-configuration skill"

🤝 Contributing

Contributions are welcome! Please read CONTRIBUTING.md for details.

Ways to Contribute

🐛 Report bugs
💡 Suggest new features
🤖 Add new agents
🛠️ Create new skills
📚 Improve documentation
🌍 Translate to other languages

Quick Start for Contributors

# Fork and clone
git clone https://github.com/your-username/dolu-agents-skills.git

# Create a branch
git checkout -b feature/my-feature

# Make your changes
# ...

# Commit following Conventional Commits
git commit -m "feat: add new xyz agent"

# Push and PR
git push origin feature/my-feature

📈 Roadmap

✅ v1.1 (March 2026) - DevOps & Infrastructure

Deploy Specialist Agent (CI/CD, Kubernetes, Docker)
Web Server Setup Agent (Nginx, Apache, Traefik, Caddy)
Server Management Agent (Linux, hardening, monitoring)
Deploy Automation Skill
Server Hardening Skill
Web Server Configuration Skill
Complete documentation in PT/EN

✅ v1.2 (August 2026) - OpenCode 1.18.x Compatibility

Compatibility with the current opencode schema (mcp key, not mcpServers)
Support for both opencode.json and opencode.jsonc in the installer
Safe merge that preserves the user's existing agents
Fixed uninstaller (cleans mcp, dynamic list of all 13 agents/skills)
Removed invalid instructions field from the security-analyst agent
Added docs/CHANGELOG.md

🔜 v1.3 - Cloud & Advanced Features

AWS Specialist Agent
GCP Specialist Agent
Azure Specialist Agent
Cloud Infrastructure Skills
Terraform/CloudFormation patterns
Kubernetes advanced patterns

🔜 v1.4 - Database & Performance

Database Specialist Agent (PostgreSQL, MySQL, MongoDB)
Performance Optimization Agent
Database migration skills
Query optimization patterns
Caching strategies

🔜 v1.5 - Monitoring & Observability

Monitoring Specialist Agent
Observability patterns
Logging best practices
Alerting strategies
Dashboard templates

🔮 Future (2026+)

Multi-language support (ES, FR, DE)
Project templates
Integration with more MCPs
AI-powered code suggestions
Custom agent creation tool

📄 License

This project is licensed under the MIT License.

In short: You can do whatever you want with this code! 🎉

✅ Commercial use
✅ Modification
✅ Distribution
✅

Dolu Agents Skills

At a glance

README

🤖 Dolu Agents & Skills

📖 Sobre o Projeto

🎯 Por que usar?

✨ Features

🤖 Agentes Disponíveis

Como Escolher o Agente Certo

🛠️ Skills Disponíveis

Fluxo Recomendado de Skills

📋 Pré-requisitos

Instalar jq

🚀 Instalação

Método Rápido (Recomendado)

Instalação Manual

Opções de Instalação

Segurança da Instalação

🗑️ Desinstalação

📁 Estrutura do Projeto

💡 Exemplos de Uso

Exemplo 1: Usando o Orchestrator para Feature Completa

Exemplo 2: Usando o Security Analyst

Exemplo 3: Usando Systematic Debugging Skill

Exemplo 4: Fluxo Completo de Feature

Exemplo 5: Usando o Deploy Specialist

Exemplo 6: Usando o Web Server Setup

Exemplo 7: Usando o Server Management

🔒 Segurança

Nos Agentes

Nos Skills

Documentação

🔗 MCP Servers Configurados

🤝 Contribuindo

Formas de Contribuir

Quick Start para Contribuidores

📈 Roadmap

✅ v1.1 (Março 2026) - DevOps & Infrastructure

✅ v1.2 (Agosto 2026) - Compatibilidade OpenCode 1.18.x

🔜 v1.3 - Cloud & Advanced Features

🔜 v1.4 - Database & Performance

🔜 v1.5 - Monitoring & Observability

🔮 Futuro (2026+)

📄 Licença

🙏 Créditos e Agradecimentos

Autor

Atribuições

Inspirado por

Agradecimentos

📞 Contato e Suporte

⭐ Se este projeto foi útil, considere dar uma estrela! ⭐

🆕 Novos Agentes e Skills DevOps (v1.1)

🚀 Novo: Deploy Specialist Agent

🌐 Novo: Web Server Setup Agent

🖥️ Novo: Server Management Agent

🛠️ Novas Skills DevOps

Deploy Automation

Server Hardening

Web Server Configuration

🇺🇸 English Version

🤖 Dolu Agents & Skills

📖 About

🎯 Why Use?

✨ Features

🤖 Available Agents

How to Choose the Right Agent

🛠️ Available Skills

Recommended Skills Flow

📋 Prerequisites

Install jq

🚀 Installation

Quick Method (Recommended)

Manual Installation

Installation Options

Installation Safety

🗑️ Uninstallation

💡 Usage Examples

Example 1: Using Orchestrator for Complete Feature

Example 2: Using Security Analyst

Example 3: Using Systematic Debugging Skill