# Criar Skill

> Constrói uma nova skill com você, por entrevista, a partir de uma tarefa que você repete no trabalho — sem programar. Faz perguntas sobre o que entra, o que sai e o passo a passo, e gera um SKILL.md pronto para usar. Use quando quiser ensinar um procedimento seu para a IA executar sempre igual.

- **Type:** Skill
- **Install:** `agentstack add skill-emidio-trancoso-advocacia-aberta-0-1-criar-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [emidio-trancoso](https://agentstack.voostack.com/s/emidio-trancoso)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [emidio-trancoso](https://github.com/emidio-trancoso)
- **Source:** https://github.com/emidio-trancoso/advocacia-aberta/tree/main/skills/0.1-criar-skill

## Install

```sh
agentstack add skill-emidio-trancoso-advocacia-aberta-0-1-criar-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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:

```markdown
---
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
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](https://github.com/emidio-trancoso)
- **Source:** [emidio-trancoso/advocacia-aberta](https://github.com/emidio-trancoso/advocacia-aberta)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-emidio-trancoso-advocacia-aberta-0-1-criar-skill
- Seller: https://agentstack.voostack.com/s/emidio-trancoso
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.