---
name: receipt-capture
description: "Snap a receipt, done — when the owner attaches a photo or PDF of a receipt (even with NO message or a bare \"take a look at this\"), that IS the request: load this, then read it, book it in the Money ledger, and keep the image in Files → Receipts. Load this the moment a receipt image shows up in the chat."
version: 1.0.0
metadata: {"bizer":{"name":"Receipt Capture"}}
---

RECEIPT CAPTURE SKILL — when the owner sends a photo, scan, or PDF of a receipt,
FILING IT IS THE REQUEST. They're often standing at a counter or sitting in the
truck; they should never have to type anything. Run this loop:

1. RECOGNIZE — an attached image of a purchase receipt (register tape, card slip,
   supplier ticket, paid invoice, order confirmation) counts even when the message
   is empty or just says "Take a look at this." Do NOT ask "what would you like
   me to do with this?" — file it. If their text asks for something ELSE ("make
   a flyer from this"), do that instead; the silent default is filing.
2. READ — pull the vendor, the date, the TOTAL (the final total, not a subtotal),
   and — if shown — how it was paid. Only state figures you can actually read: if
   the total or date is blurry, cropped, or ambiguous, ask for a sharper photo and
   STOP. Never save a guessed digit; a wrong number in the books is far worse than
   one more photo.
3. CATEGORIZE — map it onto one Bizer category yourself (job materials → supplies,
   or cogs when it's clearly for a specific job's resale/materials; fuel → travel;
   food → meals; tool/software subscriptions → software). direction is 'out' for a
   purchase; 'in' only for a refund/return credit slip.
4. SAVE — call save_receipt with what you read. One call does BOTH halves: the
   image is kept in the owner's Files under the "Receipts" folder (created
   automatically) and the transaction books into the Money ledger, linked to that
   file. One receipt per call — for a second attached receipt call it again with
   attachmentIndex 1, and so on. Re-sending the same receipt never double-counts.
5. CONFIRM — reply with ONE short line: amount, vendor, category, and that the
   image is saved in Files → Receipts. Invite a correction ("want it under a
   different category?") — if they correct you, call save_receipt again with the
   fixed fields; it updates the same entry instead of adding a new one.

- NOT this tool: a multi-row bank/card STATEMENT or a bookkeeping CSV is an import
  (money_import, confirm first — see Money Setup). An invoice the owner ISSUED to
  a customer belongs to the invoicing tools, not the expense ledger.
- Multiple receipts in one photo: file each one you can read clearly as its own
  save_receipt call (they're one attachment — same attachmentIndex).
- Keep it fast and quiet: no lectures, no walls of text — file it, confirm in a
  line, move on.
