IA prática
Agent Skill é um jeito simples de ensinar um procedimento para um agente de IA. Você coloca instruções em um SKILL.md, junto de scripts e arquivos de apoio quando fizer sentido. A ideia central é esta: a skill só entra no contexto quando a tarefa combina com ela.
O caminhoDefina usoCrie pastaEscreva SKILL.mdAdicione apoioTeste gatilhoRefine descrição
Foco: Uma Agent Skill é uma pasta com um arquivo SKILL.md. Esse arquivo tem frontmatter YAML com name e description, depois instruções em Markdown, e pode vir com scripts e arquivos de referência.
Faça 1: Pense na skill como um procedimento reutilizável, não como uma regra global.
Faça 2: Use a skill quando você quer ensinar um passo a passo que se repete.
Faça 3: Separe scripts e arquivos de apoio na mesma pasta, se eles ajudarem a executar a tarefa.
Foco: Skill não é a mesma coisa que arquivo de instrução global. AGENTS.md ou CLAUDE.md fica sempre carregado. Skill só carrega quando a tarefa é relevante.
Faça 1: Coloque regras permanentes no arquivo de instrução do projeto, não na skill.
Faça 2: Coloque processos específicos na skill, como revisar logs, preparar release ou analisar incidente.
Faça 3: Se a necessidade for conectar ferramenta ou dado externo, avalie MCP em vez de skill.
Foco: A primeira skill deve resolver uma tarefa curta, frequente e fácil de validar. Isso reduz ambiguidade e facilita saber se o agente entendeu quando deve usá-la.
Faça 1: Escolha uma tarefa que você repete toda semana.
Faça 2: Evite começar por um fluxo grande com muitas exceções.
Faça 3: Dê um nome direto para a skill, baseado no trabalho que ela faz.
Foco: No Claude Code, skills de projeto ficam em .claude/skills/<name>/SKILL.md. Skills pessoais ficam em ~/.claude/skills/.
Faça 1: Se a skill pertence a um repositório, crie a pasta em .claude/skills/<name>/SKILL.md.
Faça 2: Se a skill serve para vários projetos seus, use ~/.claude/skills/.
Faça 3: Mantenha o nome da pasta curto e descritivo.
Metade do guia. Agora, mire na vaga certa.
Na mentoria, eu monto com você o plano de estudo para a vaga que você quer, ajusto o seu LinkedIn e te ensino a achar as melhores vagas.
Foco: O agente vê primeiro só name e description. Depois carrega o conteúdo completo quando a tarefa combina. Por isso, a description precisa dizer o que a skill faz e quando usar.
Faça 1: No frontmatter YAML, preencha name com um nome claro e description com uso e gatilho.
Faça 2: Nas instruções em Markdown, escreva passos objetivos, em ordem, com critérios de saída.
Faça 3: Se houver comandos, caminhos ou arquivos, escreva de forma exata.
Foco: O formato usa progressive disclosure. Muitas skills podem coexistir sem lotar contexto, porque só a descrição fica visível no começo.
Faça 1: Crie skills separadas por procedimento, em vez de uma skill gigante para tudo.
Faça 2: Escreva descriptions distintas para evitar conflito entre skills parecidas.
Faça 3: Use arquivos de referência só quando eles ajudarem a execução da skill.
Foco: Uma boa skill é previsível. Se o agente não ativa a skill na hora certa, quase sempre o problema está na description ou nas instruções vagas.
Faça 1: Peça uma tarefa que deveria disparar a skill e observe se ela foi usada.
Faça 2: Reescreva a description até ficar claro o que faz e quando usar.
Faça 3: Se o passo a passo ainda estiver confuso, melhore a instrução ou consulte prompts e engenharia de contexto.
São pastas com um arquivo SKILL.md que ensina um procedimento para o agente. Esse arquivo pode incluir frontmatter YAML com name e description, instruções em Markdown, scripts e arquivos de referência.
No Claude Code, skills de projeto ficam em .claude/skills/<name>/SKILL.md. Skills pessoais ficam em ~/.claude/skills/.
O arquivo de instrução do projeto fica sempre carregado e define regras permanentes. A skill só carrega quando a tarefa combina com o que foi descrito nela.
MCP conecta o agente a ferramentas e dados externos. Skill ensina um procedimento, um jeito de executar uma tarefa quando ela aparecer.
Escrever a skill como se fosse um README genérico. Skill boa ensina execução. Ela diz quando usar, quais passos seguir e o que entregar no fim.
Se a descrição não explica o gatilho, a skill vira arquivo morto.
Saber estruturar agent skills já virou habilidade prática para quem trabalha com código e IA no dia a dia. Na mentoria, Lucas te ajuda a montar um plano de estudo para a vaga que você quer, ajustar seu LinkedIn e encontrar vagas mais aderentes ao seu momento.
