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