---
title: "Erro Skill Not Found — Skill Não Encontrada"
url: "https://openclaw.ia.br/erros/skill-not-found/"
markdown_url: "https://openclaw.ia.br/erros/skill-not-found.MD"
description: "Como resolver erro de skill não encontrada no OpenClaw. Instalação, paths e troubleshooting."
date: ""
author: ""
---

# Erro Skill Not Found — Skill Não Encontrada

Como resolver erro de skill não encontrada no OpenClaw. Instalação, paths e troubleshooting.


# Erro: Skill Not Found

O OpenClaw não conseguiu encontrar uma skill. Veja como resolver.

## O Que Significa

```
Error: Skill 'weather' not found
Error: Cannot load skill at /path/to/skill
Error: SKILL.md not found in skill directory
```

O sistema tentou usar uma skill que não está instalada ou está com path incorreto.

## Causas Comuns

### 1. Skill Não Instalada

A skill não foi instalada via ClawdHub ou manualmente.

### 2. Nome Incorreto

Digitou errado o nome da skill.

### 3. Path Incorreto

Skill está em diretório diferente do esperado.

### 4. SKILL.md Ausente

A skill existe mas falta o arquivo de definição.

## Soluções

### Verificar Skills Instaladas

```bash
# Listar skills disponíveis
clawdhub list

# Ou pergunte
"Quais skills tenho instaladas?"
```

### Instalar Skill

```bash
# Via ClawdHub
clawdhub install weather

# Verificar instalação
clawdhub list | grep weather
```

### Verificar Nome Correto

Nomes de skills são case-sensitive:
- ✅ `weather`
- Não `Weather`
- Não `WEATHER`

### Verificar Path

Skills devem estar em:
```
~/clawd/skills/[nome]/SKILL.md
```

Ou no path global:
```
~/.openclaw/skills/[nome]/SKILL.md
```

### Criar SKILL.md Faltante

Se a skill existe mas falta o arquivo:

```markdown
# SKILL.md mínimo

---
name: nome-da-skill
description: O que a skill faz
---

## Uso

Como usar a skill...
```

## Estrutura Correta de Skill

```
skills/
└── weather/
    ├── SKILL.md          # Obrigatório
    ├── index.js          # Código (opcional)
    └── config.yaml       # Config (opcional)
```

## Verificar Logs

```bash
# Ver erro detalhado
openclaw logs | grep -i skill

# Modo debug
DEBUG=skills* openclaw gateway restart
```

## Reinstalar Skill

Se nada funcionar:

```bash
# Remover
clawdhub uninstall weather

# Reinstalar
clawdhub install weather
```

## Skills Built-in

Algumas skills já vêm com o OpenClaw:
- `calculator` - Cálculos e conversões
- `weather` - Previsão do tempo
- `web_search` - Busca na web

Se uma built-in não funciona, atualize o OpenClaw:
```bash
npm update -g openclaw
```

## Criar Skill Local

Se quiser criar skill própria:

1. Crie diretório: `mkdir -p ~/clawd/skills/minha-skill`
2. Crie SKILL.md com instruções
3. Opcionalmente adicione código
4. Reinicie gateway

## Próximos Passos

- [Criar sua skill](/guias/criar-skill/)
- [ClawdHub](https://clawdhub.com) - Marketplace
- [Troubleshooting](/troubleshooting/)