A tool for recording purchase invoices in a SQLite business register, either by entering the details or reading them from a PDF or image with OCR. OCR means extracting printed text from a scan or photo.

Use it to save seller details, invoice numbers, dates, net and VAT amounts, categories, scans, and the percentage of VAT that can be deducted.

It keeps expense and VAT information in one place and records which month the invoice belongs to for JPK_V7M, a Polish tax report.

expense — Skill for Claude Code by dithiothreitol

Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo

git clone --depth 1 https://github.com/dithiothreitol/jdg-ksiegowy

agentmods

npx agentmods add skills/dithiothreitol/jdg-ksiegowy/expense

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/dithiothreitol/jdg-ksiegowy/expense/github.svg)](https://agentmods.dev/skills/dithiothreitol/jdg-ksiegowy/expense)

Your own site

<a href="https://agentmods.dev/skills/dithiothreitol/jdg-ksiegowy/expense"><img src="https://agentmods.dev/badge/skills/dithiothreitol/jdg-ksiegowy/expense/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/dithiothreitol/jdg-ksiegowy/expense"><img src="https://agentmods.dev/badge/skills/dithiothreitol/jdg-ksiegowy/expense.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 212 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,895 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00212	$0.01895
Opus 5	$0.00106	$0.00948
Sonnet 5	$0.00042	$0.00379
Haiku 4.5	$0.00021	$0.00189

Measured 10d ago against content hash 0137bf559b2e, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

expense scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/expense/SKILL.md · 107 lines

How it starts

The opening of the file, as written. The whole thing — 107 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Dodawanie faktury zakupu (koszt)

Zapisuje koszt do tabeli expenses w SQLite. Używane potem przez skill jpk do wyliczenia VAT naliczonego do odliczenia.

Wymagane dane od usera

seller-name — nazwa sprzedawcy
seller-nip — NIP sprzedawcy (10 cyfr; dla zagranicznego: też string, ustaw --seller-country)
document-number — numer faktury (z faktury sprzedawcy)
issue-date — data wystawienia (YYYY-MM-DD)
netto — kwota netto
vat — kwota VAT (jeśli sprzedawca zwolniony — wpisz 0)

Opcjonalnie:

receive-date — data wpływu (domyślnie = issue-date). To ona decyduje o miesiącu w JPK_V7M.
description — co kupiłeś
category — uslugi_obce | materialy | media | paliwo | samochod | biuro | sprzet | szkolenia | inne
vat-rate — stawka (domyślnie 23)
--vat-deduction-pct — procent VAT odliczalnego (0-100, domyślnie 100):
- 100 — pełne odliczenie (typowe usługi/towary firmowe)
- 50 — auto osobowe użytkowanie mieszane lub auto prywatne służbowo (paliwo, serwis)
- 0 — brak odliczenia (reprezentacja, prywatny zakup)
file-path — ścieżka do PDF/JPG zachowanego skanu

Dopytaj usera jeśli czegoś brakuje, zwłaszcza NIP i kwot. Nie wymyślaj.

Wywołanie

python3 skills/expense/scripts/add.py \
  --seller-name "Hetzner Online GmbH" \
  --seller-nip "DE812871812" \
  --seller-country DE \
  --document-number "R0012345" \
  --issue-date "2026-04-15" \
  --description "Hosting VPS kwiecien 2026" \
  --category uslugi_obce \
  --netto 100 \
  --vat 23

Zwraca JSON z id rekordu, datami i statusem saved.

OCR z pliku (PDF/JPG/PNG)

Zamiast przepisywać dane, user może podać plik faktury:

# Podglad (preview, bez zapisu):
python3 skills/expense/scripts/scan.py --file faktura.pdf

# Zapis od razu:
python3 skills/expense/scripts/scan.py --file faktura.pdf --save

Flow:

Bez --save skrypt zwraca JSON z wyciągniętymi polami + source (ollama | claude).
Pokaż userowi preview i spytaj o akceptację/poprawki.
Po akceptacji odpal ten sam skrypt z --save lub skills/expense/scripts/add.py z poprawionymi polami.

Read the full file on GitHub · 107 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

10d ago First seen · 107 lines · 212 tokens per session scan A 0137bf559b2e

Subscribe to this mod's changes

expense is a skill published in the GitHub repository dithiothreitol/jdg-ksiegowy (5 stars, last pushed 1mo ago), licensed MIT. It adds 212 tokens to every session and 1,895 once invoked, about $0.0011 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Documents Finance and fintech PDF accounting agent-skills claude jdg jpk ksef

jangbu-import

A data-import workflow for turning bank files, card records, spreadsheets, receipts, tax invoices, and statement PDFs into a standard set of 13 transaction fields. OCR, or optical character recognition, is used to read information from document images and PDFs.

kimlawtech/korean-jangbu-for · 97 tokens

extract-bank-statement

Extract bank PDF/CSV to transactions.json with running-balance proof (pull bank lines with balance proof). Prefer CSV; Maybank Islamic PDF adapter when needed.

cynco-labs/ai-accounting-skills · 37 tokens

creditcard-aflettering

Deze skill moet gebruikt worden wanneer de gebruiker een creditcard- of PSP-afschrift volledig in Exact Online wil verwerken: transacties uit de PDF halen, openstaande inkoopfacturen matchen, als BankEntry importeren en afletteren via MatchSets. Regels zonder factuur gaan nooit automatisch naar een kostenrekening.…

iwebdevnl/exact-online-ai-connect · 111 tokens

expense