skills-datajud-djen

Agent Skills com conhecimento de produção sobre as APIs públicas do CNJ: DataJud e DJEN (Comunica PJe).

As documentações oficiais dizem o que as APIs fazem. Estas skills registram o que só se aprende operando-as em produção: os timeouts que funcionam de verdade, o geo-bloqueio que só aparece no deploy, o parâmetro que falha em silêncio, a resposta 200 que mente. Todo o conteúdo vem da operação real do Judis, um SaaS jurídico que consome as duas APIs diariamente.

São skills no formato Agent Skills (SKILL.md + referências), prontas para usar com Claude Code e qualquer agente compatível — e os arquivos são markdown puro, legíveis por humanos sem nenhuma ferramenta.

As skills

skills/datajud

API Pública do DataJud (api-publica.datajud.cnj.jus.br) — consulta de metadados e movimentações processuais via Elasticsearch.

Destaques do que está documentado:

• Consulta pelo alias do tribunal, derivado do número CNJ (com função pronta) — o curinga api_publica_* retorna 504 na prática;
• Respostas 200 parciais (_shards.failed > 0) que transformam “não encontrado” em mentira;
• Timeouts realistas (a API responde em 10-40s; medimos tudo), política de retry para 429 e por que 504 nunca deve ser retryado;
• Datas de 14 dígitos em horário de Brasília sem indicação de fuso — e os três formatos de data que coexistem;
• Códigos TPU de movimentos → inferência de fase processual;
• Circuit breaker, rate limiting, desenho de sync periódico, chave pública rotacionada pelo CNJ.

skills/djen

API do DJEN / Comunica PJe (comunicaapi.pje.jus.br) — intimações, citações e publicações de todos os tribunais, sem autenticação.

Destaques do que está documentado:

• Geo-bloqueio: 403 para IPs fora do Brasil — funciona no notebook, falha na cloud function em us-central1;
• itensPorPagina máximo de 50, com falha silenciosa acima disso;
• Variantes de sufixo da OAB por tribunal (123456, 123456-O, 123456-A…) — sem elas, ~90% das publicações ficam invisíveis;
• Páginas vazias transientes no meio da paginação e count capado em ~10.000;
• Sanitização do HTML das publicações — incluindo por que class é vetor de ataque (UI redressing com Tailwind);
• Rate limit não documentado, cancelamento de publicações, dedupe, certidões em PDF, desenho de monitoramento diário por OAB.

Instalação

Claude Code — copie as skills para o diretório de skills do projeto (ou o pessoal, para valer em todos os projetos):

git clone https://github.com/rvsanches/skills-datajud-djen.git
# por projeto:
cp -r skills-datajud-djen/skills/datajud skills-datajud-djen/skills/djen .claude/skills/
# ou pessoal (todos os projetos):