Como Criar Skills para OpenClaw

Skills são extensões modulares que expandem as capacidades do seu agente OpenClaw. Pense nelas como “superpoderes” que você pode adicionar, remover ou compartilhar com a comunidade.

O Que São Skills?

Uma Skill é um pacote que contém:

SKILL.md - Instruções que o agente segue
Scripts - Código auxiliar (opcional)
Referências - Documentação e exemplos

Quando você diz “preciso enviar um email”, o OpenClaw procura uma Skill relevante e segue suas instruções automaticamente.

Estrutura Básica de uma Skill

minha-skill/
├── SKILL.md          # Obrigatório: instruções para o agente
├── scripts/          # Opcional: scripts auxiliares
│   └── helper.sh
├── references/       # Opcional: documentação
│   └── api-docs.md
└── assets/          # Opcional: imagens, templates
    └── template.txt

Passo 1: Criar o Diretório

Crie uma pasta para sua Skill no diretório skills/ do seu workspace:

mkdir -p ~/clawd/skills/minha-skill
cd ~/clawd/skills/minha-skill

Passo 2: Escrever o SKILL.md

O arquivo SKILL.md é o coração da sua Skill. Ele contém instruções em linguagem natural que o agente seguirá.

Exemplo: Skill de Clima

# Skill: Clima

## Descrição
Consulta a previsão do tempo usando o wttr.in.

## Quando Usar
- Usuário pergunta sobre o clima
- Usuário quer saber se vai chover
- Usuário planeja atividades ao ar livre

## Como Executar

1. Identifique a cidade mencionada (padrão: São Paulo)
2. Execute o comando:
   ```bash
   curl -s "wttr.in/{cidade}?format=3&lang=pt"

Para previsão detalhada:
```
curl -s "wttr.in/{cidade}?lang=pt"
```

Exemplos de Uso

Entrada: “Como está o tempo em Florianópolis?” Ação: curl -s "wttr.in/Florianópolis?format=3&lang=pt"

Entrada: “Vai chover amanhã?” Ação: Consultar previsão detalhada da cidade atual


## Passo 3: Adicionar Scripts (Opcional)

Para tarefas mais complexas, adicione scripts auxiliares:

```bash
mkdir scripts

Exemplo de script scripts/check-weather.sh:

#!/bin/bash
# Consulta clima com formatação bonita

CIDADE="${1:-São Paulo}"
curl -s "wttr.in/${CIDADE}?lang=pt&format=%l:+%c+%t+%h+%w"

No SKILL.md, referencie o script:

## Como Executar
Execute o script auxiliar:
```bash
./scripts/check-weather.sh "Nome da Cidade"


## Passo 4: Incluir Referências (Opcional)

Para Skills que usam APIs ou têm documentação específica:

```bash
mkdir references

Crie references/api.md com informações relevantes que o agente pode consultar.

Melhores Práticas para SKILL.md

1. Seja Específico nos Gatilhos

❌ Ruim:

## Quando Usar
- Quando o usuário pedir

✅ Bom:

## Quando Usar
- Usuário menciona "clima", "tempo", "previsão"
- Usuário pergunta se vai chover ou fazer sol
- Usuário planeja viagem ou atividade ao ar livre

2. Forneça Exemplos Concretos

Exemplos ajudam o agente a entender o padrão esperado:

## Exemplos

**Entrada:** "Manda um resumo do projeto pro time"
**Ação:** 
1. Ler MEMORY.md para contexto do projeto
2. Gerar resumo com últimas decisões
3. Enviar via Slack para canal #equipe

3. Trate Erros

## Tratamento de Erros

Se a API retornar erro:
1. Informar o usuário sobre o problema
2. Sugerir alternativa (se houver)
3. Não inventar dados

Se cidade não for encontrada:
1. Perguntar ao usuário qual cidade quis dizer
2. Sugerir cidades similares

4. Defina Limites

## Limitações

- Não enviar mais de 5 mensagens por minuto
- Não acessar dados sensíveis sem confirmação
- Não fazer alterações permanentes sem backup

Skills com Integrações

Skill de Email

# Skill: Email via Gmail

## Pré-requisitos
- Integração Gmail configurada em /integracoes/gmail/

## Quando Usar
- Enviar emails
- Ler caixa de entrada
- Responder mensagens

## Fluxo de Envio

1. Confirmar destinatário com usuário
2. Compor mensagem
3. Pedir confirmação antes de enviar
4. Enviar e confirmar sucesso

Skill de Calendário

# Skill: Google Calendar

## Quando Usar
- Agendar eventos
- Verificar disponibilidade
- Listar compromissos

## Verificar Agenda

