invoice-processor

Extract structured invoice data from PDFs and images into Excel.

8|4|Updated Dec 15, 2025
One-click install
npx skills add https://github.com/Jst-Well-Dan/Skill-Box --skill invoice-processor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: invoice-processor
Source: https://github.com/Jst-Well-Dan/Skill-Box/tree/main/business-analyst/invoice-processor
Command: npx skills add https://github.com/Jst-Well-Dan/Skill-Box --skill invoice-processor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires aiohttp, PyMuPDF, openpyxl, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automatically identifies and extracts key invoice details from PDFs or image files and exports them into a structured Excel report, reducing manual data entry and speeding up financial workflows.

Core Features & Use Cases

  • AI vision-based extraction of common invoice fields (type, number, date, buyer/seller, amounts, items)
  • JSON output for downstream processing and auditing
  • Batch processing of multiple invoices with status tracking
  • Excel report generation with professional formatting
  • Clear guidance on privacy, API keys, and local configuration

Quick Start

  • Environment setup and environment check: python .claude/skills/invoice-processor/scripts/check_env.py
  • OCR processing: python .claude/skills/invoice-processor/scripts/invoice_ocr.py -i invoices -o invoice_results.json
  • Excel generation: python .claude/skills/invoice-processor/scripts/convert_to_excel.py -i invoice_results.json -o invoice_results.xlsx

Frequently Asked Questions about invoice-processor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract invoice data from PDF and image files automatically?

Invoice extraction automates the process of pulling structured data like invoice number, date, buyer/seller names, and amounts from PDF, JPG, JPEG, and PNG files using AI vision recognition. This Skill processes invoices through OCR, converts PDFs to images at 200 DPI, encodes them in base64, and sends them to a cloud vision model for field identification.

Can I batch process multiple invoices at once?

Yes, batch processing supports up to five invoices concurrently. The Skill processes multiple files in parallel, tracks status for each, and consolidates results into a single JSON output before converting to Excel, reducing processing time for large invoice volumes.

What invoice fields does the OCR extraction capture?

The Skill extracts 12 standardized fields: invoice type, number, date, buyer name, seller name, total excluding tax, tax amount, total including tax, and item names. Output is generated as formatted JSON for downstream processing or auditing before Excel export.

How do I set up and run the invoice processor in my environment?

Run the environment check script to verify dependencies (aiohttp, PyMuPDF, openpyxl), then execute the OCR processing script pointing to your invoice folder, and convert the resulting JSON to Excel. Quick Start commands are provided for each step with configurable input/output paths.

What are the privacy and API requirements for this Skill?

The Skill requires API key configuration for the cloud vision model and performs local environment checks before processing. Images are base64 encoded and sent to the vision API; guidance on privacy settings and local configuration is included to ensure secure handling of invoice data.

Does this work with invoices in different formats and languages?

The Skill processes JPG, JPEG, PNG, and PDF formats. Language support depends on the underlying cloud vision model's capabilities; the Skill handles format conversion and standardization but does not apply language-specific filtering or translation.