Productivity
invoice-organizer avatar

invoice-organizer

Automates invoice and receipt organization for tax preparation by parsing files, extracting financial data, renaming documents, and filing them into a structured directory system.

Introduction

This skill acts as an automated virtual bookkeeper, specifically designed to handle the chaotic folders of financial documents that accumulate throughout the year. It is aimed at freelancers, small business owners, and individuals who struggle with manual bookkeeping tasks. By leveraging Claude's advanced file reading and text extraction capabilities, the skill transforms diverse, messy documents into a professional, audit-ready, and tax-compliant digital archive without requiring manual data entry.

  • Automatically scans directories for various formats including PDF invoices, scanned images (JPG, PNG), screenshots, and email attachments.

  • Extracts high-value metadata such as vendor names, invoice numbers, specific dates, total amounts, and product or service descriptions.

  • Renames files using a standardized, sortable format (YYYY-MM-DD Vendor - Invoice - Description) to ensure easy retrieval and chronological consistency.

  • Sorts files into a logical directory structure categorized by year, tax category (deductible vs. personal), expense type, or vendor name.

  • Generates a summary CSV report that aggregates all extracted information, which is ready for direct import into accounting software or sharing with accountants.

  • Maintains a non-destructive workflow by allowing users to choose between moving files or copying them to a new structure, ensuring original records remain untouched.

  • Usage: To get started, navigate to the target directory and provide a clear request to organize files. The skill will first scan the folder to provide a summary of the current state and ask for preferred categorization strategies.

  • Capabilities: It handles extraction from both structured text-based PDFs and unstructured images through OCR-like pattern matching.

  • Constraints: The skill works best on clear financial documents; highly illegible images or non-standard handwritten receipts may require manual verification. Users should review the proposed organizational plan generated by the agent before final execution to ensure the directory structure matches their accounting requirements.

Repository Stats

Stars
2,839
Forks
329
Open Issues
7
Language
Python
Default Branch
main
Sync Status
Idle
Last Synced
Apr 29, 2026, 06:13 AM
View on GitHub