[ajuda] deu erro

A habilidade não aparece ou o AFK não usa quando eu peço

digite /skills e procure a habilidade na lista. Se ela não está lá, a conversa foi aberta na pasta errada ou a habilidade está num pacote desligado. Se ela está lá e o AFK não usa, a descrição não tem as palavras que você falou.

Passo a passo

Veja a lista. Na conversa, digite:
```
/skills
```
Digite parte do nome para filtrar.
Não está na lista? Siga na ordem:
- Confira a pasta: abra a conversa pelo atalho Conversar com o AFK. Veja Abri a pasta errada e as habilidades não aparecem.
- Ligue o pacote: no painel, abra Sistema > Pacotes de skills e ligue o pacote da habilidade. Ou peça na conversa, por exemplo "liga as habilidades de vendas".
- Habilidade criada por você: ela tem de estar em .claude\skills\<nome>\SKILL.md. Veja Adicionar uma habilidade nova do jeito certo.
Está na lista e não é chamada? Peça com outras palavras, mais perto do que a habilidade faz. Se funcionar, peça na conversa "inclui essa frase na descrição da habilidade <nome>". Para chamar na hora, digite / e o nome dela.
Rode o verificador. No PowerShell, dentro da pasta do AFK:
```
python ferramentas\manutencao\verificar-skills.py
```
Cada linha com problema diz o arquivo e o que corrigir.
Habilidade criada ou mudada agora. O Claude Code percebe a mudança sozinho na mesma conversa. Se não aparecer, digite /reload-skills ou abra uma conversa nova.

Por que uma habilidade que funcionava parou de ser chamada

A lista de habilidades entra em toda conversa e tem um teto. Quando passa dele, o Claude Code tira a descrição das habilidades menos usadas e deixa só o nome. Sem a descrição, a fala normal não acha a habilidade. Desligar os pacotes que você não usa, em Sistema > Pacotes de skills, devolve espaço para as outras.

Para ver o tamanho da lista, digite /context e olhe a linha Skills.

Erros e soluções

O que aparece	O que fazer
A lista de `/skills` não tem nenhuma habilidade do AFK	Pasta errada. Veja Abri a pasta errada e as habilidades não aparecem.
Várias habilidades pararam de ser chamadas pela fala ao mesmo tempo	O teto da lista estourou. Desligue pacotes que você não usa.
`/nome` funciona, mas a fala normal não chama	A descrição não tem as palavras que você usa. Passo 3.
A habilidade sumiu depois de desligar um pacote	Ela está dormindo. Ligue o pacote de novo; nada foi apagado.
O AFK começou a seguir a habilidade e parou no meio de uma conversa longa	A conversa foi resumida e o roteiro ficou pela metade. Chame a habilidade de novo. Veja Apareceu "Prompt is too long" ou a conversa ficou longa demais.
`description vazia` no verificador	A primeira linha do `SKILL.md` precisa ser `---`. Peça "corrige a habilidade <nome>".

Se nada funcionar

Mande o print do /skills, o nome da habilidade e a saída do verificador, seguindo Travou ou quero sugerir uma melhoria: o que mandar.

Fontes oficiais (conferido em 28/10/2026): code.claude.com/docs/en/skills (habilidade que não é chamada, teto da lista, mudança percebida na conversa) · code.claude.com/docs/en/commands (/skills, /reload-skills, /context).

Quando algo dá errado

Não resolveu?

Escreva para contato@afk.ia.br com o passo em que você estava, o que apareceu na tela e um print. A lista do que mandar está em travou ou quer sugerir algo.