```bash
# Listar eventos de hoje
gcalcli agenda --calendar "primary" today tomorrow

Criar Evento

Sempre confirmar com usuário:

Data e hora
Título do evento
Participantes (se houver)


## Testando Sua Skill

### 1. Verificar Estrutura

```bash
ls -la ~/clawd/skills/minha-skill/
# Deve mostrar pelo menos SKILL.md

2. Testar no Chat

Inicie uma conversa com seu agente e teste os gatilhos:

Você: Como está o clima hoje?
Agente: [Deve acionar a Skill de clima]

3. Verificar Logs

Se algo não funcionar, verifique se a Skill foi carregada:

# No OpenClaw, use /status para ver Skills ativas

Publicando Sua Skill

1. Documentar no README

Crie um README.md explicando:

O que a Skill faz
Pré-requisitos
Como instalar
Exemplos de uso

2. Estrutura para Publicação

minha-skill/
├── README.md         # Documentação para usuários
├── SKILL.md          # Instruções para o agente
├── CHANGELOG.md      # Histórico de versões
├── scripts/
└── references/

3. Compartilhar

ClawhHub: Publique em clawhub.com
GitHub: Crie um repositório público
Discord: Compartilhe na comunidade OpenClaw

Skills Avançadas

Multi-Step Skills

Para tarefas complexas com múltiplas etapas:

# Skill: Relatório Semanal

## Fluxo Completo

### Etapa 1: Coleta de Dados
1. Ler commits da semana no Git
2. Verificar tarefas concluídas
3. Listar métricas relevantes

### Etapa 2: Análise
1. Identificar principais conquistas
2. Listar bloqueios encontrados
3. Calcular progresso vs. metas

### Etapa 3: Geração
1. Criar relatório em Markdown
2. Incluir gráficos se disponíveis
3. Salvar em reports/YYYY-MM-DD.md

### Etapa 4: Distribuição
1. Enviar por email ao gestor
2. Postar resumo no Slack
3. Atualizar dashboard

Skills com Estado

Para Skills que precisam lembrar informações:

## Persistência

Salvar estado em `~/.clawd/skills/minha-skill/state.json`:

```json
{
  "lastRun": "2026-02-01T10:00:00Z",
  "counter": 42,
  "preferences": {}
}

Carregar estado no início de cada execução.


### Skills Condicionais

```markdown
## Comportamento Condicional

### Se horário comercial (9h-18h):
- Enviar notificações normalmente
- Agendar reuniões

### Se fora do horário:
- Acumular notificações para manhã seguinte
- Não agendar reuniões
- Apenas alertas urgentes passam

Exemplos de Skills Úteis

1. Skill de Resumo de Artigos

# Skill: Resumo de Artigos

## Quando Usar
- Usuário compartilha URL de artigo
- Usuário pede resumo de texto longo

## Como Executar
1. Extrair conteúdo da URL (se aplicável)
2. Identificar pontos principais
3. Gerar resumo em 3-5 parágrafos
4. Listar principais conclusões

2. Skill de Tradução

# Skill: Tradução

## Quando Usar
- Usuário pede tradução
- Texto em idioma diferente do preferido

## Idiomas Suportados
- Português ↔ Inglês
- Português ↔ Espanhol
- Inglês ↔ Espanhol

## Comportamento
- Manter tom e estilo original
- Preservar formatação
- Indicar termos sem tradução direta

3. Skill de Code Review

# Skill: Code Review

## Quando Usar
- Usuário compartilha código
- Usuário pede revisão de PR

## Análise
1. Verificar erros de sintaxe
2. Identificar problemas de segurança
3. Sugerir melhorias de performance
4. Avaliar legibilidade

## Formato de Resposta
- Pontos positivos primeiro
- Problemas críticos destacados
- Sugestões com exemplos de código

Solução de Problemas

Skill Não é Acionada

Verifique se o SKILL.md existe
Confirme que os gatilhos estão claros
Reinicie o OpenClaw para recarregar Skills

Skill Executa Incorretamente

Revise as instruções no SKILL.md
Adicione mais exemplos
Seja mais específico nos passos

Scripts Não Executam

Verifique permissões: chmod +x script.sh
Confirme que o caminho está correto
Teste o script manualmente primeiro

Próximos Passos

Personalizar SOUL.md - Defina a personalidade do agente
Configurar Memória - Faça o agente lembrar contexto
Explorar Skills Prontas - Veja Skills da comunidade

Dica: Comece com Skills simples e vá adicionando complexidade conforme aprende. A melhor Skill é aquela que resolve um problema real do seu dia a dia!

Como Criar Skills para OpenClaw - Guia Completo