# Diagramar Peca

> Transforma qualquer peça já escrita (.md ou texto) em um PDF bem diagramado, com Legal Design simples — capa, destaques, citações em bloco, fundamentos e linha do tempo. Não altera o conteúdo, só a forma visual. Use quando quiser entregar uma petição, contrato, parecer ou notificação com aparência profissional e legível.

- **Type:** Skill
- **Install:** `agentstack add skill-emidio-trancoso-advocacia-aberta-3-2-diagramar-peca`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [emidio-trancoso](https://agentstack.voostack.com/s/emidio-trancoso)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **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/3.2-diagramar-peca

## Install

```sh
agentstack add skill-emidio-trancoso-advocacia-aberta-3-2-diagramar-peca
```

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

## About

# Diagramar Peça — Legal Design simples

Pega uma peça já redigida (em `.md` ou texto) e gera um **PDF diagramado** usando
Typst e um template enxuto que acompanha esta skill. Serve para **qualquer peça**:
petição, contestação, recurso, parecer, contrato, notificação extrajudicial,
alegações finais.

## ⚠ Regra absoluta

**Não inventa, não adiciona, não parafraseia.** O conteúdo jurídico é exatamente o que
está na peça original. O que muda é só a forma visual — onde cada trecho fica mais
legível (um destaque, uma citação em bloco, uma linha do tempo). Nunca crie fatos,
números, citações de lei ou jurisprudência que não estejam no texto original.

---

## Pré-requisito

Esta skill usa o **Typst** para gerar o PDF. Verifique se está instalado com
`typst --version`. Se não estiver:
- macOS: `brew install typst`
- outros sistemas: ver https://github.com/typst/typst (há instaladores prontos)

Se o usuário não tiver e não quiser instalar, você ainda pode entregar a peça
formatada em Markdown limpo — mas o resultado bonito é o PDF.

---

## Instrução

Considere `` o caminho relativo informado pelo usuário (ex.:
`casos/meu-caso/pecas/contestacao-v1.md`). Se não tiver sido informado, pergunte qual
peça deve ser diagramada.

### Passo 1 — Ler a peça inteira

Leia o arquivo do início ao fim. Identifique os dados de cabeçalho (juízo/destinatário,
partes, título da peça) e, para cada bloco do texto, que tipo de conteúdo é:

| Conteúdo no texto | Componente do template |
|---|---|
| O ponto-chave, a tese central, um alerta | `#destaque[...]` |
| Citação literal (transcrição, doutrina, artigo de lei, cláusula) | `#citacao(fonte: "...")[...]` |
| Lei ou jurisprudência usada como fundamento | `#fundamento(tipo: "...", ref: "...")[...]` |
| Sequência de fatos com datas | `#cronologia((("data", "evento"), ...))` |
| Título de seção | `= Título` (nível 1) e `== Subtítulo` (nível 2) |
| Texto argumentativo comum | parágrafo normal |
| Etiqueta curta para guiar a leitura (ex.: PEDIDO) | `#marcador("PEDIDO")` |

**Critério:** use o componente mais rico que o conteúdo permitir, mas **com moderação** —
um bom Legal Design respira. Não transforme tudo em caixa. Em geral, no máximo ~6
elementos visuais por página; o resto é texto bem espaçado.

### Passo 2 — Gerar o arquivo Typst

Crie um arquivo `.typ` ao lado da peça (mesma pasta, sufixo `-diagramada`). Estrutura:

```typst
#import "/.agents/skills/3.2-diagramar-peca/template.typ": *

#show: peca.with(
  titulo: "",
  juizo: "",
  partes: "",
  rodape: "",
)

// Conteúdo da peça, seção por seção, usando os componentes onde fizer sentido.
// Copie as palavras EXATAS da peça original.
```

Regras de geração:
- **Copie as palavras da peça** — não reescreva, não resuma, não "melhore".
- Preencha `#fundamento(...)` e `#citacao(...)` só com o que está no texto. Se a peça
  cita um precedente sem dados completos (sem número/link), deixe como está — não
  invente. Se quiser enriquecer com a fonte real, use antes as skills
  `buscar-fontes` ou `buscar-tjpr` e só então preencha.
- **Cuidado com o cifrão `$`** (no Typst ele inicia "modo matemático"):
  - No texto corrido, escreva `\$` para o símbolo de real — ex.: `R\$ 2.400,00`.
  - Mas **dentro de strings entre aspas** (como nos argumentos de `#cronologia(...)`),
    use `$` sem a barra — ex.: `"R$ 2.400"`. Em string, a barra apareceria literal no PDF.
- Outros caracteres a escapar no texto corrido quando necessário: `#`, `@`, `*`, `_`, ``.

### Passo 3 — Compilar o PDF

Rode (a partir da raiz do projeto, por causa do `--root`):

```bash
typst compile --root . "casos//pecas/-diagramada.typ" "casos//pecas/-diagramada.pdf"
```

Se der erro de compilação, leia a mensagem, corrija o `.typ` (normalmente é um
caractere a escapar ou uma vírgula faltando) e recompile.

### Passo 4 — Entregar

Informe ao usuário:
1. Caminho do `.pdf` e do `.typ` gerados.
2. Quais componentes visuais você aplicou e em quais seções.
3. Sugira abrir o PDF e revisar seção por seção — e lembre que dá para ajustar as
   cores/fontes editando `template.typ`.

---

## Dica

Antes de diagramar, vale executar a skill `revisar-peca` — diagramar uma peça com erro
só deixa o erro mais bonito. A ordem natural é: `redigir-peca` → `revisar-peca` →
`diagramar-peca`.

## 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-3-2-diagramar-peca
- 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%.