analise-cadeias-hiscon

What problem does it solve?

This Skill eliminates the manual, error-prone work of reading HISCON PDFs and mapping the refinancing/portability chain, so you can quickly triage potential irregularities and draft legal pieces with a structured record of what was found.

Core Features & Use Cases

• HISCON PDF parsing: Extracts beneficiaries and all contracts (active/suspended/excluded/closed) with banks, dates, values, fees (IOF), CET/interest, and exclusion reasons.
• Loan-chain graph construction: Builds a graph of chains using confidence-ordered matching rules (explicit “migrated from” when present, identical installment amounts in a ±60-day window, and consolidation/fracionamento by matching sums).
• Irregularity signal detection: Flags patterns such as successive refinancing growth consistent with anatocismo, long chains, bank mismatch vs beneficiary payer bank, short “bridge” operations, and consolidation/fracionamento structures.
• DOCX generation in office format: Produces a DOCX report with visual chain trees, detailed contract tables (highlighting missing fields in yellow), confidence-graded links (low confidence in red), and “reading notices” for interpretation limits.

Quick Start

Use the skill to generate a complete chain analysis DOCX from a HISCON PDF by running: python ~/.claude/skills/analise-cadeias-hiscon/scripts/analisar.py "<caminho_hiscon.pdf>" --saida "<destino.docx>".