analise-cadeias-hiscon

Parse INSS HISCON PDFs to reconstruct loan chains and detect irregularities.

1|Updated May 10, 2026
One-click install
npx skills add https://github.com/gabrielcardosodeaguiar45-oss/claude-skills-azevedolima --skill analise-cadeias-hiscon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: analise-cadeias-hiscon
Source: https://github.com/gabrielcardosodeaguiar45-oss/claude-skills-azevedolima/tree/main/analise-cadeias-hiscon
Command: npx skills add https://github.com/gabrielcardosodeaguiar45-oss/claude-skills-azevedolima --skill analise-cadeias-hiscon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pdfplumber, python-docx, and includes scripts (resource) components.

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>".

Frequently Asked Questions about analise-cadeias-hiscon

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

FAQPage Schema
How do I reconstruct loan chain operations from a HISCON PDF?

Yes, the tool detects irregularity signals like anatocismo by identifying successive refinancing growth and short bridge operations during the PDF parsing and graph reconstruction process, flagging them in the final report.

Can I generate a defensible DOCX report for legal screening from INSS portability data?

You can generate a defensible DOCX report for legal screening from INSS portability data by running the analysis script, which creates visual chain trees, detailed contract tables, and confidence-graded links using python-docx.

Does the loan chain analysis tool require specific dependencies to parse PDFs?

The loan chain analysis tool requires pdfplumber for deterministic PDF extraction and python-docx to generate the office format report, ensuring structured outputs without manual data entry.

What are the limitations of automated graph reconstruction for loan contracts?

Automated graph reconstruction for loan contracts has limitations, including reliance on confidence-ordered matching rules like identical installment amounts in a ±60-day window, meaning low-confidence links require manual review and interpretation.

How does the script handle missing fields when extracting contracts from a HISCON PDF?

When extracting contracts from a HISCON PDF, the script handles missing fields by highlighting them in yellow within the detailed contract tables of the DOCX report, clearly marking data limitations for evidentiary use.