Expense Snap
Use this skill when the user wants to turn a receipt or spending note into structured expense data, review spending by month, or export records to CSV.
When to Use
- Logging a new receipt from text or an image transcription.
- Categorizing spending into consistent buckets.
- Producing monthly summaries with budget comparisons.
- Exporting receipts for spreadsheets or reimbursement.
Commands
The helper script stores state in {baseDir}/.runtime/expense-snap.db.
Record a receipt
python {baseDir}/scripts/expense_snap.py record --merchant "Cafe Luna" --date 2026-03-22 --total 18.40 --currency EUR --category meals --line-item "Latte|4.50|1|beverages" --line-item "Sandwich|13.90|1|meals"
List receipts
python {baseDir}/scripts/expense_snap.py list --month 2026-03 --category meals
Monthly report
python {baseDir}/scripts/expense_snap.py monthly-report --month 2026-03
Export to CSV
python {baseDir}/scripts/expense_snap.py export-csv --month 2026-03 --output {baseDir}/.runtime/march-expenses.csv
Safety Boundaries
- Never claim receipt OCR is perfect. Mark ambiguous fields as inferred.
- Do not fabricate line items that are not visible or provided.
- Keep currency and totals consistent with the source receipt.
- If an image is unreadable, explain the uncertainty instead of inventing data.