Perguntas sobre skills do Claude, respondidas de forma direta

Não. Uma skill é uma pasta de instruções escritas que o agente lê quando uma tarefa combina com a descrição dela. Um servidor MCP é um processo em execução que expõe ferramentas novas por um protocolo. Skills mudam como o agente trabalha com o que já tem. MCP muda o que ele consegue alcançar.

Uma skill é um diretório cujo nome coincide com o nome no frontmatter, contendo SKILL.md e os scripts, referências e assets opcionais. Onde esse diretório fica decide o escopo: junto de um projeto para um repositório só, ou na sua configuração de usuário para todas as sessões.

Depende de onde você usa o Claude. No Claude Code você copia o diretório da skill para ~/.claude/skills/ ou para o .claude/skills/ do projeto, sem etapa de upload. No claude.ai você envia a pasta como arquivo ZIP, e com a API do Claude você a envia pelos endpoints de Skills. Uma skill instalada em uma superfície não aparece nas outras.

Quase sempre é a descrição. Só o nome e a descrição são carregados na inicialização, então esse único campo é toda a base sobre a qual o agente decide que uma tarefa combina. Uma descrição que diz o que a skill é, sem dizer quando usá-la, não dá ao agente nada com que comparar.

As instruções do projeto são lidas em toda tarefa daquele projeto. Uma skill é lida só quando uma tarefa combina com a descrição dela. Coloque nas instruções aquilo que é sempre verdade, e numa skill aquilo que é verdade para um tipo de trabalho.

Cerca de 100 tokens cada uma enquanto está parada, porque só o nome e a descrição são carregados na inicialização. O corpo do SKILL.md é carregado quando a skill ativa, e a recomendação é manter isso abaixo de 5.000 tokens. Arquivos em scripts, references e assets são lidos só quando a tarefa precisa.

Uma skill pode carregar código executável em scripts/, e o agente pode rodá-lo quando a tarefa pede. A skill não roda sozinha e não tem processo em segundo plano. Quem executa é o agente, com as permissões que a sua configuração der a ele.

Guarde-as no repositório a que se aplicam e deixe o controle de versão fazer a distribuição. Quem clonar recebe as mesmas skills na mesma revisão, mudanças chegam por revisão como qualquer outra mudança, e não há uma cópia paralela para divergir.

No Claude Code, os comandos personalizados foram incorporados às skills: um arquivo em .claude/commands/deploy.md e uma skill em .claude/skills/deploy/SKILL.md criam o mesmo /deploy. Um plugin é outra camada. Ele empacota skills com agentes, hooks e servidores MCP para instalar tudo como uma unidade, e as skills dele rodam como /plugin-name:skill-name.

O formato SKILL.md é comum, mas cada produto instala skills do seu jeito. O claude.ai recebe um zip para um único usuário, a API do Claude recebe envios para um workspace inteiro e o Claude Code lê pastas do disco. Uma skill enviada ao claude.ai não fica disponível na API, nem o contrário.

Ele lista ferramentas que uma skill pode usar sem pedir permissão. A especificação o define como uma string de ferramentas pré-aprovadas separadas por espaço e o marca como experimental. No Claude Code a aprovação vale só para o turno que invoca a skill e não restringe nada: ferramentas fora da lista seguem com as suas permissões de sempre.

Confira duas coisas separadamente: se a skill é acionada nos pedidos em que deveria e se o resultado dela é o que você queria. Rode alguns pedidos realistas numa sessão nova com a skill disponível, depois de novo com ela desligada, e compare. Ser acionada só mostra que a skill foi encontrada, não que ajudou.