Como adicionar uma habilidade nova no AFK do jeito certo

Habilidade (em inglês, *skill*) é um roteiro que ensina o AFK a fazer uma tarefa do seu jeito. Ela é chamada pela fala normal; o comando com / é só um atalho.

Passo a passo

Criar uma habilidade sua

1. Descreva a tarefa na conversa. Diga o que você faz, quando faz e um exemplo real. Exemplo: "toda sexta eu mando para os clientes da semana uma mensagem de agradecimento; vira uma habilidade".
2. Diga também o que nunca pode acontecer nessa tarefa e como você confere que ficou certo. Se faltar algo, o AFK pergunta.
3. Confira onde ela ficou. A habilidade nasce em .claude\skills\<nome>\SKILL.md, dentro da pasta do AFK. Ela entra em teste por 30 dias e só fica de vez depois de usada e aprovada por você.
4. Teste pela fala. Numa conversa nova, peça a tarefa com outras palavras, sem o /. Se o AFK não usar a habilidade, peça para incluir essa frase na descrição dela.
5. Rode o verificador. No PowerShell, dentro da pasta do AFK:

   python ferramentas\manutencao\verificar-skills.py

   Deu certo quando a última linha termina em ok. Se aparecer um problema, cole a saída na conversa e peça "corrige a habilidade".

Trazer uma habilidade de fora

1. Confira a origem e a licença. Só traga de quem você conhece, e só se a licença permitir usar. Sem licença clara, não use.
2. Passe no antivírus antes de copiar. O antivírus do AFK procura texto que tenta dar ordens escondidas para a IA. Para cada arquivo .md da habilidade baixada:

   node ferramentas\seguranca\escudo.mjs examinar C:\caminho\da\habilidade\SKILL.md

   Pode seguir quando aparece nada em ... tenta mandar na IA. Se aparecer tem texto que tenta mandar na IA, não instale.

3. Leia o que ela manda rodar. O antivírus lê só o texto; script que vem junto (.py, .js, .ps1, .bat) ele não examina. Comando que instala programa, baixa arquivo ou mexe fora da pasta do AFK precisa de motivo claro. Na dúvida, cole o arquivo na conversa e pergunte "essa habilidade é segura?".
4. Copie para a pasta certa: .claude\skills\<nome>\SKILL.md. O nome da pasta é igual ao name: do arquivo, em minúsculas, com hífen no lugar do espaço.
5. Rode o verificador (o mesmo comando de "Criar uma habilidade sua", passo 5) e teste pela fala.

Com o mod do AFK ligado, o Guardião segura comando perigoso antes de rodar e pergunta antes de instalar pacote pouco baixado, também quando quem pede é uma habilidade.

O que uma boa habilidade tem

Para abrir espaço na lista, desligue o que você não usa no painel, em Sistema > Pacotes de skills. Nada é apagado: o pacote desligado dorme e volta com um clique.

A atualização do AFK não apaga habilidade sua. Se uma versão nova trouxer um arquivo no mesmo caminho, fica o seu e o novo vai para meu-negocio\atualizacao\.

Erros e soluções

Se nada funcionar

Mande o arquivo SKILL.md da habilidade e a saída do verificador, seguindo Travou ou quero sugerir uma melhoria: o que mandar.

Fonte oficial (conferido em 28/10/2026): code.claude.com/docs/en/skills (onde ficam as habilidades, descrição, teto da lista e o --- na primeira linha).