Criar Skill

Criar Skill — construa a sua primeira skill, sem programar

Esta é a skill que cria outras skills. Ela conduz uma entrevista curta para transformar um procedimento que você já faz na cabeça (ou no automático) em um SKILL.md que a IA passa a executar sempre do mesmo jeito.

A ideia central: todo trabalho jurídico já é um procedimento. Você já sabe ler um processo, montar uma petição, analisar um contrato. Só não escreveu esse caminho para a IA. Uma skill é o seu procedimento escrito em português — não é código.

> Toda skill responde a três perguntas (a anatomia de qualquer automação): > 1. O que ENTRA (os dados que você já tem) → 2. O que SAI (o resultado que > você quer) → 3. O PROCEDIMENTO (o passo a passo que liga um ao outro). > A entrevista abaixo descobre essas três coisas com você.

---

Instrução

Se o usuário já informou uma ideia de tarefa (ex.: "resumir contratos de locação"), use-a como ponto de partida. Se não informou, comece perguntando pela tarefa.

Conduza como uma conversa, não como um formulário. Faça uma pergunta de cada vez, em linguagem simples, e use as respostas anteriores para fazer a próxima. Se o usuário não souber responder algo, ofereça exemplos e siga em frente — a skill pode ser refinada depois.

Passo 1 — A tarefa (o gatilho)

Pergunte:

• "Qual tarefa você repete e gostaria que a IA fizesse por você?"
• "Me dá um exemplo concreto da última vez que você fez isso."

Ouça e devolva em uma frase o que entendeu, para confirmar. Sugira um nome curto em kebab-case para a skill (ex.: resumir-contrato, minutar-notificacao, triar-processo-novo).

Passo 2 — O que ENTRA (os dados que você TEM)

Pergunte:

• "Quando você vai fazer essa tarefa, o que você tem em mãos?" (PDFs dos autos,

um contrato, um áudio de reunião, um e-mail do cliente, uma planilha…)

• "Onde isso costuma estar?" (uma pasta do caso, um arquivo solto, um texto colado)
• "Tem algum dado que precisa estar organizado antes?" Se for áudio, aponte

a skill transcrever; se for uma pilha de documentos, aponte a skill organizar-caso.

Passo 3 — O que SAI (o resultado que você PRECISA)

Pergunte:

• "No fim, o que você quer receber?" (um resumo de 1 página, uma minuta de peça,

uma tabela de prazos, uma lista de riscos…)

• "Em que formato?" (um arquivo .md, uma resposta na tela, uma peça salva em

pecas/…)

• "Como é um resultado bom? E o que tornaria o resultado ruim?" (isso vira as

regras de qualidade da skill)

Passo 4 — O PROCEDIMENTO (o passo a passo)

Peça para a pessoa narrar como ela faz hoje, e transforme em passos numerados:

• "Me conta, passo a passo, como você faria isso na mão."
• A cada passo, pergunte o "porquê" quando não for óbvio — o motivo vira instrução

para a IA não errar.

• Identifique pontos onde a IA não pode inventar (números, citações de lei,

jurisprudência, prazos) e onde ela deve conferir na fonte ou perguntar em vez de chutar.

Passo 5 — Mostrar o rascunho e confirmar

Antes de salvar, mostre ao usuário um resumo do que a skill vai fazer (entra → sai → passos) e pergunte se está certo. Ajuste conforme o retorno.

Passo 6 — Gerar o arquivo da skill

Crie o arquivo em .agents/skills//SKILL.md com esta estrutura:

---
name: 
description: 
---

# 

## Instrução

Considere como entrada . Se a entrada não estiver presente, peça-a antes de continuar.

### Passo 1 — 

### Passo 2 — 

## Regras
- 
- Nunca inventar fatos, números, citações de lei ou jurisprudência: usar só o que
  está nos documentos ou em fonte verificada.

Regras ao gerar:

• A description é a parte mais importante: escreva-a pensando em "quando a IA deve

usar isto?". É ela que faz a skill ser acionada na hora certa.

• Use caminhos relativos (casos//...), nunca caminhos absolutos.
• Linguagem em português, simples. A skill é um procedimento, não código.
• Escreva instruções independentes de fornecedor: use capacidades como "leia o

arquivo" em vez de nomes de ferramentas exclusivos de um agente.

• Se a tarefa se conecta a outras skills do kit, referencie-as pelo nome

(ex.: "antes, execute a skill organizar-caso"; "depois, use a skill revisar-peca").

Depois de salvar, rode:

bash ferramentas/manutencao/sincronizar-skills.sh
python3 ferramentas/manutencao/verificar_compatibilidade.py

Passo 7 — Explicar como usar

Ao terminar, diga ao usuário:

• "Pronto: criei a skill ****. No Claude Code, use /; no Codex,

mencione $ ou peça a tarefa em linguagem natural."

• Sugira testá-la agora com um exemplo real.
• Lembre que ela pode ser ajustada quando quiser — é só abrir o arquivo

.agents/skills//SKILL.md e editar, ou usar a skill criar-skill de novo para refinar.

---

Dica de ouro (diga ao usuário se ele travar na ideia)

A melhor primeira skill é uma tarefa chata, repetitiva e bem definida — não a mais impressionante. Exemplos que funcionam bem: resumir uma pilha de documentos novos, montar a linha do tempo de um caso, gerar a minuta de uma notificação padrão, conferir se uma peça citou todas as provas. Comece pequeno; a IA aprende o seu jeito e você expande depois.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: emidio-trancoso
• Source: emidio-trancoso/advocacia-aberta
• License: MIT

Install and usage instructions live in the source repository linked above.