juriscan

Analyzes Brazilian judicial proceeding PDFs to detect contradictions, calculate CPC deadlines, and score litigation risk.

25|11|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/brunobracaioli/juriscan --skill juriscan-brunobracaioli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: juriscan
Source: https://github.com/brunobracaioli/juriscan
Command: npx skills add https://github.com/brunobracaioli/juriscan --skill juriscan-brunobracaioli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pypdf, pytesseract, Pillow, jsonschema, pytest, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Brazilian judicial proceedings can span hundreds of pages across petitions, answers, sentences, and appeals, forcing lawyers to spend days manually cross-referencing pieces for contradictions, deadlines, and argument evolution. This Skill automates that forensic reading, producing a structured analysis in minutes. ## Core Features & Use Cases - Piece-level extraction and classification: Extracts PDF text (pdftotext, pypdf, OCR fallback) and chunks proceedings into 27 types of procedural pieces, then analyzes each chunk with schema-validated structured output. - Contradiction and instance tracking: Maps contradictions between parties, tracks arguments across instances (1st instance, TJ, STJ, STF), and detects binding precedents and Art. 942 CPC situations. - Deadline and risk computation: Calculates CPC Art. 219-232 deadlines with forensic holidays and recess, recalculates monetary awards under Lei 14.905/2024, and scores procedural, merit, and monetary risk. - Use Case: A solo litigation lawyer drops a 150-page case PDF and receives an executive REPORT.md with chronological piece table, verbatim-cited contradictions, urgent deadline alerts, strategic recommendations per party, and a navigable Obsidian vault. ## Quick Start Ask Claude Code to run /juriscan on the path to your case PDF, for example by saying: analyze the judicial proceeding at ~/Downloads/processo.pdf and show me the contradictions, deadlines, and risk report.

Frequently Asked Questions about juriscan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze a Brazilian judicial proceeding PDF with Claude Code?

Install the skill into ~/.claude/skills/juriscan, restart Claude Code in the folder containing your PDF, and invoke /juriscan followed by the PDF path. The pipeline extracts, chunks, analyzes, and outputs a REPORT.md plus an Obsidian vault.

What does the juriscan forensic analysis pipeline detect?

It detects 27 types of procedural pieces, contradictions between parties, CPC deadlines with forensic holidays and recess, argument evolution across instances, binding precedents, Art. 942 CPC situations, and Lei 14.905/2024 monetary recalculations.

Does juriscan work with scanned PDF documents?

Yes, it falls back to OCR via pytesseract when text extraction fails, and assigns an OCR confidence score per chunk. Without tesseract installed, scanned PDFs fail silently, so installing tesseract-ocr and the Portuguese language pack is recommended.

What are the limitations of automated legal case analysis?

The skill covers only Brazilian civil and labor proceedings under the CPC, not criminal, tax, or arbitration cases. It does not verify jurisprudence citations in the legacy pipeline, and the risk score is a structural heuristic, not a statistical prognosis.

Can juriscan connect to PJe or e-SAJ court systems?

No, it only reads local PDF files and has no integration with PJe, e-SAJ, or e-proc. You must download the proceeding PDF manually before running the analysis.