micdepieri

Sos Financeiro — Development skill for Claude Code

Development community

Assessor financeiro pessoal local-first: le seus extratos, faturas e relatorios de investimento de uma pasta e monta um painel.

How to install Sos Financeiro

This entry records only its repository, not the path inside it, so there is no exact command to give. Open micdepieri/sos-financeiro and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Sos Financeiro does

Assessor financeiro pessoal local-first: le seus extratos, faturas e relatorios de investimento de uma pasta e monta um painel. Skill para Claude Code, Codex e Antigravity. Python stdlib, nada sai da maquina.

Alternatives in Development

Compliance Cl — 🇨🇱 Skill de Claude Code: auditoría y cumplimiento Ley 21.719 (datos) + 21.595 (delitos económicos) — contra 189 ★
Resume Skills — Offline, local-only context migration skills across 9 coding-agent sources × 9 destination hosts (registry-der 43 ★
V Memory Refresh — (Re)index docs/superpowers prose into the local V-memory cache so recall is current 35 ★

README

Meu Financeiro

Assessor financeiro pessoal que roda **local**, sobre os seus próprios documentos. Você joga extratos, faturas, holerites e relatórios de investimento numa pasta; a ferramenta normaliza, concilia, classifica e monta um painel. Nada sai da máquina.

Funciona como skill do Claude Code e como projeto no Codex ou Antigravity (via `AGENTS.md`). Somente pessoa física.

O que você precisa


Python 3.9+	Só isso para OFX, CSV, conciliação, classificação, análise e painel. Nenhuma dependência.
Um agente (Claude Code, Codex, Antigravity)	Para ler PDF sem parser, decidir categoria ambígua, conduzir a entrevista e conversar sobre os números.
`pdftotext` (poppler) — opcional	Ativa os parsers determinísticos de PDF. `brew install poppler` ou `apt install poppler-utils`.
`pymupdf` — opcional	Ativa o parser do Extrato de Movimentação da B3. `pip install pymupdf`.

Sem os dois opcionais nada quebra: o PDF é marcado como pendente e o agente lê. Com eles, a leitura é determinística, mais rápida e mais barata.

Começando

python3 scripts/init_base.py      # cria as pastas e a base
# coloque seus arquivos em entrada/
python3 scripts/importar.py       # OFX, CSV e PDFs de layout conhecido
python3 scripts/conciliar.py      # transferências próprias e pagamento de fatura
python3 scripts/classificar.py    # plano de contas
python3 scripts/analisar.py       # indicadores
python3 scripts/painel.py         # gera painel/index.html

Para ver o pipeline rodando sem usar dado real, veja [exemplo/LEIA-ME.md](exemplo/LEIA-ME.md).

Quanto disso já funciona para você

Sejamos francos sobre a cobertura, porque ela é desigual:

**Funciona para qualquer banco:** OFX e QFX (praticamente todo banco brasileiro exporta — Itaú, Bradesco, BB, Santander, Nubank, Inter, C6, cooperativas). CSV de banco e corretora, com detecção automática de separador, formato de data e vírgula decimal. **Se você tem OFX, está atendido** — e