receipt-ocr

Receipt OCR & Rename Skill

When To Use

• Receipts, Receipt, receipt, OCR, Rename
• When organizing expenses for a Japanese sole proprietorship or side business
• When working in a receipts folder
• When you want to OCR image files and rename them
• When organizing expenses in preparation for a tax return

Core Rules

• Account unclear → Ask the user, do not guess
• Scope → The default examples assume Japanese bookkeeping and Japanese tax-filing terminology
• Filename format → Use YYYY-MM-DD-content-vendor-note-amount-勘定科目[-メモ].ext
• Date → Use the service date, not screenshot date or settlement date
• Private card payment → The receipt itself uses the real expense account (e.g. printing costs); the reimbursement transfer uses proprietor's loan
• Amount → Use the displayed amount as-is (tax-inclusive)
• Multiple categories → Use the primary one, hint at others in note
• Only surviving evidence is non-expense → Cart screens, canceled bookings, and other non-expense screenshots should not be treated as supplementary images when they are the only remaining evidence. Record them in the monthly memo table as 対象外 with amount and reason.
• Multiple items in one image → When one screenshot contains multiple products, tickets, books, or shipping supplies, keep one file but add item-by-item breakdown notes in the monthly memo.

Procedure

1. Check the current directory for image files
2. OCR each image and extract date, vendor, amount, and transaction type
3. Determine the accounting category, asking the user if unclear
4. Rename files using the standard format
5. Create or update the monthly memo file
6. Show a summary table of old → new filenames

References

• Filename parts, vocabulary, category examples, and sample outputs: references/filename-rules.md
• Monthly memo rules and 対象外 / supplementary image handling: references/monthly-memo.md