Criando sua primeira skill

So, let's create a skill. Então, vamos criar um skill. This skill will teach Claude how we would like it to explain code using visual diagrams and analogies. Este skill vai ensinar ao Claude como gostaríamos que ele explicasse código usando diagramas visuais e analogias. [music] [música] Then, we'll look at what happens under the hood when Claude uses it. Depois, vamos ver o que acontece nos bastidores quando o Claude o utiliza. First, [music] let's create a directory for your skill. Primeiro, [música] vamos criar um diretório para o seu skill. We're going to be making a personal skill, so it'll live in many projects, so it will go in your home directory. Vamos criar um skill pessoal, portanto ele poderá ser usado em muitos projetos e ficará no seu diretório home. Take into consideration that we're creating a directory with the skill name inside of the skills directory. Tenha em conta que estamos a criar um diretório com o nome do skill dentro do diretório skills. Now create the skill. Agora crie o skill. The name identifies your skill. O nome identifica o seu skill. The description tells Claude when to use it. A descrição diz ao Claude quando utilizá-lo. This is the matching criteria. Este é o critério de correspondência. And then everything after the second dashes is the instructions that Claude follows. E tudo depois dos segundos tracejados são as instruções que o Claude segue. Cloud code loads skills at startup. O Claude Code carrega os skills na inicialização. So restart your session. Por isso reinicie a sua sessão. Then verify it's available. Depois verifique se está disponível. You should see PR description in the list. Deverá ver PR description na lista. Now test it. Agora teste-o. Make some changes on a branch and say, "Write a PR description for my changes." Faça algumas alterações num branch e diga: "Escreve uma PR description para as minhas alterações." Claude will then show you that it's using the PR description skill. O Claude vai mostrar-lhe que está a usar o skill PR description. After that, it'll check your diff and write a description following your template. Depois disso, vai verificar o seu diff e escrever uma descrição seguindo o seu template. Same format every single time. O mesmo formato todas as vezes. When Cloud Code starts, it scans four locations for skills. Quando o Claude Code inicia, analisa quatro locais à procura de skills. Enterprise paths, your personal Claude skills, the project's Claude skills, and installed plugins. Caminhos enterprise, os seus skills pessoais do Claude, os skills do projeto e plugins instalados. It loads only the name and description of each skill, not the full content. Carrega apenas o nome e a descrição de cada skill, não o conteúdo completo. This is important later. Isto é importante mais tarde. When you send a request, Claude compares it to the descriptions of your skills. Quando envia um pedido, o Claude compara-o às descrições dos seus skills. Explain what this function does matches a skill described as explain code with visual diagrams because the intent overlaps. "Explica o que esta função faz" corresponde a um skill descrito como "explicar código com diagramas visuais" porque a intenção coincide. It will then ask you to confirm loading up the skill. Depois vai pedir-lhe que confirme o carregamento do skill. This confirmation step keeps you aware of what context Claude is using. Este passo de confirmação mantém-no informado sobre o contexto que o Claude está a usar. After you confirm, Claude reads the complete file and follows its instructions. Depois de confirmar, o Claude lê o ficheiro completo e segue as suas instruções. Now, let's say you clone a Git repository and have an overlapping skill name. Agora, suponha que clona um repositório Git e tem um nome de skill que se sobrepõe. Well, which one wins? Então, qual prevalece? Here's the priority list. Aqui está a lista de prioridades. The highest is enterprise, which lives in the manage settings. O mais alto é o enterprise, que fica nas definições de gestão. Two is the personal, which lives in your root directory configuration like we're doing right now. O segundo é o pessoal, que fica na configuração do seu diretório raiz, como estamos a fazer agora. Three is the project which is the claw directory inside of your repository. O terceiro é o projeto, que fica no diretório .claude dentro do seu repositório. And the lowest is the plugins where you store your plugins that you got online. E o mais baixo são os plugins, onde guarda os plugins que obteve online. This lets organizations enforce standards while allowing individual customization through differently named skills. Isto permite que as organizações imponham padrões enquanto permitem personalização individual através de skills com nomes diferentes. If your company has an enterprise code review skill and you create a personal code review skill, the enterprise version of that takes precedence. Se a sua empresa tiver um skill enterprise de code review e você criar um skill pessoal de code review, a versão enterprise tem precedência. To avoid conflicts, use descriptive names. Para evitar conflitos, use nomes descritivos. Instead of review, use front-end PR review or security review. Em vez de review, use front-end PR review ou security review. To update a skill, edit it skill.md file. Para atualizar um skill, edite o seu ficheiro skill.md. Simple. Simples. To remove one, delete its directory. Para remover um, elimine o seu diretório. Restart clock code after changes for them to take effect. Reinicie o Claude Code após as alterações para que entrem em vigor. Creating a skill means making a directory with a skill.md file containing metadata and instructions. Criar um skill significa criar um diretório com um ficheiro skill.md contendo metadados e instruções. Claude loads skill names and descriptions at startup. O Claude carrega os nomes e descrições dos skills na inicialização. matches incoming requests against those descriptions and asks for confirmation before loading the full content. Compara os pedidos recebidos com essas descrições e pede confirmação antes de carregar o conteúdo completo. Priority rules handling name conflicts. As regras de prioridade tratam os conflitos de nomes. Enterprise overrides personal personal overrides project overrides plugins. Enterprise sobrepõe-se ao pessoal, o pessoal sobrepõe-se ao projeto e o projeto sobrepõe-se aos plugins. [music] [música] Edit the skill.md file to update a skill and restart cloud code for changes to take effect. Edite o ficheiro skill.md para atualizar um skill e reinicie o Claude Code para que as alterações entrem em vigor.