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 do escritório | Os 100+ padrões do escritório 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 do escritório; 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 do escritório 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.
Se preferir começar por algo pronto em vez de construir do zero, os agentes que aplicam esse tipo de método já estão montados na biblioteca gratuita de agentes jurídicos — de graça e sem cadastro.
