# Como usar skills no Claude Code: instalação e primeira tarefa Configure uma skill local no Claude Code, escolha o escopo e avalie uma primeira tarefa de análise antes de partir para alterações no projeto. Autoria: Angelo Sebastião Silva Goncalves Publicado: 2026-11-07T12:00:00.000Z Revisado: 2026-10-27T22:10:46.257Z URL canônica: https://nextags.com.br/blog/como-usar-skills-no-claude-code-instalacao-e-primeira-tarefa/ Para usar uma skill local no Claude Code, coloque a rotina no escopo adequado, preserve o arquivo de instruções e acione-a em uma tarefa compatível. Uma primeira experiência útil é revisar o escopo de uma mudança antes de editar código. Assim, você consegue avaliar a rotina sem misturar análise e implementação na mesma entrega. O foco deste guia é uma skill de projeto, mantida junto ao repositório. A instalação pelo aplicativo Claude segue outro percurso. Escolher o ambiente antes de copiar arquivos evita uma configuração que parece correta, mas está no lugar errado. ## Escolha entre escopo pessoal e de projeto O [guia de skills do Claude Code](https://code.claude.com/docs/en/skills) documenta `~/.claude/skills` para uso pessoal e `.claude/skills` para o projeto. A definição local usa `SKILL.md`, com metadados e instruções. Use uma rotina pessoal para preferências que fazem sentido em trabalhos diferentes. Para um procedimento específico da equipe, considere o escopo do projeto e a revisão pelo fluxo habitual do repositório. Antes de adicionar um pacote pronto, examine sua origem e seus recursos. A existência de um nome conhecido não garante que a rotina corresponde ao código ou às regras da sua equipe. ## Crie uma primeira rotina pequena Vamos usar uma revisão de escopo. A entrega será uma lista de arquivos possivelmente envolvidos, riscos e verificações sugeridas, sem implementar a mudança nessa rodada. Na pasta de skills do projeto, organize uma subpasta para essa rotina e o arquivo de definição. O exemplo abaixo é autoral e serve como ponto de partida para discussão: ```yaml --- name: revisar-escopo description: Analisar um pedido de mudança e listar escopo, riscos e verificações antes da implementação. --- ``` No corpo das instruções, descreva o procedimento: ```text Leia o pedido e o contexto disponível no projeto. Liste os arquivos que parecem relevantes e explique a relação com a mudança. Destaque informações ausentes e riscos de comportamento. Proponha verificações que permitam avaliar a alteração. Nesta etapa, entregue a análise sem editar arquivos. ``` Não acrescente uma longa lista de regras apenas para dar aparência de completude. Cada instrução deve ajudar a reconhecer uma decisão ou evitar um erro identificado. ## Acione a skill com um pedido verificável A documentação permite chamar uma skill por `/nome` ou utilizá-la quando for pertinente. Para esta rotina, o acionamento explícito ajuda a relacionar o pedido ao procedimento avaliado. Você pode iniciar com: ```text /revisar-escopo Quero acrescentar uma mensagem de confirmação após uma solicitação ser enviada. Analise o fluxo existente e indique escopo, dúvidas e verificações. Ainda não implemente a mudança. ``` O pedido não precisa incluir uma solução antecipada. Se você determina um arquivo sem conhecer a organização do projeto, pode restringir a análise ao lugar errado. Explique o comportamento desejado e deixe a relação com o código aparecer na justificativa. Compare a resposta com o pedido. Ela encontrou o caminho de envio? Distinguiu confirmação visual de conclusão da operação? Registrou as dúvidas que impedem uma implementação segura? ## Corrija a rotina a partir da saída Separe problemas de entrada e problemas de instrução. Se o objetivo estava ambíguo, melhore o pedido. Se a rotina ignorou um critério que deveria permanecer estável, revise o procedimento. Uma correção concreta pode ser exigir que a análise considere falhas de envio, em vez de olhar apenas o caminho bem-sucedido. Outra é pedir que cada arquivo listado tenha uma justificativa, para evitar um inventário extenso sem utilidade. Mantenha um caso aprovado como referência. Na próxima alteração da skill, avalie se esse caso continua produzindo uma análise adequada. A rotina deve facilitar o trabalho da equipe, não apenas gerar uma resposta mais longa. ## Instrução e permissão têm funções diferentes As [permissões do Claude Code](https://code.claude.com/docs/en/permissions) são controles do ambiente. Uma frase dentro da skill não substitui esses controles. Por isso, trate a orientação “não editar nesta etapa” como parte do procedimento e mantenha o modo de trabalho adequado ao que você autoriza. Quando a tarefa passar da análise para a implementação, revise o escopo e a ação solicitada. Também evite colocar credenciais ou referências privadas desnecessárias na rotina. Um procedimento versionado deve conter o contexto que a equipe pode compartilhar, não materiais que pertencem a uma sessão individual. ## Quando a primeira skill está pronta para uso A primeira versão deve ter finalidade reconhecível, entrada suficiente e saída que alguém consegue revisar. Para a análise de escopo, a equipe precisa conseguir decidir o que implementar, quais dúvidas resolver e como avaliar o resultado. Se a rotina termina em uma lista genérica de recomendações que serviria para qualquer projeto, estreite o procedimento. Prefira uma entrega menor que mostre sua relação com o código e com a solicitação. Quando o produto também tiver atendimento ao cliente, conheça o [Claude na Nextags](https://nextags.com.br/integracoes/claude/) para avaliar essa parte da operação. A skill local do Code não configura automaticamente um agente no AI Hub. ## Fontes - [Skills locais no Claude Code](https://code.claude.com/docs/en/skills) - [Controles de permissão no Code](https://code.claude.com/docs/en/permissions)