Skill de IA é um pacote de instruções, exemplos e recursos, guardado como uma pasta com um arquivo principal, que a IA carrega sozinha quando a tarefa pede — sem que você precise repetir nada. A diferença para o prompt é de natureza, não de tamanho: o prompt é a instrução de uma conversa; a skill é a instrução que vale em todas as conversas, inclusive nas que você não vai conferir.
Para o Direito, isso muda o jogo de um jeito específico: pela primeira vez dá para transformar o modo como o seu escritório revisa uma peça em algo que roda igual em qualquer mesa. Eu não sou advogado — sou de tecnologia, com mais de dez anos no mercado jurídico — e ensinar a construir skills é, hoje, o centro do que faço. Este guia é o que eu explico na primeira aula.
O que é uma skill de IA (definição oficial e tradução)
Segundo a documentação da Anthropic, skills são "capacidades modulares que estendem a funcionalidade do Claude": cada uma empacota instruções, metadados e recursos opcionais — scripts, modelos — que a IA usa automaticamente quando são relevantes. Ao contrário dos prompts, que são instruções de uma conversa para uma tarefa, as skills carregam sob demanda, "para que você não precise repetir a mesma orientação em todas as conversas" (Anthropic, Agent Skills).
A tradução que uso em sala: skill não é prompt, é pasta. Uma pasta com um arquivo principal, o SKILL.md, que tem um cabeçalho — nome e descrição — e um corpo com o passo a passo. Pode ter arquivos de apoio (um modelo de peça, uma lista de conferência, um glossário) e pode ter código que executa. A IA lê o cabeçalho de todas as skills que você instalou, decide qual usar pela descrição, e só então abre o corpo. É o que a documentação chama de progressive disclosure: a informação entra em camadas, conforme a tarefa pede.
Qual é a diferença entre skill, prompt e plugin?
A diferença entre skill, prompt e plugin é de escopo e de permanência — e a confusão entre os três é o erro mais comum de quem começa.
Prompt | Skill | Plugin | |
|---|---|---|---|
O que é | Instrução escrita numa conversa | Pasta de instruções que carrega sozinha quando a tarefa pede | Arquivo que empacota e distribui um conjunto de skills |
Dura | Aquela conversa | Todas as conversas em que for relevante | Enquanto instalado |
Quem se beneficia | Você, agora | Você e quem mais tiver a skill, sempre | Um time inteiro, de uma vez |
Exemplo jurídico | "Revise esta contestação" | Instrução de revisão de contestação com o padrão da banca | Os 100+ padrões da banca instalados de uma vez |
Na régua da casa, a unidade é a skill; o plugin é o arquivo que encapsula muitas skills — é assim que distribuímos aos alunos da Formação as mais de 100 skills jurídicas que mantemos, e é assim que um escritório distribui o seu padrão para a equipe.
Onde as skills funcionam (e onde não passam)
Skills funcionam nos três produtos da Anthropic, mas não sincronizam entre eles — e isso decide onde você monta a sua.
claude.ai — skills personalizadas podem ser enviadas como arquivo compactado em Configurações → Recursos, nos planos Pro, Max, Team e Enterprise, com execução de código ativada. São individuais: cada pessoa do time precisa enviar a sua; não há gestão centralizada pelo administrador.
Claude Code — skills são pastas no computador (
~/.claude/skills/pessoal ou.claude/skills/do projeto), descobertas automaticamente e compartilháveis por plugins.API — skills são enviadas pela Skills API e valem para o espaço de trabalho inteiro.
A documentação é explícita: uma skill enviada ao claude.ai não aparece na API, e vice-versa. Em sala, isso aparece como "criei no Cowork e não roda no Copilot" — e não roda mesmo, porque são produtos diferentes. Decida primeiro onde o time trabalha; monte a skill lá.
Como criar a sua skill de revisão a partir das peças que já venceram
A skill mais valiosa para um escritório não é a que escreve — é a que revisa contra o seu próprio padrão de sucesso. O método tem quatro passos e não exige programação.
1. Separe três ou quatro peças aprovadas. Não as mais bonitas: as que o judiciário aceitou — a contestação que segurou, o recurso provido, a inicial que virou sentença nos termos pedidos. Três ou quatro bastam. Elas são o padrão real da sua vara e do seu estilo, não o padrão genérico da internet.
2. Escreva o que elas têm em comum. Estrutura, ordem dos tópicos, densidade de fundamentação por pedido, tom, extensão, como as citações aparecem. Isso vira o corpo da skill: "toda revisão compara a minuta com este padrão e aponta onde diverge".
3. Escreva o cabeçalho com cuidado. A descrição é o que a IA usa para decidir quando acionar a skill — ela precisa dizer o que a skill faz e quando usar ("revisa contestações cíveis contra o padrão da banca; use quando o usuário pedir revisão de contestação"). Descrição vaga = skill que nunca dispara ou dispara errado.
4. Depois de criar, leia a skill. Este é o passo que quase todo mundo pula. O que você pediu foi o pedido; o que ficou salvo é a instrução — e é ela que roda em todas as próximas vezes, inclusive nas que você não vai conferir. Abra o arquivo e leia como se fosse a peça de um estagiário.
Uma ressalva de quem já viu isso dar errado: a skill de revisão complementa a conferência de fonte, nunca a substitui. A mesma IA que revisa pode inventar um julgado — o método de três conferências está em minuta com IA: como fazer com segurança.
A skill é da área, não da pessoa
O ganho óbvio da skill compartilhada é uma pessoa fazer o erro-e-acerto pelas outras. O ganho que ninguém conta é a vantagem de padrão: a revisão sai igual em qualquer mesa, do sócio ao estagiário. É a primeira vez que a qualidade de revisão de um escritório deixa de depender de quem está de plantão.
Isso traz uma regra de governança que vale escrever: só é skill do escritório a skill aprovada. Skill pessoal, cada um monta a sua; skill da área passa por quem responde pela área antes de entrar no plugin do time. É o mesmo raciocínio dos modelos de peça — ninguém coloca no repositório da banca a minuta que não foi revisada.
E uma regra de segurança que ganhou peso em 2026: skill é pacote que roda no seu ambiente com o seu acesso e pode executar código. Skill de fonte desconhecida se trata como anexo de e-mail desconhecido — o detalhe completo está em skill maliciosa: o anexo de e-mail da era da IA.
Por onde começar
Use antes de construir. Instale skills prontas de fonte confiável e sinta a diferença entre uma IA genérica e uma IA que conhece o seu processo — é a virada que organiza todo o uso de inteligência artificial no Direito.
Comece pela revisão, não pela redação. A skill de revisão é a que mais devolve e a que menos arrisca.
Uma skill, um trabalho. Skill que faz tudo não faz nada bem — a descrição fica vaga e a IA não sabe quando acionar.
Leia o que ficou salvo. Sempre.
Quem quiser o caminho completo — da primeira skill ao plugin do escritório — é o que ensinamos na Formação em Inteligência Artificial para o Mundo Jurídico, com a biblioteca de mais de 100 skills jurídicas prontas para instalar.
